SuperAPI AI 工具集

write-a-skill

智能体与模型

查看项目

更新于 10-15 21:10

技能介绍

用途:该技能用于指导创建新的智能体技能(agent skill),产出结构规范、支持渐进式披露并包含配套资源的技能文件。当用户想要创建、编写或构建新技能时使用。

主要能力与流程:

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

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

SKILL.md 模板要点:以 YAML 前置元数据声明 name 与 description,正文包含快速开始、工作流(复杂任务用清单)、高级功能(链接到独立文件)。

description 要求:这是智能体决定加载哪个技能时唯一可见的内容,会与其他已安装技能一起出现在系统提示中。目标:让智能体知道该技能提供什么能力、何时/为何触发(具体关键词、上下文、文件类型)。格式:最多 1024 字符,第三人称,第一句说明做什么,第二句写“Use when [具体触发条件]”。

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

何时拆分文件:SKILL.md 超过 100 行、内容属于不同领域、高级功能很少使用时。

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

限制:资料未提供该技能的安装命令、收费或价格信息,暂未提供。该技能基于 Matt Pocock 的开源工作(MIT License,原仓库 https://github.com/mattpocock/skills),由 webconsulting.at 适配。