SuperAPI AI 工具集

write-a-skill

智能体与模型

查看项目

更新于 10-16 04:33

技能介绍

用途:指导创建新的智能体技能,使其具备规范结构、渐进式披露和配套资源。当用户想要创建、编写或构建新技能时使用。

主要能力与流程:

  1. 收集需求:询问用户技能覆盖的任务或领域、需处理的具体用例、是否需要可执行脚本或仅需说明、是否包含参考资料。
  2. 起草技能:创建 SKILL.md(简洁说明);内容超过 500 行时增加参考文件;需要确定性操作时添加工具脚本。
  3. 与用户复核:展示草稿并确认是否覆盖用例、有无遗漏或不清晰之处、各章节详略是否合适。

技能结构: skill-name/ ├── SKILL.md(必需,主说明) ├── REFERENCE.md(按需,详细文档) ├── EXAMPLES.md(按需,用法示例) └── scripts/(按需,工具脚本,如 helper.js)

SKILL.md 模板要点:前置元数据含 name 与 description;正文包含 Quick start(最小可用示例)、Workflows(复杂任务的步骤与清单)、Advanced features(链接到独立文件,如 See REFERENCE.md)。

描述要求:description 是智能体决定加载哪个技能时唯一可见的内容,会与其他已安装技能一起出现在系统提示中。目标:说明该技能提供什么能力,以及何时/为何触发(具体关键词、上下文、文件类型)。格式:最多 1024 字符,使用第三人称,第一句写功能,第二句写“Use when [具体触发条件]”。示例:Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when user mentions PDFs, forms, or document extraction. 反例:Helps with documents.(无法与其他文档技能区分。)

何时添加脚本:操作为确定性(校验、格式化)、同一代码会被反复生成、错误需显式处理时。脚本相比生成代码可节省 token 并提升可靠性。

何时拆分文件:SKILL.md 超过 100 行、内容属于不同领域(如财务与销售模式)、高级功能很少使用时。

复核清单:描述包含触发条件(“Use when...”);SKILL.md 少于 100 行;无时效性信息;术语一致;包含具体示例;引用仅一层深度。