SuperAPI AI 工具集

write-a-skill

智能体与模型

查看项目

更新于 10-16 05:50

技能介绍

用途:帮助用户创建、编写或构建新的 Agent Skill,产出符合规范结构的技能文件,并通过渐进式披露控制加载内容。

流程:先澄清范围,询问用户技能类型(纯指令、指令加辅助脚本、CLI 工具封装),以及是否需要预载上下文(加载时自动运行命令,选项标注为推荐)。随后浏览现有技能仓库,阅读相似技能以了解约定,起草 SKILL.md,再与用户评审,确认覆盖范围并询问遗漏项。

结构:目录为 skill-name/,其中 SKILL.md 为必需,所有指令都写在此文件;scripts/ 为可选,仅放通过 Bash 调用的可执行文件(如 .sh、.py)。

SKILL.md 模板包含三部分:frontmatter 中的 name 与 description;正文的 Workflow(编号步骤)、Rules(硬性约束)、Error Handling(如果 X 则做 Y)。frontmatter 中 name 必填,使用 kebab-case 且与目录名一致;description 必填,是 Agent 判断何时加载该技能的唯一信号。

description 规则:最长 1024 字符;第一句写做什么;第二句写 Use when [触发条件];第三句可选,写 Don't use when [反触发条件]。示例:好描述如“按关注点把未暂存改动分组为原子提交。当用户说‘atomic commits’或想在推送前拆分改动时使用。”坏描述如“帮助处理提交。”

可写极简技能,纯指令约 20 行即可。预载上下文用 ! 前缀在加载时自动运行命令,例如列出 Status 为 !git status、Diff 为 !git diff HEAD,避免浪费一轮去获取 Agent 总需要的上下文。

规则:技能中不写时效性信息(版本、日期);为可预见的失败模式加入错误处理;发布前通过调用测试该技能。

反模式:description 没有触发条件;硬编码会过期的版本或日期;运行 Bash 命令的技能没有错误处理。

限制:资料未提供具体安装命令、收费或价格、平台支持范围等,暂未提供;名称、URL 与字段要求按原文保留。