exploration について
explorationは、開発者やエージェント向けのコードベース調査スキルです。5段階の証拠に基づく分析で、技術スタック、エントリーポイント、アーキテクチャパターンを報告します。
主な機能
- 015段階のコードベース調査
- 02構造とエントリーポイントの把握
- 03依存関係ファイルの分析
- 04アーキテクチャパターンの検出
- 05証拠に基づくレポート作成
活用シーン
- 01不慣れなリポジトリの把握
- 02コードベース分析の準備
- 03詳細なレビュー前の構成確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ fusengine/ agents --skill explorationインストール後、Claude Code で/explorationを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/code-organization-checks.mdexploration-protocol.mdquick-analysis-commands.mdresponse-format.mdtech-stack-detection.md詳細
Exploration は、コードベースを迅速に発見するための 5 フェーズの偵察プロトコルを実行します。初回偵察(ルートファイル、設定、エントリポイント)、構造マッピング、言語ごとのエントリポイント検出、依存関係分析(package.json/pyproject.toml/go.mod/Cargo.toml/composer.json)、およびアーキテクチャパターン検出(MVC、Clean、Hexagonal、機能ベース、レイヤード、モジュラーモノリス、Next.js App Router など)です。
これは証拠ベースのみで行われます -- コードによる証明なしに前提を置くことはなく -- テックスタック、エントリポイント、検出されたアーキテクチャパターンを含む構造化されたレポートを、それを利用する側(通常は APEX Analyze フェーズまたはドメインエキスパート)のために生成します。
セッション: ${CLAUDE_SESSION_ID}
Exploration スキル
偵察プロトコル
これらの 5 フェーズを順番に実行します — 完全なコマンドは references/exploration-protocol.md にあります:
- 初回偵察 — ルートファイルを一覧表示し、設定ファイルを見つけ、一般的なエントリポイントを確認します
- 構造マッピング — ツリービュー(ノイズとなるディレクトリを除外)で、主要なディレクトリを特定します
- エントリポイント検出 — 言語ごとに
main/index/サーバーブートストラップを grep します - 依存関係分析 —
package.json/pyproject.toml/go.mod/Cargo.toml/composer.jsonを読み取ります - パターン検出 — MVC、Clean/Hexagonal、機能ベース、Next.js App Router のディレクトリを確認します
アーキテクチャパターン検出
パターンの指標
| パターン | 主要ディレクトリ | 指標 |
|---|---|---|
| MVC | controllers/、models/、views/ | Rails、Laravel、Express |
| Clean Architecture | domain/、application/、infrastructure/ | DDD、ユースケース |
| Hexagonal | adapters/、ports/、core/ | ポート & アダプター |
| 機能ベース | features/[name]/ | 機能ごとに全レイヤー |
| レイヤード | presentation/、business/、data/ | 従来の 3 層 |
| モノリス | 単一の src/ | 関心の混在 |
| マイクロサービス | 複数の services/ | 別々のリポジトリ/フォルダ |
| Next.js App Router | app/、components/、lib/ | サーバー/クライアントコンポーネント |
| モジュラーモノリス | modules/[name]/ | 境界付けられたコンテキスト |
禁止される行為
- ❌ コードの証拠なしに前提を置く
- ❌ 設定ファイルを無視する
- ❌ テストディレクトリを見落とす
- ❌ 依存関係分析を省略する
- ❌ エントリポイントを見逃す
- ❌ 検証なしにアーキテクチャを仮定する
行動特性
- 体系的かつ方法的
- パターンに焦点を当てた検出
- コンテキストを考慮した分析
- 包括的かつ簡潔
- 証拠に基づく洞察
- 深掘りの前に迅速な偵察
詳細リファレンス(オンデマンドで読み込み)
references/exploration-protocol.md— 5 フェーズプロトコルを実行するときに読み込みます(フェーズごとの正確なシェルコマンド)references/tech-stack-detection.md— 言語ごと(JS/TS、Python、Go、PHP、Rust)にフレームワーク/ORM/ツールを特定するときに読み込みますreferences/code-organization-checks.md— インターフェースの分離、ビジネスロジックの配置、状態管理を監査するときに読み込みますreferences/response-format.md— 最終的な探索レポートを作成するときに読み込みますreferences/quick-analysis-commands.md— ワンライナーでのフルスタック評価、ファイル数、または大きなファイルの検出に読み込みます
コメント
Markdown 対応