name: writing-plansdescription: “Use when you have a spec or requirements for a multi-step task, before touching code”risk: criticalsource: communitydate_added: “2026-02-27”编写计划概述编写全面的实施计划假设工程师对我们的代码库零上下文且品味存疑。记录他们需要知道的一切每个任务要接触哪些文件、代码、测试、可能需要查看的文档、如何测试。把整个计划作为一口大小的任务交给他们。DRY。YAGNI。TDD。频繁提交。假设他们是有经验的开发者但对我们的工具集或问题领域几乎一无所知。假设他们对好的测试设计了解不多。开始时声明“我正在使用 writing-plans 技能创建实施计划。”**上下文**这应该在专用的 worktree 中运行由 brainstorming 技能创建。计划保存到docs/plans/YYYY-MM-DD-feature-name.md一口大小任务的粒度每个步骤是一个动作2-5 分钟“编写失败的测试” - 步骤“运行它确保失败” - 步骤“实现让测试通过的最少代码” - 步骤“运行测试确保通过” - 步骤“提交” - 步骤计划文档头每个计划必须以这个头部开始# [功能名称] 实施计划 **给 Claude** 必需子技能使用 superpowers:executing-plans 逐任务实施此计划。 **目标** [一句话描述这构建了什么] **架构** [2-3 句关于方法] **技术栈** [关键技术/库] ---任务结构### 任务 N[组件名称] **文件** - 创建exact/path/to/file.py - 修改exact/path/to/existing.py:123-145 - 测试tests/exact/path/to/test.py **步骤 1编写失败的测试** python def test_specific_behavior(): result function(input) assert result expected步骤 2运行测试验证它失败运行pytest tests/path/test.py::test_name -v预期失败提示 “function not defined”步骤 3编写最小实现deffunction(input):returnexpected步骤 4运行测试验证它通过运行pytest tests/path/test.py::test_name -v预期通过步骤 5提交gitaddtests/path/test.py src/path/file.pygitcommit-mfeat: add specific feature## 记住 - 始终使用精确文件路径 - 计划中包含完整代码而不是添加校验 - 精确命令并带预期输出 - 使用 语法引用相关技能 - DRY、YAGNI、TDD、频繁提交 ## 执行交接 保存计划后提供执行选择 **计划已完成并保存到 docs/plans/filename.md。两种执行方式** **1. 子代理驱动本会话** - 我为每个任务分派全新子代理任务间审查快速迭代 **2. 并行会话单独** - 用 executing-plans 打开新会话带检查点的批量执行 **选择哪种方式** **如果选择子代理驱动** - **必需子技能** 使用 superpowers:subagent-driven-development - 留在本会话 - 每个任务全新子代理 代码审查 **如果选择并行会话** - 引导他们在 worktree 中打开新会话 - **必需子技能** 新会话使用 superpowers:executing-plans ## 使用时机 本技能适用于执行概述中描述的工作流或操作。 ## 局限性 - 仅当任务明确匹配上述范围时使用本技能。 - 不要将输出视为环境特定验证、测试或专家审查的替代品。 - 如果缺少所需输入、权限、安全边界或成功标准请停下来询问澄清。