SuperAPI AI 工具集

write-a-skill

通用与其它

查看项目

更新于 10-15 23:44

技能介绍

用途:帮助用户创建、编写或构建新的代理技能,产出具有适当结构、渐进式披露和捆绑资源的技能。

主要能力与流程:先收集需求,询问技能涵盖的任务或领域、要处理的特定用例、是否需要可执行脚本或仅指令、是否有参考材料;再起草技能,创建带简洁指令的 SKILL.md,内容超过 500 行时添加额外参考文件,需要确定性操作时添加工具脚本;最后与用户审查草稿,确认是否覆盖用例、有无缺失或不清晰之处、各部分详略是否合适。

技能结构:skill-name/ 目录下包含必需的 SKILL.md,以及按需的 REFERENCE.md、EXAMPLES.md 和 scripts/(如 helper.js)。SKILL.md 模板含 name、description 前置元数据,以及快速开始、工作流程、高级功能等章节,高级内容可链接到单独文件。

描述要求:description 是代理选择加载技能时唯一可见的信息,最多 1024 个字符,用第三人称书写,第一句说明做什么,第二句用“Use when [特定触发器]”说明何时使用,需包含具体关键字、上下文或文件类型。

脚本与拆分:操作确定性(验证、格式化)、相同代码重复生成、错误需明确处理时添加脚本,可节省 token 并提高可靠性;SKILL.md 超过 100 行、内容分属不同领域、高级功能很少需要时拆分为单独文件。

审查清单:确认描述含触发器、SKILL.md 少于 100 行、无时间敏感信息、术语一致、含具体示例、引用仅一层深度。

限制:资料未提供具体安装命令、收费方式、平台支持或实际效果说明。