编写实施计划

Verified 中级 Intermediate 流程型 Process claude-code
1 min read · 57 lines

将需求转化为可执行的分步实施计划,动代码前先动脑

编写实施计划

概述

编写全面的实施计划,假设工程师对项目零上下文(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)

保存计划后,提供以下选项:

  1. 子代理驱动(Subagent-Driven,当前会话) - 每个任务使用全新的子代理(subagent),快速迭代
  2. 并行会话(Parallel Session,独立会话) - 批量执行,带检查点(checkpoints)

包含此技能的工作流 Workflows containing this skill

相关技能 Related Skills