mcpField
I
implement-next-phase

implement-next-phase

github.com/jasonharmongitAgent 工作流040 次安装5 天前更新
代码仓库

关于 implement-next-phase

用于按 sketch 计划实施下一个待办阶段的编码 Agent 技能。它要求先只读准备并等待明确批准,再仅实施获批阶段并更新其状态。

主要功能

  1. 01选择计划中首个待办阶段
  2. 02核对阶段标题与 todo 标签
  3. 03批准前仅进行只读准备
  4. 04改动限于获批阶段
  5. 05编辑后将阶段标记为完成
  6. 06禁止新增测试

适用场景

  1. 01按 sketch 计划实施分阶段改动
  2. 02等待批准期间准备实施阶段
  3. 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 步。

这会在新一轮准备或实现开始前,为前一阶段的工作(或任何其他未暂存的编辑)创建检查点。


首要操作,按顺序执行

  1. **阅读合作方提供的草图计划文件。**解析 YAML frontmatter,并阅读文件正文中的 ## Sketch 部分。

  2. **从 todos 中选择当前阶段:**选择第一个状态为 pending(或未设置/不是 completed)的 todo。该 todo 的 content 即为当前阶段标签。如果 todos 缺失、为空,或没有待处理项,停止并请合作方修正计划,或提供合适的 solutionize 草图后再继续。

  3. 根据草图了解情况:在 ## Sketch 中,找到标题文本与当前 todo content 匹配的 ### Phase N - … 部分;阅读该部分的 Objective 和实施范围条目。如果没有匹配的标题,停止并请合作方使 todos 与草图保持一致。浏览草图中较早的阶段,了解顺序和依赖关系。

  4. 收集上下文(只读):

    • 阅读合作方指定的已完成阶段材料,或同一计划中记录了已完成工作的较早部分。
    • 打开草图中为当前阶段链接或提及的文件;必要时沿调用者/被调用者关系继续查看。
    • 持续搜索和读取代码库,直到你能够无需猜测地完成实现。将这些了解保留在内部;不要写入聊天。
  5. 核对并提问:如果研究结果与草图矛盾、遗漏了代码所需内容,或发现任何异常(符号缺失、路径错误、测试不再匹配),就在聊天中提出一个简洁的问题(或最少数量的问题),不要添加背景说明。如果阶段内容含糊不清,也用同样的方式提问,不要自行假设。

  6. 准备就绪后交接:如果仍有未解决的问题,留在第 5 步;问题解决前不要请求批准。没有其他问题时,只发送上文准备期间的聊天要求中所述的简短批准请求(阶段名称使用 todo content)。**停止。**在合作方明确批准之前,不要实现。

批准后

合作方批准后,严格按照草案和之前的答复,仅实施该阶段;严格控制范围。如果批准针对特定阶段编号,未经新一轮本技能流程或明确指示,不要继续推进到下一阶段。

不添加新测试: 实施阶段时不要添加全新的测试。只有在行为变更需要时才更新现有测试。

不添加跨阶段脚手架: 如果草案将相关工作推迟到后续阶段,不要修改代码以使当前阶段可以独立运行。不要添加默认值、占位符、临时检查、存根、空操作或类似的衔接工作来掩盖当前阶段与未来阶段之间的缺口——除非草案明确要求在当前阶段完成这些工作。

该阶段的实现修改完成后立即编辑草案计划文件:在 YAML frontmatter 中将当前阶段待办事项的 status 设为 completed。必须在对计划或代码库进行任何其他后续操作之前完成此项。

评论

支持 Markdown