executing-plans

执行计划

概览

加载计划，进行严格审查，分批执行任务，并在每批之间提交报告以供审查。

核心原则： 分批执行，并设置检查点供架构师审查。

开始时宣布：“我正在使用执行计划技能来实施此计划。”

流程

第 1 步：加载并审查计划

计划目录格式（.claude/plans/<plan-id>/）：

1. 阅读编排计划 plan.md 和清单 manifest.json
2. 对于当前批次中的每项任务，阅读其说明文件 briefings/task-NN.md
3. 只加载当前批次的说明文件（默认 3 个），不要一次性加载所有任务
4. 严格审查，找出计划中的疑问或顾虑
5. 如果有顾虑：开始前与人类搭档沟通
6. 如果没有顾虑：创建 TodoWrite 并继续

旧版单体格式（docs/plans/*.md）：

1. 直接阅读计划文件
2. 按照下方相同的审查和分批流程执行

格式检测： 如果路径包含 manifest.json 或指向一个目录，则使用计划目录格式。如果路径指向 .md 文件，则使用旧版格式。如果未提供路径，检查 .claude/plans/ 中最新的目录；若无，则检查 docs/plans/ 中最新的 .md 文件。

第 2 步：执行批次

默认：前 3 项任务

对于每项任务：

1. 标记为进行中
2. 严格遵循每个步骤（说明文件中的步骤都很精简）
3. 按说明文件中的成功标准运行验证
4. 标记为已完成

第 3 步：报告

批次完成后：

• 展示已实现的内容
• 展示验证输出
• 说：“可以反馈了。”

第 4 步：继续

根据反馈：

• 如有需要，进行修改
• 执行下一批任务（加载下一批任务的说明文件）
• 重复以上流程，直至完成

第 5 步：完成开发

所有任务均已完成并通过验证后：

1. 如果使用计划目录格式，进行清理：
   • 可选择将执行记录写入 .claude/plans/<plan-id>/summary.md
   • 删除计划目录：rm -rf .claude/plans/<plan-id>/
   • 如果删除失败，发出警告，但不要因此阻塞
2. 宣布：“我正在使用 git-workflow 技能来完成这项工作。”
3. 必需的子技能： 使用 git-workflow 技能栈
4. 按照该技能验证测试、提供选项并执行所选方案

护栏

遇到阻塞时停止并询问，不要猜测。完整的停止条件和检查清单请参阅 references/guardrails.md。

集成

必需的工作流技能：

• git-workflow - 必需：使用 worktrees 创建隔离的工作区，并使用 stack 完成开发
• writing-plans - 创建此技能要执行的计划