SuperAPI AI 工具集

write-a-skill

智能体与模型

查看项目

更新于 10-16 03:37

技能介绍

用途:这是一个撰写 agent 技能的指导型技能,用于在用户想创建、撰写或构建新技能时,给出结构化的编写流程与规范。

主要流程:

  1. 收集需求:询问用户技能覆盖什么任务/领域、需要处理哪些具体用例、是否需要可执行脚本还是仅指令、是否要包含参考材料。
  2. 起草技能:创建含简洁指令的 SKILL.md;内容超过 500 行时增加参考文件;需要确定性操作时添加工具脚本。
  3. 与用户复核:呈现草稿并确认是否覆盖用例、有无遗漏或不清晰之处、某部分是否需要更详细或更简略。

结构约定:目录包含必需的 SKILL.md,以及按需的 REFERENCE.md、EXAMPLES.md 和 scripts/ 工具脚本目录。SKILL.md 模板含 name 与 description 的 front matter,以及快速开始、工作流、高级特性等章节。

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

脚本与拆分:操作具确定性(校验、格式化)、同一代码会被反复生成、错误需显式处理时添加脚本,可节省 token 并提升可靠性。SKILL.md 超过 100 行、内容分属不同领域、高级特性很少用到时拆分为单独文件。

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

限制:资料未提供更多平台、收费或运行环境信息。