explore-repo について
explore-repoは、実装の詳細、バージョン固有の動作、履歴を調べる際に外部Gitリポジトリを確認するスキルです。キャッシュの安全な再利用、正確な参照先の調査、根拠に基づく報告を重視します。
主な機能
- 01キャッシュ内のリポジトリを再利用またはクローン
- 02リポジトリの状態とリモートを確認
- 03指定ブランチ、タグ、コミットを取得
- 04実験用の独立したワークツリーを使用
- 05参照先、パス、ソースの根拠を報告
活用シーン
- 01依存関係の特定バージョンの実装を調査
- 02リポジトリの履歴やバージョン差を確認
- 03独立したワークツリーでビルドやテスト
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ sjunepark/ agent-scripts --skill explore-repoインストール後、Claude Code で/explore-repoを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
リポジトリを調べる
実装の詳細、バージョン固有の動作、または履歴が必要な場合は外部ソースを使用し、インストール済みのソースや一次ドキュメントで回答できる場合は、そちらを優先してください。Git と対象リポジトリへのアクセスが必要です。
キャッシュと参照
末尾の .git を取り除いたうえで、~/.repos/<host>/<owner-or-group>/<repo> を使用してください。
ユーザーがその場所を指定しない限り、現在のプロジェクト、追跡対象のワークツリー、または .tmp/ にクローンしないでください。外部クローンを隠すための ignore ルールを追加したり、キャッシュしたリポジトリをプロジェクトの依存関係として組み込んだりしないでください。
クローンを再利用する前に、状態とリモートの識別情報を確認してください。
git -C <cache-path> status --short --branch
git -C <cache-path> remote -v
変更のあるクローンでは、読み取り専用で調べるか、隔離したワークツリーを使用してください。明示的な許可なしに、リセット、クリーン、プル、チェックアウト、上書きを行わないでください。最新の参照が必要な場合は、クリーンなクローンを git -C <cache-path> fetch --prune --tags で更新してください。新しくクローンする場合は、git clone --filter=blob:none <url> <cache-path> を優先してください。履歴や古い参照が不要な場合に限り、--depth=1 を使用してください。
指定されたブランチ、タグ、コミット、リリース、または依存関係のバージョンを取得して調べてください。必要に応じてローカルの証拠から、より正確な参照を特定し、実際のコミットを git -C <cache-path> rev-parse HEAD で記録してください。
調査と実験
対象を絞って検索し、ファイルや履歴を読み取ってください。独立した調査を委任すると有用な場合は、定型的なスキャンには推論負荷の低い高速な構成を、複雑なロジックやアーキテクチャにはより高性能な構成を選択してください。パス、参照、裏付けとなる証拠を添えた簡潔な調査結果を依頼してください。
キャッシュしたクローンは、既定で読み取り専用のままにしてください。ビルド、編集、生成ファイルの作成、またはリスクを伴うチェックアウトを行う場合は、~/.repos/.worktrees/ 配下に隔離したワークツリーを作成してください。
git -C <cache-path> worktree add --detach <worktree-path> <ref>
このタスクのために作成し、不要になったワークツリーだけを削除してください。キャッシュしたクローンは保持し、削除するのは、削除を依頼された場合に限ります。その際は、対象候補とその状態、サイズ、経過期間を確認してください。
回答にはリモート URL、キャッシュパス、調査したコミット、関連するファイルまたはシンボルを記載してください。ソースから直接確認できた内容と推論を区別してください。