agent-capability-discovery

Agent 能力发现

目的与意图

agent-capability-discovery 技能是多 Agent 系统的“大脑”。它通过索引所有 skill.yaml 文件，让 Agent 能够自我反思，了解其环境中有哪些工具和专业能力。

适用场景

• 系统初始化：在 Agent 启动时运行，以填充其内部工具列表。
• 路由决策：主 Agent 收到复杂的用户请求，需要判断哪项专用技能（例如 hipaa-compliance-guard 或 pii-sanitizer）最适合处理时使用。
• 文档生成：自动维护最新的“全局技能地图”，供开发者查阅。

不适用场景

• 技能执行：此技能只会发现可用能力，不会执行其他技能。
• 外部工具：它只会索引本地仓库结构中定义的技能。

输入和输出示例

输入

base_directory: "."
output_format: "markdown"

输出

列出所有已发现技能、其描述和主要能力的 Markdown 表格或 JSON 对象。

错误条件和边缘情况

• YAML 格式错误：如果 skill.yaml 格式不正确，发现工具会跳过该目录并报告警告。
• 循环依赖：此工具不处理执行依赖，只负责发现。

安全和数据处理注意事项

• 仅限元数据：此工具仅读取定义文件；除非索引的技能明确要求，否则不会访问实际源代码或数据。
• 本地范围：发现范围仅限于指定的根目录，以防止目录遍历攻击。