SuperAPI AI 工具集

write-a-skill

智能体与模型

查看项目

更新于 10-16 01:38

技能介绍

用途:指导创建新的 agent 技能,产出包含正确结构、渐进式披露和捆绑资源的技能。

流程:先收集需求,向用户询问技能涵盖的任务或领域、需处理的具体用例、是否需要可执行脚本而非仅说明、是否有要包含的参考材料;再起草技能,创建含简洁说明的 SKILL.md,内容超过 500 行时添加额外参考文件,需要确定性操作时添加实用脚本;最后与用户一起审查草稿,确认是否覆盖用例、是否有遗漏或不清晰之处、某部分是否需要更详细或更简洁。

技能结构:技能目录包含 SKILL.md 主说明(必需),可选 REFERENCE.md 详细文档、EXAMPLES.md 使用示例、scripts/ 实用脚本目录(如 helper.js)。SKILL.md 模板以 name 和 description 前置元数据开头,正文包括 Quick start、Workflows、Advanced features 等部分。

description 是 agent 决定加载哪个技能时唯一看到的内容,会与所有已安装技能一起出现在系统提示中,上限 1024 字符,用第三人称书写:第一句说明它做什么,第二句写 “Use when [specific triggers]”。

添加脚本的时机:操作具有确定性(如验证、格式化)、同样的代码会被反复生成、错误需要显式处理;脚本比生成代码更省 token 且更可靠。拆分文件的时机:SKILL.md 超过 100 行、内容有明显领域划分、高级功能很少被需要。

审查清单:描述包含触发条件(“Use when...”)、SKILL.md 保持在 100 行以内、没有时效性信息、术语一致、包含具体示例、引用深度为一级。

限制:资料未提供该技能的安装命令、收费或价格、平台支持范围等具体信息。