短い答え: GitHub Streak Stats は README ウィジェットであり、生産性スコアではありません
GitHub streak stats は、公開 GitHub contribution データから連続した活動を計算し、README に表示するカードを指すことが多いです。素早い視覚的シグナルにはなりますが、実際の仕事全体を表すものではありません。
使いどころは限定的です。プロフィール README に軽い活動ウィジェットを置きたい場合に使います。全体構成は GitHub profile README template ガイド、自動 3D 画像は profile-3d-contrib、インタラクティブな 3D 表示は GitHub City が適しています。
ウィジェットを変更する前に、公式 contribution graph と比較してください。メール、ブランチ、fork、非公開表示、更新タイミングの問題で GitHub が数えない commit は、カード側でも基本的に補えません。
README を重くせず GitHub Streak Stats を追加する方法
良い設定は小さく意図的です。活動や実績の近くにカードを置き、説明は短く保ち、プロジェクトより前に多数のリモートウィジェットを並べないようにします。
カードが答えるべき問いは一つです。このプロフィールは見える活動を示しているか。誰で、何を作り、どのプロジェクトが重要かをまだ説明できていないなら、カードを README の主役にしない方が安全です。
カードで何を示すか決める
見える貢献のリズムを示すために使い、スキルや信頼性の唯一の証拠にはしません。
公式カード URL をコピーする
保守されているサービスまたはリポジトリから始め、username を設定し、読みやすいテーマを選びます。
README.md に埋め込む
Markdown または意味のある alt を持つ HTML 画像を使い、プロジェクトの証拠の近くにカードを置きます。
公式の Contribution Graph を確認する
streak が正しく見えないときは、まず GitHub のルールを確認します。Contribution Graph ガイドでよくある原因を説明しています。
ウィジェットを増やすより文脈を加える
Streak カードに stats カードまたは GitHub City へのリンクを加える程度で十分です。カードが多すぎると遅くなり、読みにくくなります。
GitHub Streak Stats vs GitHub Readme Stats vs GitHub City
streak カードは実際のプロジェクトを補助するもので、競合するものではありません。冒頭要約の後に置き、明確な alt を付け、見えている GitHub 活動だけを示すことを説明します。全体構成は README template ガイド、3D の探索は GitHub City が適しています。
これらのツールはプロフィールの異なる層を扱います。Streak stats は継続性、GitHub Readme Stats はリポジトリや言語の指標、GitHub City は貢献履歴のインタラクティブな 3D 表示に焦点を当てます。
| 選択肢 | 向いている用途 | 設定 | リスク | 使いどころ |
|---|---|---|---|---|
| GitHub streak stats | プロフィール README に見える活動のリズムを示す。 | リモートカード URL または画像参照を追加する。 | 説明がないと生産性スコアのように見える。 | プロジェクトの証拠の近くに置く小さなシグナル。 |
| GitHub Readme Stats | 言語、リポジトリ、プロフィールの概要を示す。 | パラメータとテーマを設定する。 | カードが多いと README が遅く、落ち着かなくなる。 | カードがプロジェクトを補助できる場合。 |
| GitHub City | 貢献を 3D 都市として探索する。 | ツールを開き、username を入力する。 | 明確なリンクがなければ README カードにはならない。 | 記憶に残るインタラクティブな表示。 |
| profile-3d-contrib | Actions で README 用の 3D 画像を生成する。 | ワークフローの権限と出力先を設定する。 | ワークフローのエラーで画像が壊れることがある。 | README に生成済みの 3D ファイルが必要な場合。 |
壊れた、空の、誤解を招く streak カードを直す
streak の問題の多くはデザインではなくデータにあります。公式の contribution graph に活動がなければ、カードにも通常は表示されません。commit のメール、デフォルトブランチ、fork、リポジトリの公開範囲、非公開貢献の設定、反映遅延を確認します。
次にカードの設定を確認します。username、URL エンコード、テーマ名、キャッシュ、GitHub がリモート画像を取得できるかを確認してください。README が遅い、または重い場合は、カードを増やす前に余分なウィジェットを減らします。
streak がリセットされた
公式グラフで欠けた日を確認し、メール、ブランチ、fork、非公開設定、タイムゾーンを調べます。
カードが空になる
サービス、username、GitHub がリモート画像を読み込めるかを確認します。
README が重く見える
活動カード、明確なプロジェクト、必要なら 1 つのビジュアルリンクで十分です。装飾は下に移します。
指標が不公平に見える
これは見える GitHub 活動を示すもので、仕事全体やコード品質を示すものではないと説明します。
強い GitHub プロフィールで streak カードを置く場所
streak カードは冒頭の要約の後、主要プロジェクトの前後に置くと効果的です。ポートフォリオの証拠を隠さず、素早い活動シグナルを与えます。
ポートフォリオでは、文章の文脈、実際のプロジェクト、一つの視覚レイヤーを組み合わせます。視覚レイヤーは streak card、GitHub Readme Stats、profile-3d-contrib、GitHub City リンクのいずれかで十分です。
すでに GitHub City を使う場合は、探索用として説明します。訪問者は 3D の街を開き、カードの背後にある contribution パターンを確認できます。
実用ルール
streak カードが次のプロジェクトをより信頼しやすくしないなら、下へ移すか削除します。
FAQ
GitHub streak stats とは何ですか？
公開 contribution データをもとに、連続活動や streak 風の活動を README に表示する視覚要素です。
プロフィールにどう追加しますか？
ユーザー名と同じ特別なプロフィールリポジトリの README.md に、保守されているカード URL を追加して表示を確認します。
なぜ streak がリセットされましたか？
多くの場合、GitHub が一日以上の見える活動を数えていないか、サービスのキャッシュや設定が合っていないためです。
GitHub Readme Stats と同じですか？
いいえ。Streak stats は連続活動に焦点を当て、GitHub Readme Stats はプロフィール、リポジトリ、言語などを要約します。
GitHub City と一緒に使うべきですか？
はい。README では素早いカード、GitHub City ではインタラクティブな探索という役割が分かれている場合に有効です。