| name | _template |
| description | 新建 Skill 的复制模板,含 Gate 与停止条件。仅供复制到 skills/<技能名>/,勿安装。 |
| metadata | {"internal":true} |
Skill 模板(_template)
复制本目录到新技能文件夹(如 skills/my-skill/),不要安装此目录。
已在 SKILL.md 中设置 metadata.internal: true,npx skills add 默认不会列出或安装。
何时使用
工作流程
- 第一步
- 第二步
- 第三步
验收(Gate)
执行者与验收者分离:写产出的 Agent 不得在无约束下自判「已完成」。
| 角色 | 说明 |
|---|
| 执行 | 主 Agent 按工作流程产出 |
| 验收 | 独立检查:测试命令、Lint、对照 references/ 规范,或另一次只读审查 |
验收不通过时:带着具体错误信息修正,进入下一轮(见下方停止条件)。
停止条件
Loop 或多次重试时必须设硬上限,避免无限烧 Token:
| 类型 | 示例 |
|---|
| 迭代次数 | 最多 3 轮 |
| Token / 成本 | 单任务预算上限(按你的工具设定) |
| 时间 | 单次运行不超过 N 分钟 |
任一条件触达即停止,汇总当前进度交人工处理。
状态(可选)
长任务、跨会话续跑时,在 references/STATE.md(或项目约定路径)记录:
- 目标与当前进度
- 已通过 / 未通过的验收项
- 待人工决策的问题
每次运行先读 STATE,再写回更新。
参考文件
references/... — 规范、API、示例