writing-plans

# 编写计划 ## 概述 编写全面的实施计划，假设工程师对我们的代码库毫无了解且品味存疑。记录他们需要知道的一切：每个任务要触及的文件、代码、测试、他们可能需要查看的文档、如何测试它。将整个计划作为小块任务交给他们。DRY（不要重复自己）。YAGNI（你不会需要它）。TDD（测试驱动开发）。频繁提交。 假设他们是一名熟练的开发人员，但对我们的工具集或问题领域几乎一无所知。假设他们不太了解良好的测试设计。 **开始时宣布：** “我正在使用 writing-plans 技能来创建实施计划。” **上下文：** 这应该在专用的 worktree 中运行（由头脑风暴技能创建）。 **计划保存至：** `docs/plans/YYYY-MM-DD-.md` ## 小块任务粒度 **每一步是一个动作（2-5 分钟）：** - “编写失败的测试” - 步骤 - “运行它以确保它失败” - 步骤 - “实现最少代码以使测试通过” - 步骤 - “运行测试并确保它们通过” - 步骤 - “提交” - 步骤 ## 计划文档标题 **每个计划必须以该标题开头：** markdown # [功能名称] 实施计划 > **对于 Claude：** 所需子技能：使用 superpowers:executing-plans 来逐任务执行此计划。 **目标：** [一句话描述构建的内容] **架构：** [2-3 句话关于方法] **技术栈：** [关键技术/库] --- ## 任务结构 markdown ### 任务 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 步：编写最小实现** python def function(input): return expected **第 4 步：运行测试以验证其通过** 运行：`pytest tests/path/test.py::test_name -v` 预期：通过 **第 5 步：提交** bash git add tests/path/test.py src/path/file.py git commit -m "feat: add specific feature" ## 记住 - 始终使用精确的文件路径 - 计划中包含完整代码（不要只写“添加验证”） - 包含带有预期输出的精确命令 - 使用 @ 语法引用相关技能 - DRY, YAGNI, TDD, 频繁提交 ## 执行移交 保存计划后，提供执行选择： **"Pla