github-codebase-briefing

GitHub コードベースのブリーフィング

このスキルは、リポジトリを「深く読み込み」ます。表面的な一覧にとどまらず、まずプロジェクトのアーキテクチャを理解してから、その文脈に照らして未対応項目を評価します。

前提条件

• ツール： エージェントが gh CLI を利用できる必要があります。
• 認証： ユーザーが認証済みである必要があります（gh auth status）。

手順

ステップ 1：メンタルモデルを構築する

タスクを確認する前に、環境を理解します。次のコマンドを順番に実行します。

1. メタデータ： gh repo view <owner/repo> --json name,description,stargazerCount,forkCount
2. 構造： gh api repos/<owner/repo>/contents/
3. プロジェクトの概要： プロジェクトのマニフェスト（例：package.json、go.mod、pyproject.toml）と README.md を読みます。
4. エントリーポイント： 主なエントリーファイル（例：index.ts、main.go）を読み、公開 API の範囲を把握します。

ステップ 2：状態と差分を取得する

現在の項目と最近の変更を取得します。

1. Issue： gh issue list --repo <owner/repo> --state open --json number,title,body,author,createdAt,updatedAt,labels,comments
2. PR： gh pr list --repo <owner/repo> --state open --json number,title,body,author,createdAt,updatedAt,labels,additions,deletions,changedFiles,headRefName
3. 過去 24 時間の差分： gh issue list --state closed --since 24h および gh pr list --state merged --since 24h。

ステップ 3：詳細な分析ロジック

すべての Issue と PR について、テキストを要約するだけにとどめず、ロジックを確認します。

• Issue： gh api repos/<owner/repo>/contents/<path> を使って、報告で言及されたコードを調べます。
• PR： gh pr diff <number> を使って実際の実装を確認します。そのコードがステップ 1 で把握したパターンに沿っているか評価します。
• フラグ：
  • 🚨 セキュリティ： 認証情報、認証の迂回、インジェクション関連のキーワードを調べます。
  • 🤝 外部： メンテナー以外からの PR を優先します。
  • ✅ 準備完了： gh pr view <number> --json mergeable,statusCheckRollup を使ってマージ可能か確認します。

ステップ 4：パターンを統合する

項目を大局的な洞察にまとめます。

• バグのまとまり： 3 件以上の Issue が特定のモジュールにおける同じ根本原因を共有しているか特定します。
• 注目モジュール： 複数のオープン項目に登場するファイルにフラグを付けます。
• クライアントの傾向： 利用者ごとに Issue をまとめます（例：「VS Code ユーザーから X の報告が寄せられています」）。

出力テンプレート

# {REPO_NAME} 日次ブリーフィング — {DATE}

スナップショット： {N} 件の Issue（昨日から {+X} 件） | {M} 件の PR（昨日から {+Y} 件）

⚡ 本日の推奨アクション

1. [優先度] #{Num}： {理由を 1 行で}
2. [優先度] #{Num}： {理由を 1 行で}

---

📂 オープン Issue の詳細分析

[フラグ] #{Num} — {タイトル}

• 背景： コードベースの「なぜ」と「どこで」を平易な言葉で説明します。
• 重要な根拠： > {重要なユーザーのテキストを引用}
• 解決への道筋： {簡単な修正／設計上の判断／ブロック中}

🔀 プルリクエストの分析

[フラグ] #{Num} — {タイトル}

• 影響： 変更されたファイルとアーキテクチャとの適合性を要約します。
• 品質に関する注記： 実装と CI の状況を率直に評価します。

🔍 パターンと健全性

• 注目モジュール： {list/of/files}
• リリース頻度： 前回のリリースから {days} 日が経過しています。