xs-github-repo-analyzer

GitHub Repo Analyzer

GitHubリポジトリの内容を詳しく分析し、構造化レポートを生成する。

手順（必ずこの順番で実行）

Step 1: リポジトリ情報の正規化

ユーザー入力から owner/repo を抽出:

• https://github.com/owner/repo → owner/repo
• owner/repo → そのまま使用

Step 2: 現行HEADとDeepWikiの情報を取得

最初にGitHubでdefault branchと現行HEADを確認する。

is_private="$(gh api repos/<owner>/<repo> --jq '.private')"
default_branch="$(gh api repos/<owner>/<repo> --jq '.default_branch')"
head_sha="$(gh api repos/<owner>/<repo>/commits/"$default_branch" --jq '.sha')"

以後のソース確認はこのSHAを基準にする。is_private=true の場合はDeepWikiの取得を省略する。

2a. Deepwikiで詳細情報を取得（並行実行）:

公開リポジトリの場合だけ、利用できるWeb取得ツールで https://deepwiki.com/<owner>/<repo> にアクセス。非公開リポジトリの識別子やコードはDeepWikiへ送らず、GitHubの許可された読み取り経路を使う。

取得する情報: 概要・目的、アーキテクチャ・設計思想、ディレクトリ構造、技術スタック、主要コンポーネント

2b. gh CLIでメタ情報を取得（並行実行）:

gh repo view <owner>/<repo> --json name,description,stargazerCount,forkCount,licenseInfo,primaryLanguage,createdAt,updatedAt

Star数・Fork数・ライセンス・作成日などはDeepwikiにないため、常にgh CLIで取得する。

DeepWikiの Last indexed のcommitリンクから索引SHAを取得し、GitHubの現行HEADと比較する。

gh api repos/<owner>/<repo>/compare/<index_sha>..."$head_sha" \
  --jq '{status, ahead_by, behind_by, total_commits}'

• SHA一致: 現行版の補助解説として使う。
• HEADが先行: 差分があることを示し、主要な主張を現行コードで確認する。
• SHA不明・比較不能・分岐: 鮮度を検証できないと明記し、現在の仕様をDeepWikiだけで断定しない。

いずれの場合もStep 3で主要な機能・構成を確認する。

Step 3: 現行コードで主要な主張を確認

DeepWikiの取得成否にかかわらず、README・主要コード・設定を確認する。

# リポジトリのメタ情報取得
gh repo view <owner>/<repo>

# READMEを取得
gh api "repos/<owner>/<repo>/readme?ref=$head_sha" --jq '.content' | base64 -d

# ディレクトリ構造を取得（ルート）
gh api "repos/<owner>/<repo>/contents?ref=$head_sha"

# 言語構成を取得
gh api repos/<owner>/<repo>/languages

必要に応じて /tmp にcloneして詳細分析:

repo_tmp="$(mktemp -d)"
gh repo clone <owner>/<repo> "$repo_tmp" -- --depth 1
git -C "$repo_tmp" fetch origin "$head_sha"
git -C "$repo_tmp" checkout --detach "$head_sha"

分析後は今回作成した repo_tmp だけを、環境のゴミ箱など復元可能な方法で片付ける。他の既存checkoutを削除しない。片付け手段がなければ保存場所を報告する。

Step 4: レポート生成