agent-capability-discovery

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Agent Capability Discovery

Agent能力发现

Purpose and Intent

用途与目标

The

agent-capability-discovery

skill is the "brain" of a multi-agent system. It allows an agent to self-reflect and understand what tools and expertises are available within its environment by indexing all

skill.yaml

files.

agent-capability-discovery

skill是多agent系统的"大脑"。它通过索引所有

skill.yaml

文件，让agent能够自我审视并了解其环境中可用的工具和专业能力。

When to Use

适用场景

System Initialization: Run this when an agent starts up to populate its internal tool list.
Routing Decisions: Use this when a master agent receives a complex user request and needs to identify which specialized skill (e.g.,
```
hipaa-compliance-guard
```
vs.
```
pii-sanitizer
```
) is best suited for the job.
Documentation Generation: Automatically keep a "Global Skills Map" up to date for human developers.

系统初始化：在agent启动时运行该skill，以填充其内部工具列表。
路由决策：当主agent收到复杂用户请求，需要确定哪种专业skill（如
```
hipaa-compliance-guard
```
与
```
pii-sanitizer
```
）最适合该任务时使用。
文档生成：为人类开发者自动更新"全局技能图谱"。

When NOT to Use

不适用场景

Skill Execution: This skill only discovers what is possible; it does not execute the other skills.
External Tooling: It only indexes skills defined in the local repository structure.

Skill执行：该skill仅用于发现可用能力，不执行其他skill。
外部工具：它仅索引本地仓库结构中定义的skill。

Input and Output Examples

输入输出示例

Input

输入

yaml

base_directory: "."
output_format: "markdown"

yaml

base_directory: "."
output_format: "markdown"

Output

输出

A markdown table or JSON object listing all discovered skills, their descriptions, and their primary capabilities.

一份markdown表格或JSON对象，列出所有已发现的skill、它们的描述以及主要能力。

Error Conditions and Edge Cases

错误情况与边缘场景

Broken YAML: If a
```
skill.yaml
```
is malformed, the discovery tool will skip that directory and report a warning.
Circular Dependencies: This tool does not handle execution dependencies, only discovery.

损坏的YAML：如果
```
skill.yaml
```
格式错误，发现工具将跳过该目录并发出警告。
循环依赖：该工具不处理执行依赖，仅负责发现。

Security and Data-Handling Considerations

安全与数据处理注意事项

Metadata Only: The tool only reads the definition files; it never touches actual source code or data unless instructed by the indexed skills themselves.
Local Scope: Discovery is confined to the provided root directory to prevent directory traversal attacks.

仅处理元数据：该工具仅读取定义文件；除非被索引的skill本身指示，否则不会触及实际源代码或数据。
本地范围：发现操作仅限于提供的根目录，以防止目录遍历攻击。