template

name	_template
description	新建 Skill 的复制模板，含 Gate 与停止条件。仅供复制到 skills/<技能名>/，勿安装。
metadata	{"internal":true}

Skill 模板（_template）

复制本目录到新技能文件夹（如 skills/my-skill/），不要安装此目录。

已在 SKILL.md 中设置 metadata.internal: true，npx skills add 默认不会列出或安装。

何时使用

• 场景 1
• 场景 2

工作流程

1. 第一步
2. 第二步
3. 第三步

验收（Gate）

执行者与验收者分离：写产出的 Agent 不得在无约束下自判「已完成」。

角色	说明
执行	主 Agent 按工作流程产出
验收	独立检查：测试命令、Lint、对照 references/ 规范，或另一次只读审查

验收不通过时：带着具体错误信息修正，进入下一轮（见下方停止条件）。

停止条件

Loop 或多次重试时必须设硬上限，避免无限烧 Token：

类型	示例
迭代次数	最多 3 轮
Token / 成本	单任务预算上限（按你的工具设定）
时间	单次运行不超过 N 分钟

任一条件触达即停止，汇总当前进度交人工处理。

状态（可选）

长任务、跨会话续跑时，在 references/STATE.md（或项目约定路径）记录：

• 目标与当前进度
• 已通过 / 未通过的验收项
• 待人工决策的问题

每次运行先读 STATE，再写回更新。

参考文件

• references/... — 规范、API、示例