使用 Claude Code 推进实施计划 ― executing-plans
機械翻訳 / Machine-translated
機械翻訳 / Machine-translated
原文：使用 Claude Code 推进实施计划 ― executing-plans（cccskills）
技能页面：executing-plans
本文结论
安装 executing-plans 后，已制定好的实施计划可由 Claude Code 等 Agent 在同一会话中逐任务实现。
它具备在记录测试结果与判断的同时推进到底的机制。
本文介绍处理流程、安装方法、请求示例，以及与 worktree 和相关技能有关的注意事项。
传入已制定好的实施计划后，Agent 会自行逐一实现各任务，直到全部完成。
测试结果与判断也会在推进过程中同步记录。
只需一句话即可发起请求：
请在本次会话中，将 docs/plans/search.md 中的实施计划全部完成。
首先进行的是准备工作。
Agent 会配置 worktree（Git 的多工作区机制），并读取计划。
此阶段还会确认各任务之间的交接是否存在矛盾。
每个任务的流程是：先编写测试并确认失败，再进行实现并确认通过，最后按计划提交。
进度记录中标记为"已完成"的，仅限测试通过的任务。
该行附有提交范围和测试结果。
所有任务完成后，进入整个分支的审查环节。
最终消息包含两部分：判断列表"Rulings I made"和延迟处理的指摘列表"Deferred minors"。
人工需要核查的内容会以汇总形式呈现。
executing-plans 是一项技能，无需另立专职实现 Agent，由当前对话的 Agent 自身来实现计划。
既不设置逐任务的实现角色，也不设置审查角色，审查仅在最后对整个分支进行一次。
作为替代，质量由测试、记录、最终审查三重机制保障。
每个任务的合格线是测试。
先编写测试，亲眼确认失败后再实现，并确认通过。
若测试在实现前就已通过，则视为测试本身存在问题。
计划中每条命令都写有预期输出，Agent 会逐一与实际输出进行比对。
出现不一致时，根据原因分两种处理方式：若是代码问题，使用 systematic-debugging 排查原因；若是计划问题，则记录判断后继续推进。
本技能的方针是：任务之间不询问"可以继续吗"。
计划中的矛盾或模糊之处由 Agent 自行决策。
决策内容、理由及偏离后的影响，均逐行记录，然后继续推进。
需要暂停并向人确认的情况，仅限以下四种：
未记录在案的计划偏离被视为"暗中做出的判断"，因此所有变更必须留有记录。
即使会话被摘要压缩、记忆变淡，也能借助记录文件和 Git 历史继续工作。
已标记为完成的任务不会重做，而是从第一个未完成的任务处续接。
当记录与自身记忆出现矛盾时，以记录和 git log 为准。
记录存放在 Git 管理范围之外的文件夹中，按计划分别创建。
不会触及其他计划的记录。
与 subagent-driven-development 使用相同的存放位置和格式，因此中途切换推进方式也能从同一记录处续接。
最后的收尾工作是对整个分支进行审查。
在可以使用其他 Agent 的环境中，会明确指定能力最强的模型担任审查角色。
无法使用时，由 Agent 自行审查。
此情况下，会在记录和最终报告中注明为自我审查。
指摘按重要程度分类，仅将严重和重要级别的问题集中在一次修正中处理完毕。
每次修正前先编写能复现该指摘的测试，确认失败后再修正。
修正完成后，确认所有测试均通过。
本技能适合以下三种场景：
若希望在每个任务间穿插审查，推荐使用 subagent-driven-development。
计划较长、后半部分任务在摘要后的上下文中运行时，同样适用。
有记录的情况下即使计划较长也能恢复，但越靠后的任务，Agent 的余力越少。
计划足够细致时，实现工作中等能力的模型即可胜任。
最高性能模型仅在最终审查阶段才有必要。
安装方式有两种：执行一行命令，或向 Agent 发送文字请求。
命令使用 npx skills add，可选择 Claude Code、Codex 等目标 Agent。
npx skills add https://github.com/obra/superpowers --skill executing-plans
如需委托 Agent 安装，请直接发送以下文字。
从确认内容到放置文件，均可交由 Agent 完成。
次の Agent Skill をインストールしてください。
https://github.com/obra/superpowers/tree/main/skills/executing-plans
まず SKILL.md と付属ファイルの中身を確認し、不審な処理（外部への送信、認証情報の読み取りなど）がないことを確かめてから、Claude Code なら ~/.claude/skills/executing-plans/、Codex なら ~/.agents/skills/executing-plans/ に配置してください。
存放位置如下表所示：
| Agent | 在所有项目中使用 | 仅在特定项目中使用 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 项目的 .claude/skills/ |
| Codex | ~/.agents/skills/ | 项目的 .agents/skills/ |
发布来源为 GitHub 的 obra/superpowers。
请求只需指定计划文件并简短说明推进方式即可。
请在同一会话中推进此实施计划，并记录每个任务的测试结果。
Agent 从确认 worktree 开始，在确认测试失败与成功的同时，依次实现各任务。
每完成一个任务，进度记录中就会新增一行"已完成"记录。
该行内容为提交范围和测试结果。
请确认进度记录，并从未完成的任务处续接。
首先确认记录第一行是否与同一计划对应。
然后跳过已完成的任务，从第一个未完成的任务继续。
若记录属于其他计划，则不触及该记录，另行创建新记录后开始。
请在所有任务完成后，对整个分支进行审查。
返回结果包括按重要程度分类的审查结果与修正内容。
严重和重要级别的指摘会附带测试修正完毕，轻微指摘则以"Deferred minors"的形式列于最终报告中。
最重要的前提是已有具体的实施计划。
本技能负责执行计划，不承担制定计划的阶段。
计划的各步骤中写有测试和预期输出越详细，推进越顺利。
还需注意，本技能以调用同一仓库的其他技能为前提。
SKILL.md 中明确写明：在第一个任务开始前，必须读取 test-driven-development。
同样，使用 using-git-worktrees 准备 worktree 也是明确规定。
工作目录和审查资料的创建使用 subagent-driven-development 附带的脚本。
最终审查遵循 requesting-code-review 的流程，收尾处理遵循 finishing-a-development-branch 的流程。
不仅是 executing-plans，还需同时安装 superpowers 的相关技能，这是使用前提。
Git 的使用也有若干规定。
在未获得人工明确同意的情况下，不会在 main 或 master 分支上开始实现。
存放记录的文件夹不在 Git 管理范围内，因此执行 git clean -fdx 会被删除。
此情况下，需从 Git 历史中恢复。
许可证为 MIT。
附带文件为 SKILL.md 以及 scripts/task-start、scripts/task-done 两个脚本。
安装前请阅读内容，确认处理逻辑。
executing-plans 前后配套使用的技能，均收录在同一个 superpowers 仓库中。
需要在每个任务间穿插审查或计划较长时，适合使用 subagent-driven-development。
希望降低成本并在同一会话中推进，或无法调用其他 Agent 的环境中，则选择 executing-plans。
两者记录格式相同，也可中途切换。
根据记录文件和 Git 历史，确认已完成的任务后续接。
已标记为完成的任务不会重做。
从没有记录的任务处开始继续。
可以。
Agent 读取审查流程，自行对整个分支进行审查。
此情况下，记录和最终报告中会注明为自我审查，是否合并由人工判断。
不会。
需要暂停确认的情况仅限四种：破坏性操作、涉及安全的操作、向共享分支推送等。
计划中的矛盾由 Agent 自行判断，并将内容记录在案后继续推进。
executing-plans 是一项由 Agent 自身在同一会话中将已制定好的实施计划全部实现完毕的技能。
它先让测试失败再进行实现，并记录判断与进度，因此即使会话中断，也能从未完成的任务处续接。
最后对整个分支进行审查，并输出判断列表和延迟处理的指摘列表。
建议先从任务数量较少的小型计划入手，确认记录与审查的流程。
详细介绍汇总在 cccskills 页面。
本文转载自 cccskills 的文章「使用 Claude Code 推进实施计划 ― executing-plans」。
技能详情与安装方法请参见 cccskills 的 executing-plans 页面。