writing-plans

Writing Plans - 实现计划编写指南

技能概述

Writing Plans 是一个用于编写全面技术实现计划的技能，帮助开发者在接触代码前创建详细的、可执行的分步实施指南。

适用场景

多步骤功能开发

当你有明确的功能规格或需求文档，需要将复杂功能拆解为可执行的编码任务时使用。适用于假设工程师对代码库零背景、需要详尽指导的场景。

团队知识共享

当需要为团队成员（特别是新成员）或 AI 助手提供完整的实现路线图时，该技能确保每个步骤都有明确文件路径、代码示例和验证命令。

TDD 驱动开发

遵循测试驱动开发原则时，使用该技能创建包含完整测试-实现循环的计划，确保每个任务都有明确的验证步骤。

核心功能

小颗粒度任务分解

将复杂开发任务拆解为 2-5 分钟可完成的单个步骤，每个步骤包含具体代码、命令和预期结果，确保开发者可以逐步推进并频繁提交。

零上下文实现指南

假设开发者熟悉编程但对当前工具集和问题域几乎不了解，计划包含确切的文件路径、完整代码片段、测试命令和相关文档引用。

结构化计划文档

生成包含目标概述、架构说明、技术栈和分步任务的标准格式计划文档，保存为 docs/plans/YYYY-MM-DD-<feature-name>.md，便于版本控制和团队协作。

常见问题

实现计划应该在什么时候编写？

在你开始编写任何代码之前，一旦有了明确的功能规格或需求文档就应该编写实现计划。该技能建议在独立的工作树（worktree）中进行规划，确保不影响当前工作区。

一个计划步骤应该包含哪些内容？

每个步骤应该是一个单一明确的行动（约 2-5 分钟完成），包括：具体的文件路径、完整的代码（不是"添加验证"这样的描述）、精确的命令及其预期输出。典型的 TDD 步骤包括：编写失败测试、运行测试确认失败、编写最小实现、运行测试确认通过、提交代码。

实现计划编写完成后如何执行？

计划保存后有两种执行方式：Subagent-Driven（在当前会话中按任务分派子代理执行并审查）或 Parallel Session（在独立会话中使用 executing-plans 批量执行）。第一种方式适合快速迭代和审查，第二种方式适合批量执行带检查点的计划。