impl
按 plan.md 实现:一轮只做一个 phase,跑该 phase 自己写的验证命令并贴真实输出,然后停下等用户决定。用于 /plan 产出 plan.md 之后的实现阶段。
Файлы1
Открыть в GitHubSKILL.md.claude/skills/impl/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 <功能短语>: <一句话>;验证失败则不提交)。
然后输出:
- 本 phase 改了哪些文件 + commit hash(已提交推送)
- 验证命令 + 真实输出 + 判据对照
- 「发现但未做」里新增了什么(若有)
- 这句提示:「建议 /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 次。