Agent Capability Design

In AI Agent terms: Tool = a callable function (e.g., get_weatherrun_sql). Capability = a complete skill (e.g., “Data Quality Reporting”) that orchestrates tools, prompts, and logic to achieve a business outcome.
CN: 在AI Agent术语中:工具 = 一个可调用函数(如 get_weatherrun_sql)。能力 = 一项完整技能(如“数据质量报告”),它编排工具、提示词和逻辑来实现业务结果。

The Relationship 

  • A Capability uses Tools, not the other way around. 能力(Capability)使用工具(Tools),而不是反过来。
  • One Capability can use 0, 1, or many Tools.  一个能力可以使用0个、1个或多个工具。
  • The Capability defines the “what” and the “why”; the Tool defines the “how”. 能力定义“做什么”和“为什么做”;工具定义“怎么做”。
  • The Capability also includes a System Prompt (role), an output format, error handling, and retry logic – all invisible to the LLM’s top-level decision maker. 能力还包括系统提示词(角色)、输出格式、错误处理和重试逻辑——所有这些对LLM的顶层决策者都是不可见的。

SKILL.md Specification: File Structure & description

Step by Step Writing An Entitle Data Quality Skill