关于 implement-plan
面向编码 Agent 的技能,用于按已接受计划逐个完成工作切片,并通过测试、真实系统验收和代码审查验证结果。它强调遵守计划范围、保留用户已有工作,并记录未能确认的结果。
主要功能
- 01按切片逐步实现计划
- 02先复现缺陷再修复
- 03运行测试与机械检查
- 04在真实系统上验收
- 05审查改动并记录证据
适用场景
- 01按计划交付多阶段功能
- 02修复可复现的软件缺陷
- 03验证涉及公共接口的高风险改动
- 04整理验收结果与剩余风险
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ liaoann/ skills --skill implement-plan安装后在 Claude Code 中输入/implement-plan确认已加载。
详细介绍
实施计划
按切片逐一落实已接受的计划。只有在真实系统上展示了预期结果并经过审查后,切片才算完成,而不是检查通过时就算完成。
前提与权限
- 从包含多个切片的已接受计划开始。对于明确且低风险的请求,可以附带一个简短的内联计划,其中只有一个切片;如果原因、方案或切片尚未确定,请使用 /plan-it。
- 必要的范围内源代码和测试变更无需逐个文件审批。对于计划未授权的 Git 操作、破坏性操作、对共享系统或生产系统的写入,以及超出已接受范围的工作或新的设计决策,必须事先获得明确批准。
- 保留与任务无关的用户工作。如果新证据能够保留已接受的结果和边界,请相应调整细节;如果证据推翻了关键选择,请暂停并寻求决策。
切片循环
按以下步骤依次处理每个切片。任何一步未通过,都要将切片退回实现阶段;不得跳过。
-
红灯。 当
TDD: yes时,遵循/tdd,由外向内推进:第一个失败的测试应位于切片验收的层级(集成测试需针对真实路由、端到端调用 CLI,或 e2e 流程),只要测试环境能够触达该层级即可;随着实现需要,再添加更窄范围的测试。测试判断 决定切片何时无需新增测试;记录这项豁免,而不是凭空编造测试。对于 Bug,先复现故障——没有复现的修复只是猜测。对于高风险切片——会更改公共契约、持久化数据、共享模块或生产路径的切片——测试由独立的测试编写子 Agent 编写。它收到的简报仅包含计划的 Why、切片的 Outcome 和 Acceptance,以及公共接口——绝不包含实现方法。它由外向内编写测试,运行测试并确认其因预期原因而呈红灯,然后交回测试。实现者不得编辑这些测试。如果实现者认为某个测试有误,应停止并将测试及理由交还测试编写者或用户,由他们决定。
-
实现。 在切片边界内,以最小改动实现切片的目标。
-
绿灯。 运行切片测试及改动附近的测试。
-
机械检查。 运行项目声明的类型检查、lint、格式化和死代码检查命令。它们必须全部通过。
-
验收。 按计划中的 Acceptance 描述,在真实系统上演示切片的结果。如果项目有验证技能,则使用该技能,并先运行其 Doctor(如果缺少本步骤所需的章节,请说明并建议使用
/maintain-verification-skill);否则,按界面进行验证:在浏览器中走查 Web 流程,并提供改动后页面的截图;运行命令验证 CLI;发送真实请求验证服务;部署并操作基础设施。应用/verification-evidence。验收必须有在真实系统上观察到的证据,并记录命令及其输出或截图;任何较弱的证据都应连同原因报告为无法确定。如果仓库有验证技能,应在切片自身的差异中回写本切片的改动或发现:对于本切片改动的任何面向用户的行为,更新其功能文件——新增功能应创建新文件并在索引中添加条目;对于必须查明的任何启动步骤、注意事项或安全环境信息,更新技能中的 Drive、服务或环境说明。如果计划的权限范围不允许编辑该技能,则报告建议的更新内容。
-
审查。 根据切片的风险,使用其选定的审查视角,对切片差异运行
/review-change。修复已确认的阻塞问题,并针对修复涉及的内容重新运行第 3–5 步。 -
提交。 如果计划授权逐切片提交,则将切片作为独立提交提交;否则报告切片已就绪并继续。
如果任何一步出现无人预料且原因不明显的行为,在继续编辑前应用 /diagnose-bug:复现问题、测试假设,然后修复并重新运行相同的信号。该行为也可能是有意的设计;在“修复”前先确认。
然后开始下一个切片。进度说明仅供参考,不是审批请求。
如果切片超出其边界,应停止并与用户重新划分,而不是让差异范围继续扩大。最后一个切片完成后,使用已完成特性的审查视角,对整个特性整体运行一次 /review-change。
输出
按切片报告,然后给出整体报告:
### Slice <n>: <outcome>
- Tests: <author: implementer / test-author subagent>, <RED evidence or exemption reason>, <GREEN command and result>, <disputed tests and their resolution>
- Checks: <commands and results>
- Acceptance: <passed / failed / inconclusive> — <command, output, or screenshot path>
- Review: <lenses run>, <Blockers fixed>, <residual risk>
- Commit: <hash, or "not committed">
最后说明剩余风险、偏离计划之处,以及任何尚无法确定的事项。
完成标准
每个切片都有记录的测试结果或豁免,高风险切片由独立测试作者测试,且实现者未编辑其测试;机械检查通过;验收结果附有捕获的证据;每个 Where it lives 路径被该切片差异触及的 verify-skill 功能文件,都在该差异中更新(或在未获授权编辑时提出更新建议,或说明无需更新并给出理由);审查中没有尚未解决且已确认的阻塞项;已运行已完成功能审查;每个切片均已提交,或按计划报告为未提交;没有将任何不确定结果报告为通过;没有遗留临时调试代码;所有副作用均未超出已批准的权限范围。