mcpField
G
github-contribution-period-analysis

github-contribution-period-analysis

github.com/tiangong-aiデータ・データベース1141 回インストール1 週間前に更新
リポジトリ

github-contribution-period-analysis について

GitHub Contribution Period Analysisは、指定したUTC期間におけるGitHubユーザーの貢献を、根拠付きのMarkdownレポートにまとめるスキルです。作成またはマージしたPRと本人のコミットを扱い、対象範囲はAPI認証情報に左右されます。

主な機能

  1. 01UTC期間内の貢献を分析
  2. 02作成・マージしたPRを収録
  3. 03対象ユーザー本人のコミットを収録
  4. 04指標、リポジトリ別内訳、タイムラインを生成
  5. 05変更の根拠リンクを提示

活用シーン

  1. 01指定期間のコード貢献を確認
  2. 02リポジトリ間の貢献状況を比較
  3. 03PRとコミットの根拠リンク付きレポートを作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tiangong-ai/agent-skills --skill github-contribution-period-analysis

インストール後、Claude Code で/github-contribution-period-analysisを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
references/
data-model.md
env.md
markdown-template.md
scripts/
github_contribution_report.py

詳細

GitHub のコントリビューション期間分析

主な目的

  • UTC の期間内における、対象の GitHub ユーザー 1 名のエビデンスに基づく Markdown レポートを作成します。
  • 実際のコードコントリビューションを示すシグナル、つまりマージされた PR とコミットのアクティビティに焦点を当てます。
  • 認証情報でアクセスできる範囲に限り、自身のリポジトリと他のリポジトリの両方を対象とします。

ワークフロー

  1. GitHub API にアクセスするための認証を準備します。
  2. 対象ユーザーと期間を指定して、scripts/github_contribution_report.py を実行します。
  3. 生成された Markdown レポートを確認し、エビデンスへのリンクを調べます。

コマンド

python3 scripts/github_contribution_report.py \
  --user <github-login> \
  --start 2026-03-01 \
  --end 2026-03-08 \
  --output /tmp/github-contribution-report.md

出力の意味

  • 含まれるコントリビューションの種類：
    • 作成者本人が作成したマージ済み PR。
    • 対象ユーザーがマージした PR（メンテナーとしてのマージ作業）。
    • 作成者本人が作成したコミット。
  • 対象外のアクティビティの種類：
    • コメント、レビュー、スター、ウォッチ、フォーク。
  • レポートには以下が含まれます：
    • 対象範囲とカバレッジに関する注記。
    • 概要指標。
    • PR／コミットのエビデンスから推定した、実質的な作業カテゴリ。
    • 代表的なエビデンスリンクを含む作業内容のハイライト。
    • リポジトリごとの内訳。
    • リポジトリごとの具体的な変更内容（変更のあったすべてのリポジトリ）。
    • コントリビューションのタイムライン。
    • 上位コントリビューションの表。
    • PR／コミットの URL を含むエビデンスの付録。

重要な制約

  • SSH キーは git のトランスポートにのみ使用され、GitHub REST API 呼び出しを直接認証するものではありません。
  • プライベートリポジトリを対象に含めるには、通常は GITHUB_TOKEN／GH_TOKEN または gh auth token を使った、認証済みの API アクセスが必要です。
  • GitHub Search API では、クエリごとに最大 1000 件の上限があります。アクティビティが非常に多いユーザーの場合は、期間を分割してレポートを複数回実行してください。

参考資料

  • references/env.md
  • references/data-model.md
  • references/markdown-template.md

スクリプト

  • scripts/github_contribution_report.py

コメント

Markdown 対応