SuperAPI AI 工具集

write-a-skill

智能体与模型

查看项目

更新于 10-15 22:11

技能介绍

用途:这是一个用于创建新智能体技能的技能,指导生成结构规范、采用渐进式披露并打包必要资源的技能文件。当用户想要创建、编写或构建新技能时触发。

主要能力与流程:

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

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

SKILL.md 模板包含 frontmatter(name、description)、Quick start、Workflows、Advanced features 等部分。

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

AskUserQuestion 选项:label 为 1-5 个词的短标签,description 为 1-2 句解释。

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

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

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

限制:资料未提供该技能的收费、价格、平台支持或效果数据。