repo-map について
repo-map は、リポジトリ資産のスキャン、グラフ検索、カバレッジやドリフトの確認を行うスキルです。互換性のあるグラフランタイムを前提とし、根拠を明示した結果と派生ナビゲーションビューを作成します。
主な機能
- 01範囲を限定した資産スキャン
- 02グラフ検索とカバレッジ確認
- 03競合とスナップショットのドリフト検出
- 04派生ナビゲーションビューの生成
活用シーン
- 01コンポーネントの識別情報・関係・利用者の検索
- 02変更の影響と情報源の権威性の評価
- 03グラフのカバレッジと古さの確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ idaibin/ skills --skill repo-mapインストール後、Claude Code で/repo-mapを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/api-contract-map.mdchecklist.mdeval-cases.mdfrontend-inventory.mdgraph-operation-gates.mdjava-build-and-dependency-map.mdproject-grounding.mdproject-guidance.mdprompt-templates.mdreuse-index.mdusage.md詳細
リポジトリマップ
エントリーゲート
範囲を限定したリポジトリ資産のスキャン、グラフクエリ、網羅性/ドリフトの確認、および派生ナビゲーションのレンダリングを担当します。互換性のあるグラフランタイム、リポジトリルート、安全なスコープ、正確な基準を必須とします。ランタイムが利用できない場合に、手書きのマップで代用してはなりません。
ルートマップ
| リクエスト条件 | 読み込むもの | 結果 |
|---|---|---|
| 明確なグラフスナップショットを構築/更新する | グラフ操作ゲートと使用方法 | 検証済みの範囲限定スナップショット |
| 識別情報、関係、利用者、影響、権威性、網羅性、競合、またはドリフトをクエリする | グラフ操作ゲートと使用方法 | 基準を明記した簡潔な結果 |
| ルートの所有権、または範囲を限定したソースの解決が曖昧 | 曖昧さのチェックリスト | 解決済みの範囲限定ルート/ソース、または安全な停止 |
| 言語/プロファイルの抽出に関する詳細が必要 | フロントエンドのインベントリ、API 契約マップ、および/またはJava ビルドマップ | プロファイル固有のグラフ証拠 |
| プロジェクト/リポジトリをまたぐシグナルが該当する | プロジェクトの基準情報 | 条件を明記した境界の結果 |
| 要求されたナビゲーションビューをレンダリングする | プロンプトテンプレート | 派生した破棄可能なビュー |
不変条件
- スコープ外への逸脱を拒否し、実行ローカルのキャッシュを分離してスキャン対象から除外します。
- グラフ/クエリで見つからない場合は、範囲を限定した
Not foundであり、存在しない証拠ではありません。古いスナップショットは古いままです。 - リポジトリのガイダンス、製品/デザインの契約、ソース、ランタイムの事実、Git の状態を複製または作成せず、ネイティブな正本をインデックス化します。
出力マップ
機能/バージョン、基準、スコープ/除外対象、スナップショット/クエリの識別情報、網羅性、未解決/競合/古さの状態、および Not verified の境界を返します。レンダリング結果には入力を明記します。
リファレンスマップ
- すべてのスキャン/クエリでグラフ操作ゲートを読みます。ルートの所有権、または範囲を限定したソースの解決が曖昧な場合に限り、曖昧さのチェックリストを読みます。
- ルートの例と所有者の境界については、使用方法を読みます。
- 該当する場合に限り、フロントエンドのインベントリ、API 契約マップ、Java ビルドマップ、プロジェクトの基準情報、再利用インデックス、およびプロンプトテンプレートを読みます。
- 明示的なガイダンスの作成/ブートストラップ/更新リクエストを識別して適切な場所へ振り分ける場合に限り、プロジェクトガイダンスを読みます。
repo-mapで作成指示として使用してはなりません。 - メンテナーのみ:評価ケースを読みます。通常の実行時には読み込まないでください。
コメント
Markdown 対応