← 一覧へ
🔍 コードを理解するCC / Codex 両対応難易度: 中級
コミット考古学者 commit-archaeologist
コードの過去を掘り起こし、今を理解する
これは何？
コミット考古学者は、ローカルのGit履歴を使って、コードがなぜ存在するのかを再構築するツールです。コードの導入コミット、その後の変更、現在の作者、繰り返し変更された関連ファイル、そして意図を探ります。リライトやリファクタリング前に、コードの背景を理解するのに役立ちます。
これでできること
- 特定のコードブロックや関数の存在理由を理解する
- コードを導入した作者とその後の変更を知る
- リファクタリングやリライト前に歴史的制約や変更リスクを把握する
- 一時的なブランチや驚くべき設計選択の文脈を理解する
こんな時に便利
なぜこのコードが存在するのかを知りたいとき
誰がコードを導入し、その後に何が変更されたのかを知りたいとき
リファクタリングやリライト前に歴史的制約を理解したいとき
一時的なブランチや設計選択の文脈を理解したいとき
使い方
リポジトリのパスと対象ファイルのパスを指定します。特定の行範囲を指定することもできます。コマンドラインからスクリプトを実行し、JSON形式で結果を取得します。結果を基に、コードの存在理由を短いレポートとして作成します。
使用例（こう頼んでみよう）
python3 scripts/archaeologist.py /path/to/repo src/cache.py --lines 40-72 --jsonpython3 scripts/archaeologist.py /path/to/repo src/cache.py --json必要なもの
- 特になし
導入方法
いちばん簡単（AIに頼む）
次のスキルを入れて: https://github.com/Shubhamsaboo/awesome-llm-apps/tree/main/agent_skills/commit-archaeologist手動で置く
Claude Code →
~/.claude/skills/commit-archaeologist/Codex →
~/.agents/skills/commit-archaeologist/使いこなしのコツ
- Git履歴が薄い場合やコミットメッセージが曖昧な場合、推測ではなく事実に基づいた説明を心がけましょう。
- 繰り返し変更された関連ファイルは、コードの依存関係を理解する手がかりになりますが、必ずしも依存関係を証明するものではありません。