impl

按 plan.md 实现:一轮只做一个 phase,跑该 phase 自己写的验证命令并贴真实输出,然后停下等用户决定。用于 /plan 产出 plan.md 之后的实现阶段。

SKILL.md

GitHub

按 plan 实现

为什么 allowed-tools 里是完整的 Bash:本 skill 的核心动作就是跑 plan 为这个 phase 写的那条验证命令,那条命令是什么事先不知道,收窄成 git 只读只会让每次验证都卡在权限确认上。 另外注意:allowed-tools 是「本轮免批准的范围」,不构成硬限制,不要把它当安全机制。

目标 plan:$ARGUMENTS(可以是目录,也可以直接是 plan.md 路径;留空则取 docs/plans/ 下日期最新的那个目录)

第 1 步 定位并读 plan

读 docs/plans/<...>/plan.md。只读 plan.md,research.md 除非 plan 里有指向否则不读—— 它的作用在 plan 写完那刻就结束了,再读只是烧 context。

确认三件事,缺任何一件就停下问用户:

  • 有明确的 phase 划分
  • 每个 phase 有验证命令和成功判据
  • 有「不在范围内」小节

然后报告:本 plan 共几个 phase,本轮准备做哪一个(默认第一个未完成的)。

第 2 步 只做一个 phase

一轮只做一个 phase。 做完不要接着做下一个,哪怕它看起来很小。

实现时:

  • 严格按 plan 写的「改哪个文件、改什么」来。
  • plan 写错了(比如行号对不上、函数已经改名)→ 说出来,问用户,不要自行发挥。
  • 需求在 plan 里没写清楚 → 问,不要挑一个自己觉得对的解释往下做。

第 3 步 验证并贴证据

跑 plan 里为这个 phase 写的那条验证命令,不要换成别的。

然后贴真实输出:

  • 原样粘贴命令和它的输出(长就截关键段落,并说明截了)。
  • 逐条对照该 phase 的成功判据,写「达成 / 未达成」。
  • 不要用「测试通过了」「看起来正常」代替真实输出。 没有输出就等于没验证。
  • 验证失败就如实说失败,然后停下。不要一边说「基本没问题」一边悄悄改判据。

第 4 步 提交并停下

验证通过后立即 commit 并 push(用户永久授权,见 .claude/rules/versioning.md: 一个 phase 一个 commit,message 格式 vX.Y <功能短语>: <一句话>;验证失败则不提交)。

然后输出:

  1. 本 phase 改了哪些文件 + commit hash(已提交推送)
  2. 验证命令 + 真实输出 + 判据对照
  3. 「发现但未做」里新增了什么(若有)
  4. 这句提示:「建议 /clear 再进下一个 phase。」

等用户决定是否继续。

禁止扩大范围

实现过程中一定会看到别的问题:命名不好、有个 bug 不在 plan 里、这里可以顺手重构一下。

一律不要顺手改。把它追加到 plan.md 的「## 发现但未做」小节,一行一条,写清楚 文件:行号 和问题是什么,然后继续做当前 phase。

例外只有一个:不改它当前 phase 就无法完成。这时先说明,再改,并在输出里单独标出来。

理由:diff 一旦超出 plan,validate 阶段就没法做「对照 plan 逐条核对」了, 整个 R-P-I-V 的验收环节会失效。

硬约束

  • 一轮一个 phase。
  • 验证通过即自动 commit + push,不要等用户。(2026-07-25 用户明确指示,与 versioning.md 的永久授权一致;此前「留给用户提交」的旧约定作废。) 验证没过就不许提交——提交的前提永远是判据达成。force-push / 改历史仍禁止。
  • 不改 plan.md 里「不在范围内」列出的东西。
  • 不产生任何数值结论。指标必须由受版本控制的脚本产生,需要跑实验走 /exp。
  • 同一处被用户纠正 2 次仍不对 → 停下来建议 /clear 重开,不要继续试第 3 次。