编写实施计划
概述
编写全面的实施计划,假设工程师对项目零上下文(zero context)。记录一切:要修改哪些文件、代码、测试、需要查阅的文档、如何测试。将整个计划拆分为小粒度任务(bite-sized tasks)。遵循 DRY(Don't Repeat Yourself,不要重复自己)、YAGNI(You Aren't Gonna Need It,不要过度设计)、TDD(Test-Driven Development,测试驱动开发)原则,频繁提交(commits)。
小粒度任务的颗粒度
每一步都是一个单一操作(2-5 分钟):
- "编写失败的测试" - 一步
- "运行测试确认它失败" - 一步
- "实现最少量的代码" - 一步
- "运行测试" - 一步
- "提交(Commit)" - 一步
计划文档头部
每个计划必须以以下内容开头:
# [功能名称] 实施计划
> **给 Claude 的提示:** 必需的子技能:使用 executing-plans 来逐任务实施此计划。
**目标:** [一句话描述]
**架构:** [2-3 句话描述]
**技术栈(Tech Stack):** [关键技术]
任务结构
每个任务包含:
- 文件: 创建/修改/测试的确切路径
- 步骤 1: 编写失败的测试(附代码)
- 步骤 2: 运行测试验证其失败(附命令 + 预期输出)
- 步骤 3: 编写最少量的实现代码(附代码)
- 步骤 4: 运行测试验证其通过
- 步骤 5: 提交(Commit)
注意事项
- 始终使用确切的文件路径
- 计划中包含完整代码(不要写"添加验证"这样的模糊描述)
- 提供确切的命令及预期输出
- 遵循 DRY、YAGNI、TDD 原则,频繁提交
执行交接(Execution Handoff)
保存计划后,提供以下选项:
- 子代理驱动(Subagent-Driven,当前会话) - 每个任务使用全新的子代理(subagent),快速迭代
- 并行会话(Parallel Session,独立会话) - 批量执行,带检查点(checkpoints)