Communityコーディング&開発github.com

Dev-PGVAA/skills

リポジトリ内の動作の所在を説明し、エビデンスに基づいたアーキテクチャマップの作成/更新、またはMermaidやdraw.ioでの実際のコンポーネント関係図の描画を行います。リポジトリの把握とアーキテクチャ図に使用します。

skills とは?

このスキルは、開発者やAIエージェントが大規模なリポジトリを効率的にナビゲートし、アーキテクチャの可視化とドキュメント化を行うためのものです。主にClaude CodeやCursor、CodexなどのAIエージェントで使用することを想定しており、リポジトリ内のコードの所在を素早く特定する「クイックオリエンテーション」、エビデンスに基づいた永続的なマップを作成・更新する「orient」、Mermaidやdraw.ioを用いたアーキテクチャ図を生成する「diagram」の3つのルートを提供します。大規模リポジトリでは、独立した領域(例:API/auth、workers/data)に並行して探索エージェントを割り当て、親エージェントが結果を統合・重複排除・整合性確認を行います。このスキルは、エビデンスに基づく正確さ(パッケージの存在=本番稼働ではない、import=ネットワークデプロイではない)を重視し、検証済みのリンクと図の構文チェックを実施するため、信頼性の高いアーキテクチャドキュメントの作成が可能です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Dev-PGVAA/skills/tree/HEAD/codebase-map

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

コードベースマップ

ユーザーのタスクに必要なコードを特定し、要求に応じて有用なオリエンテーション情報を保持します。ソースの証拠、宣言された設定、観測されたランタイムの振る舞いを区別します。

要求された成果物に応じたルート

  • Xはどこか / クイックオリエンテーション: 関連する既存のマップを読み、そのパスをチェックアウトと照合します。短いフローとエントリポイントのリンクで回答します。ドキュメントの書き込みは不要です。
  • 永続的なマップの作成 / 更新: orient を使用します。既存のドキュメントレイアウトとローカルの指示を保持します。
  • アーキテクチャ図: diagram を使用します。図は、ドキュメントスイート全体を生成せずに、フォーカスしたソースパスから作成できます。

並行探索

大規模なリポジトリでは、独立した境界領域(例:API/認証、ワーカー/データ、UI/ナビゲーション)を委任します。各スカウトは読み取り専用で、実際のパス/シンボル、エントリポイント、証拠付きの依存関係、不確実性、および検査した正確なリビジョンを返します。すべてのスカウトにツリー全体をスキャンさせる必要はありません。

親は、インデックス、共有ドキュメント、および領域間の接続を所有します。書き込み前に、境界の主張を検証し、重複を排除し、矛盾する名前を調整します。エージェントが利用できない場合やスコープが小さい場合は、同じ焦点を絞った探索を順次実行します。委任は作業を節約できる場合にのみ有用であり、ファイルごとに1つのエージェントを作成してはいけません。

証拠と完了

パッケージの存在は、それが本番環境で実行されていることを証明しません。import はネットワークデプロイを証明しません。検査した内容と不明な点を記録します。提供されたすべてのローカルリンクと図のソース構文を、利用可能なツールで検証します。実際の検証結果と最適な開始ファイルを報告し、リポジトリ全体のリストは報告しません。

回答のトーン

まず要点を述べます。段階的な導入、「XではなくY」といった表現、チャットの残骸、意味のない装飾は避けます。短い文と長い文を混在させます。事実と条件は証拠と同じ強さで述べます。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル