用途:write-a-skill 用于创建新的智能体技能,强调规范结构、渐进式披露与捆绑资源。当用户想创建、编写或构建新技能时触发。
主要能力与流程:
- 收集需求:询问技能覆盖的任务或领域、需处理的具体用例、是否需要可执行脚本还是仅需说明、是否包含参考资料。
- 起草技能:创建 SKILL.md(简洁说明);内容超过 500 行时增加参考文件;需要确定性操作时添加工具脚本。
- 与用户复核:确认是否覆盖用例、有无遗漏或不清晰之处、各章节详略是否合适。
技能结构:skill-name/ 目录下包含 SKILL.md(必需)、REFERENCE.md(按需)、EXAMPLES.md(按需)、scripts/(按需,如 helper.js)。
SKILL.md 模板要点:frontmatter 含 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 行、内容属于不同领域(如财务与销售 schema)、高级功能很少用到时。
复核清单:描述包含触发条件(“Use when...”);SKILL.md 少于 100 行;无时效性信息;术语一致;包含具体示例;引用只深入一层。
限制:资料未提供该工具的收费、价格、平台支持或效果数据,暂未提供。