[Skill 名] github-repo-analyzer

GitHub 倉庫アナライザー

GitHub のオープンソースリポジトリを分析し、構造化された Markdown 分析レポートを生成します。Notion への同期もサポートしています。

ワークフロー

ステップ 1: 倉庫アドレスの取得

必要に応じて、ユーザーに GitHub 倉庫アドレスの提供を求めます。形式の例：

• https://github.com/user/repo
• github.com/user/repo
• user/repo

ステップ 2: 倉庫の Clone

1. 既存のディレクトリに分析作業ディレクトリを作成します（タイムスタンプで命名、例：analysis-20240314-123045）。
2. そのディレクトリ内に repo/ サブディレクトリを作成し、clone したコードを格納します。
3. git clone コマンドを実行して、倉庫を repo/ ディレクトリに clone します。
4. clone が成功したことを検証します（ディレクトリが空でないことを確認します）。

ステップ 3: 分析要件の取得

ユーザーに具体的な分析要件を尋ねます。例えば：

• 「全体的なアーキテクチャとモジュール関係を分析してください」
• 「コード品質と潜在的な問題をチェックしてください」
• 「API インターフェースドキュメントを生成してください」
• 「セキュリティ脆弱性を分析してください」
• 「テストカバレッジを評価してください」
• またはユーザーのカスタム要件

ステップ 4: 倉庫の分析

ユーザーの要件に基づき、以下のツールのいずれかを呼び出して詳細な分析を行います。

• 最優先：Open Code - ユーザーが設定済みの場合
• 次優先：Claude Code - ユーザーが設定済みの場合
• 最後：Codex - ユーザーが設定済みの場合

分析戦略：

1. まず倉庫構造（README、ディレクトリ構造、主要な設定ファイル）を探索します。
2. コアモジュールとエントリファイルを特定します。
3. ユーザー要件に応じて、関連コードを深く分析します。
4. 主要な発見、パターン、問題を記録します。

ステップ 5: 分析レポートの生成

作業ディレクトリ（repo/ と同じ階層）に以下の Markdown ドキュメントを作成します。

analysis-20240314-123045/
├── repo/                    # clone した倉庫コード
├── reports/                 # 分析レポートディレクトリ
│   ├── 01-テーマ1.md
│   ├── 02-テーマ2.md
│   ├── 03-テーマ3.md
│   └── 04-その他のユーザー要件のテーマ.md
└── notion-sync.log         # Notion 同期ログ（Notion 同期スクリプトが有効な場合）

レポート内容の規範

01-プロジェクトアーキテクチャ概要.md

• プロジェクトの基本情報（名称、説明、技術スタック）
• ディレクトリ構造の説明
• アーキテクチャパターン（MVC、マイクロサービス、レイヤードアーキテクチャなど）
• 主要コンポーネントとその関係
• 依存関係図（テキストで記述）

02-コード品質分析.md

• コード規約の遵守状況
• 潜在的なバグまたは問題
• 複雑度分析
• テストカバレッジ状況（もしあれば）
• 改善提案

03-コアモジュール説明.md

• 主要モジュール/パッケージの機能説明
• 主要なクラス/関数の用途
• データフロー分析
• 重要なアルゴリズムまたはビジネスロジックの説明

ステップ 6: Notion 同期（オプション）

~/.config/notion/api_key が存在するかどうかを確認します。

• 存在する場合、ユーザーに Notion への同期を尋ねます。
• ユーザーが同意した場合、各 Markdown ドキュメントをブロックに分けて Notion にアップロードします。
• ページ構造を作成します：親ページは倉庫名、子ページは各分析レポート。
• 同期ログを notion-sync.log に記録します。

Notion API 呼び出しの要点：

• Notion API v1 を使用します。
• 各 Markdown ファイルをサブページとして扱います。
• コンテンツをブロックに分けます（各ブロックは 2000 文字以内）。
• Markdown 形式を保持します。
• Notion 内でのサブページは以下のようになります。

倉庫概要.md (名前は倉庫名とユーザー要件に基づいて要約・抽出)
├── 01-テーマ1.md
├── 02-テーマ2.md
├── 03-テーマ3.md
└── 04-その他のユーザー要件のテーマ.md

ステップ 7: クリーンアップ（オプション）

ユーザーに clone した倉庫を削除するかどうかを尋ねます。

• ユーザーが削除を選択した場合、repo/ ディレクトリを削除しますが、reports/ は保持します。
• ユーザーが保持を選択した場合、完全なパスを伝えます。

重要事項

1. レポートの保存場所：分析レポートは repo/ と同じ階層の reports/ ディレクトリに配置する必要があります。倉庫内部には配置しないでください。
2. 倉庫パス：常に /github-analysis/analysis-<timestamp>/ 構造を使用してください。
3. エラー処理：
   • Clone 失敗時（ネットワーク問題、倉庫の不存在、権限問題）は、ユーザーに通知して終了します。
   • 分析ツールが利用できない場合は、現在のセッションのツールで分析を行うかどうかをユーザーに尋ねます。
   • Notion 同期失敗時は、エラーを記録しますが、プロセスは中断しません。
4. 大規模倉庫の処理：倉庫のファイル数が 10000 を超える場合、分析に時間がかかる可能性があることをユーザーに通知します。
5. 機密情報：分析レポートで API キー、パスワードなどの機密情報が発見された場合、ユーザーに注意を促します。

出力例

分析完了後、ユーザーに報告します。

✅ 倉庫分析が完了しました！

📁 分析レポートの場所：/github-analysis/analysis-20240314-123045/reports/

📄 生成ファイル：
   - 01-プロジェクトアーキテクチャ概要.md
   - 02-コード品質分析.md
   - 03-コアモジュール説明.md

📊 分析概要：
   - 技術スタック：Python/FastAPI + React
   - コードファイル：127 個
   - 主要な問題：3 箇所の潜在的な問題を発見しました。詳細はコード品質分析レポートをご覧ください。

🔄 Notion 同期：https://notion.so/xxx に同期済みです（該当する場合）

❓ clone した倉庫を削除しますか？(y/n)

ツールチェック

分析を開始する前に、以下のツールが利用可能かどうかを確認します。

# git をチェック
command -v git &> /dev/null && echo "git: OK" || echo "git: MISSING"

# opencode をチェック
command -v opencode &> /dev/null && echo "opencode: OK" || echo "opencode: NOT FOUND"

# claude CLI をチェック
command -v claude &> /dev/null && echo "claude: OK" || echo "claude: NOT FOUND"

# codex をチェック
command -v codex &> /dev/null && echo "codex: OK" || echo "codex: NOT FOUND"

# Notion API キーをチェック
[ -f ~/.config/notion/api_key ] && echo "notion: CONFIGURED" || echo "notion: NOT CONFIGURED"