编写实施计划

概述

撰写全面的实施计划，假设工程师对我们代码库完全零背景，且工程判断力存疑。需详尽记录其完成每项任务所需的一切信息：涉及哪些文件、需编写的代码、需运行的测试、需查阅的文档，以及如何验证功能正确性。将整套计划拆解为粒度精细、可快速执行的任务单元。遵循 DRY（不要重复自己）、YAGNI（除非必要，勿添加功能）、TDD（测试驱动开发）原则，并要求频繁提交（frequent commits）。

假设该工程师是一名经验丰富的开发者，但几乎不了解我们的工具链或业务领域；同时假设其对优秀测试设计的理解较为薄弱。

起始时须声明：“我正在使用 writing-plans 技能生成本实施计划。”

上下文说明：本计划应在专用 worktree 中执行（该 worktree 由 brainstorming 技能创建）。

计划保存路径： docs/plans/YYYY-MM-DD-.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
预期输出：FAIL，错误信息为 “function not defined”

步骤 3：编写最小可行实现

def function(input):
    return expected

步骤 4：运行测试以确认其通过

执行命令：pytest tests/path/test.py::test_name -v
预期输出：PASS

步骤 5：提交变更

git add tests/path/test.py src/path/file.py
git commit -m "feat: add specific feature"

## 注意事项
- 所有文件路径必须精确到具体路径与行号（如适用）
- 计划中须提供完整可运行代码（禁止模糊表述如“添加校验逻辑”）
- 所有命令须精确给出，并注明预期输出
- 引用相关技能时须使用 @ 语法（例如 @subagent-driven-development）
- 始终遵循 DRY、YAGNI、TDD 原则，并保持高频提交

## 执行交接说明

计划生成并保存后，请提供两种执行方式供选择：

**“计划已生成并保存至 `docs/plans/.md`。请选择执行方式：**

**1. 子代理驱动式（当前会话）** —— 我将为每个任务分派独立子代理，任务间插入人工审查环节，支持快速迭代

**2. 并行会话式（新会话）** —— 开启一个全新会话，在 worktree 中运行 executing-plans，批量执行任务并设置检查点

**请选择执行方式？**

**若选择子代理驱动式：**
- **必需子技能：** 使用 superpowers:subagent-driven-development
- 继续保留在当前会话中
- 每个任务均由全新子代理执行 + 人工代码审查

**若选择并行会话式：**
- 引导用户在 worktree 中开启新会话
- **必需子技能：** 新会话须启用 superpowers:executing-plans