设计完成后为无代码库上下文的工程师编写逐任务实施计划…

当设计已完成、需要给几乎不了解代码库的工程师一份可直接逐任务执行的详细实施计划时使用。

适用场景

解决思路

1. 开始时宣布：“我正在使用 Writing Plans 技能创建实施计划。”
2. 在专用 worktree 中运行该流程（由 brainstorming skill 创建）。
3. 把计划保存到 `docs/plans/YYYY-MM-DD-<feature-name>.md`。
4. 写计划时假设执行工程师对代码库零上下文，且品味存疑。
5. 假设执行工程师是熟练开发者，但几乎不了解本工具集或问题域。
6. 假设执行工程师不太懂良好的测试设计。
7. 在计划中记录执行者需要知道的一切：每个任务要改动哪些文件、代码、测试、可能需要查看的文档、如何测试。
8. 把整个计划作为小块任务交付。
9. 遵循 DRY。
10. 遵循 YAGNI。
11. 遵循 TDD。
12. 频繁提交。
13. 让每个步骤只做一个动作，控制在 2-5 分钟。
14. 按 TDD 步骤拆任务：编写失败测试。
15. 运行该测试，确认失败。
16. 实现最小代码使测试通过。
17. 运行测试，确认通过。
18. 提交。
19. 每个计划必须以 header 开头：`# [Feature Name] Implementation Plan`。
20. header 中写：`> **For Claude:** Use `${SUPERPOWERS_SKILLS_ROOT}/skills/collaboration/executing-plans/SKILL.md` to implement this plan task-by-task.`。
21. header 中写：`**Goal:** [One sentence describing what this builds]`。
22. header 中写：`**Architecture:** [2-3 sentences about approach]`。
23. header 中写：`**Tech Stack:** [Key technologies/libraries]`。
24. header 末尾加 `---`。
25. 每个任务按模板结构写：`### Task N: [Component Name]`。
26. 任务中列出 Files：`Create:` 精确路径、`Modify:` 精确路径、`Test:` 精确路径。
27. 任务 Step 1 写失败测试，给出具体测试代码。
28. 任务 Step 2 运行测试确认失败，写精确命令和预期失败信息，例如 `pytest tests/path/test.py::test_name -v`，预期 `FAIL with "function not defined"`。
29. 任务 Step 3 写最小实现，给出完整代码。
30. 任务 Step 4 运行测试确认通过，写精确命令和预期 `PASS`。
31. 任务 Step 5 提交，写 `git add tests/path/test.py src/path/file.py` 和 `git commit -m "feat: add specific feature"`。
32. 始终使用精确文件路径。
33. 计划中包含完整代码，不要写“添加验证”这类模糊描述。
34. 写精确命令及预期输出。
35. 用 @ 语法引用相关 skills。
36. 保存计划后，告知计划已完成并保存到 `docs/plans/<filename>.md`。
37. 提供执行选项 1：Subagent-Driven (this session) - 我每个任务派发新 subagent，任务之间 review，快速迭代。
38. 提供执行选项 2：Parallel Session (separate) - 打开新会话使用 executing-plans，批量执行并设置检查点。
39. 询问选择哪种方式。
40. 如果选择 Subagent-Driven：使用 `skills/collaboration/subagent-driven-development`。
41. 如果选择 Subagent-Driven：留在当前会话。
42. 如果选择 Subagent-Driven：每个任务派发新鲜 subagent，并在任务之间做 code review。
43. 如果选择 Parallel Session：引导用户在新 worktree 中打开新会话。
44. 如果选择 Parallel Session：新会话使用 `skills/collaboration/executing-plans`。

适用边界 · 注意事项

• 设计尚未完成时。
• 执行工程师已充分了解代码库且只需要高层任务拆分时。
• 无法使用 Claude/Superpowers 技能环境（`${SUPERPOWERS_SKILLS_ROOT}`、subagent、`executing-plans` 等）时。