SKILL.md 1.81 KB

name: feature-verify description: 功能循环第 4 步。把功能测试派发到子会话跑,按模板渲染证据。无证据不声称完成。 user-invocable: false

allowed-tools: Skill Read Agent

所有输出必须使用中文。

feature-verify

把当前 REQ 的功能测试派发到 Agent 子会话执行,按模板把结构化结果渲染成证据。主会话从不直接跑测试,也不自由编写证据。

执行步骤

  1. 从 plan 文件或项目标准命令中确定功能的测试目标(如 Maven profile / pnpm script / pytest path)。
  2. 派发 Agent 子会话(general-purpose)运行该目标,子会话只返回结构化 JSON(不输出描述文字): json { "command": "<cmd>", "exit_code": <int>, "passed": <int>, "failed": <int>, "failed_list": ["<test>", ...], "stdout_excerpt": "<最后 30 行或最相关的失败片段>" }
  3. ${CLAUDE_SKILL_DIR}/templates/feature-verify-evidence-template.md 渲染证据并打印到会话。
  4. exit_code != 0failed > 0 → 停止,不进入 review。
  5. 通过 → 同一 turn 内立即 Skill(feature-review)(直接调用,不要先输出"已完成 / 接下来 / 请检查 / 等你确认"之类桥接叙述——会被解读为 turn 结束信号、害用户手敲 continue)。

护栏

  • 绝不在主会话直接跑测试,必须通过子会话
  • 绝不自由编写证据正文,必须从模板渲染
  • 不要把原始 stdout 全文塞进主会话(stdout_excerpt ≤ 30 行)

参考

  • ${CLAUDE_SKILL_DIR}/templates/feature-verify-evidence-template.md
  • 原则参考:superpowers:verification-before-completion(外部"证据先于断言"原则手册,本 skill 已固化子会话派发 + 模板渲染流程,不做运行时 invoke)