[提交工具]

贡献新工具

+ 添加新工具

为 CLI 工具添加 Agent 可读的元数据：适用场景、风险等级、安全约束和决策指导。

[收录标准]适合收录

✓ Agent 可直接通过命令行调用
✓ 用于搜索、读写、测试、调试或部署
✓ 风险和约束语义明确
✓ 对 AI 编程工作流有实际价值

[不予收录]不适合

✕ 无 CLI 接口的库或框架
✕ 纯 GUI 应用
✕ 泛技术百科内容
✕ 无明确 Agent 使用场景的工具

[提交流程]4 步

01

Fork 仓库
02

创建 data/tools/your-tool.yaml
03

填写必要的元数据字段
04

提交 Pull Request

[YAML 模板]字段说明

name: my-tool
binary: my-tool
aliases: []
category:
  - search
lang:
  - all
summary: "One-line description of what it does."
homepage: "https://github.com/..."
docs: "https://..."
detect:
  version_args: ["--version"]
use_when:
  - "Scenario where an agent should pick this tool"
avoid_when:
  - "Scenario where another tool is better"
guardrails:
  - "Safety advice for agents using this tool"
risk:
  level: medium
  effects:
    - read_files
    - write_files
  requires_auth: false
  destructive: false