早わかり: 3D commitsは集計済みGitHub活動の3D可視化
3D commitsは公式Gitコマンドではありません。実際には、コミット活動を3D都市、スカイライン、README画像、ポートフォリオ用グラフィックとして見せたいという意図を表します。平面のログではなく、活動のリズムを空間的に伝えたい人向けの言葉です。
多くのツールはローカルの全コミットを直接読みません。GitHubプロフィールの貢献グラフ、API、またはGitHub Actionsの生成結果に依存します。そのため、公式グラフに表示されないコミットは、3D都市やスカイラインにも反映されない可能性があります。
すぐ試すなら、プロフィールを確認したうえでGitHub Cityを使います。モデル寄りの出力ならGitHub Skylineを比較します。コミットが消える問題はGitHub commit graphガイドで先に確認してください。
どのデータが3Dコミット可視化になるのか
信頼できる流れは三層です。まず実際の作業として、ローカルコミット、Pull Request、Issue、レビュー、リポジトリ活動があります。次にGitHubがプロフィール上で数える貢献データがあります。最後に、そのデータを高さ、ブロック、色、道路、スカイラインへ変換する可視化ツールがあります。
この分解により、同じツールでも結果が違う理由がわかります。メールが認証済みで、対象ブランチに入り、公開リポジトリや表示可能な非公開貢献があるプロフィールは豊かに見えます。一方、未pushの作業、未マージのfork、未連携メール、隠れた非公開活動は3D表示で補えません。
したがって、このページはgithub commit graphの重複ではありません。commit graphは欠落や帰属のルールを扱います。3D commitsは、数えられた活動をどの見せ方に変えるかを扱います。
3D commitsの出力タイプ比較
派手な見た目ではなく、最終的に必要な成果物で選びます。同じ活動履歴でも、都市、印刷向けスカイライン、README画像、公式グラフでは役割が違います。
| 出力 | 向いている用途 | 入力データの現実 | 選ぶ場面 |
|---|---|---|---|
| GitHub City | ブラウザでの素早い探索とポートフォリオ表現 | 表示可能なGitHub貢献データ | ユーザー名を入れてすぐ3D都市を見たいとき。 |
| GitHub Skyline | モデル化や印刷向けのスカイライン | ローカルワークフロー経由の貢献履歴 | STLやモデル寄りの成果物が必要なとき。 |
| profile-3d-contrib | README画像と自動生成 | GitHub Actionsと生成画像 | プロフィールREADMEに画像を置きたいとき。 |
| GitHub公式グラフ | 可視化前の正確性確認 | GitHub自身の集計ルール | 活動が本当に数えられているか確認したいとき。 |
3D commitsの実用ワークフロー
3D都市、スカイライン、README画像を共有する前に、この順番で確認します。
公式プロフィールグラフを見る
まずアカウントと年を確認します。公式グラフが薄いなら、3D出力ではなく元データを直します。
欠落コミットを診断する
メール、ブランチ、fork、非公開設定、反映遅延をcommit graphチェックリストで確認します。
出力形式を選ぶ
ライブの都市ならGitHub City、モデルならSkyline、README内の画像ならprofile-3d-contribを選びます。
共有時に文脈を添える
3D都市は見える貢献リズムを示しますが、コード品質や全ての非公開作業を証明するものではありません。
データの前提を説明する
GitHubで公開または表示可能な貢献を元にしたビジュアルであることを明記します。
3Dコミット可視化が空または誤解を招く理由
多くの場合、原因はビジュアルツールの前にあります。未連携メール、対象外ブランチ、未マージfork、非公開活動の表示制限、更新遅延、静かな年の選択などです。
形式への期待違いもあります。都市は密度とブロックを強調し、スカイラインは週単位の活動をモデルに圧縮し、README画像は静的に平面化します。どれも完全な分析ダッシュボードではありません。
同じ画像を何度も作り直すより、まず公式グラフを確認します。その後、問題が集計、プライバシー、年の選択、または目的に合わない形式なのかを切り分けます。
実用ルール
GitHub公式グラフが正しくなければ、3D可視化も元データ修正までは不完全と考えます。
3D commits の FAQ
3D commits とは何ですか？
3D commits は、GitHub のコミットやコントリビューション活動を、都市、スカイライン、README 画像、印刷用モデルなどの 3D ビジュアルに変換することを指します。
ローカルの Git commit はすべて 3D ビジュアルに表示されますか？
いいえ。多くの GitHub ベースの 3D ビジュアルは公開されたコントリビューションデータに依存するため、ローカルのコミット、紐付いていないメール、未マージの fork、非公開活動は表示されないことがあります。
GitHub City は 3D commits ツールですか？
GitHub City は 3D コントリビューショングラフのツールと説明するのが適切です。GitHub がプロフィールグラフで集計した後の commit ベースのパターンを可視化できます。
3D commits には GitHub Skyline と GitHub City のどちらを使うべきですか？
ブラウザですぐ 3D 都市を見たいなら GitHub City を使います。モデル制作や印刷可能なスカイラインが必要なら GitHub Skyline を使います。
3D commit の都市が空に見えるのはなぜですか？
まず GitHub 公式のコントリビューショングラフを確認します。そこで活動が集計されていなければ、派生する 3D ビジュアルも通常は不完全になります。