agent-capability-discovery

エージェントの機能の検出

目的と意図

agent-capability-discovery スキルは、マルチエージェントシステムの「頭脳」です。すべての skill.yaml ファイルをインデックス化することで、エージェントが自己を省みて、環境内で利用できるツールと専門知識を把握できるようにします。

使用する場面

• システムの初期化：エージェントの起動時に実行し、内部ツールリストを作成します。
• ルーティングの判断：マスターエージェントが複雑なユーザーリクエストを受け取り、どの専門スキル（例：hipaa-compliance-guard と pii-sanitizer）が最適かを特定する必要がある場合に使用します。
• ドキュメントの生成：人間の開発者向けの「グローバルスキルマップ」を常に最新の状態に保ちます。

使用しない場面

• スキルの実行：このスキルが行うのは可能なことの検出のみで、ほかのスキルは実行しません。
• 外部ツール：ローカルのリポジトリ構造で定義されたスキルのみをインデックス化します。

入力と出力の例

入力

base_directory: "."
output_format: "markdown"

出力

検出されたすべてのスキル、その説明、主な機能を一覧にした Markdown テーブルまたは JSON オブジェクト。

エラー条件とエッジケース

• 壊れた YAML：skill.yaml の形式が正しくない場合、検出ツールはそのディレクトリをスキップし、警告を報告します。
• 循環依存関係：このツールは検出のみを行い、実行時の依存関係には対応しません。

セキュリティとデータ処理に関する考慮事項

• メタデータのみ：このツールは定義ファイルのみを読み取ります。インデックス化されたスキルから指示されない限り、実際のソースコードやデータには一切アクセスしません。
• ローカルスコープ：ディレクトリトラバーサル攻撃を防ぐため、検出は指定されたルートディレクトリ内に限定されます。