关于 implement-next-phase
用于按 sketch 计划实施下一个待办阶段的编码 Agent 技能。它要求先只读准备并等待明确批准,再仅实施获批阶段并更新其状态。
主要功能
- 01选择计划中首个待办阶段
- 02核对阶段标题与 todo 标签
- 03批准前仅进行只读准备
- 04改动限于获批阶段
- 05编辑后将阶段标记为完成
- 06禁止新增测试
适用场景
- 01按 sketch 计划实施分阶段改动
- 02等待批准期间准备实施阶段
- 03确保改动不超出约定阶段范围
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jasonharmongit/ skills --skill implement-next-phase安装后在 Claude Code 中输入/implement-next-phase确认已加载。
详细介绍
调用此技能
当合作方附加此技能并提供草图计划路径时使用。该计划包含 YAML todos(每个阶段一项,每项的 content 与 ## Sketch 中对应的 ### Phase N - … 标题一致),文件正文中还包含 ## Sketch 部分。
不可妥协:在合作方明确批准继续之前(例如:“开始吧”“实现”“继续 Phase 2”),不得为此工作编辑应用代码、测试、配置或资源。可以进行准备工作(阅读、搜索、分析、提问),但在获得批准之前不得开始构建。
准备期间的聊天要求:不得提交研究报告、发现汇总或所学内容摘要。不得在聊天中复述或总结草图、计划或代码库。合作方已经有计划。聊天中只能发送:遇到阻碍或不明确之处时提出简洁的问题;计划或 todos 需要修正时提出简短请求;如果没有其他问题,则发送一条简短的实现批准请求,注明当前阶段的 todo content(例如:准备好实现 Phase 1 - …,请批准)。聊天中不得包含其他准备说明。
Git 暂存(每个阶段周期开始前)
每当此技能开始一个新的阶段周期时——计划中的第一个待处理阶段,或前一阶段完成后的下一个待处理阶段——运行 git add -A,然后阅读并准备。不要提交。在完成暂存之前,不要开始下面的第 1 步。
这会在新一轮准备或实现开始前,为前一阶段的工作(或任何其他未暂存的编辑)创建检查点。
首要操作,按顺序执行
-
**阅读合作方提供的草图计划文件。**解析 YAML frontmatter,并阅读文件正文中的
## Sketch部分。 -
**从
todos中选择当前阶段:**选择第一个状态为pending(或未设置/不是completed)的 todo。该 todo 的content即为当前阶段标签。如果todos缺失、为空,或没有待处理项,停止并请合作方修正计划,或提供合适的 solutionize 草图后再继续。 -
根据草图了解情况:在
## Sketch中,找到标题文本与当前 todocontent匹配的### Phase N - …部分;阅读该部分的 Objective 和实施范围条目。如果没有匹配的标题,停止并请合作方使 todos 与草图保持一致。浏览草图中较早的阶段,了解顺序和依赖关系。 -
收集上下文(只读):
- 阅读合作方指定的已完成阶段材料,或同一计划中记录了已完成工作的较早部分。
- 打开草图中为当前阶段链接或提及的文件;必要时沿调用者/被调用者关系继续查看。
- 持续搜索和读取代码库,直到你能够无需猜测地完成实现。将这些了解保留在内部;不要写入聊天。
-
核对并提问:如果研究结果与草图矛盾、遗漏了代码所需内容,或发现任何异常(符号缺失、路径错误、测试不再匹配),就在聊天中提出一个简洁的问题(或最少数量的问题),不要添加背景说明。如果阶段内容含糊不清,也用同样的方式提问,不要自行假设。
-
准备就绪后交接:如果仍有未解决的问题,留在第 5 步;问题解决前不要请求批准。没有其他问题时,只发送上文准备期间的聊天要求中所述的简短批准请求(阶段名称使用 todo
content)。**停止。**在合作方明确批准之前,不要实现。
批准后
合作方批准后,严格按照草案和之前的答复,仅实施该阶段;严格控制范围。如果批准针对特定阶段编号,未经新一轮本技能流程或明确指示,不要继续推进到下一阶段。
不添加新测试: 实施阶段时不要添加全新的测试。只有在行为变更需要时才更新现有测试。
不添加跨阶段脚手架: 如果草案将相关工作推迟到后续阶段,不要修改代码以使当前阶段可以独立运行。不要添加默认值、占位符、临时检查、存根、空操作或类似的衔接工作来掩盖当前阶段与未来阶段之间的缺口——除非草案明确要求在当前阶段完成这些工作。
该阶段的实现修改完成后立即编辑草案计划文件:在 YAML frontmatter 中将当前阶段待办事项的 status 设为 completed。必须在对计划或代码库进行任何其他后续操作之前完成此项。