用途
writing-plans 是一个用于编写实施计划的技能，使用时机为：当你已经拥有某个多步骤任务的规格说明或需求，并且尚未开始接触代码时。它帮助你把需求转化为一份详尽、可逐步执行的实施计划。
主要能力
该技能的核心是生成一份“全面”的实施计划，其前提假设是执行计划的工程师对我们的代码库零上下文、品味存疑。因此计划需要记录执行者需要知道的一切：每个任务要改动哪些文件、代码内容、可能需要查阅的测试与文档、以及如何测试。
计划以“细粒度任务（bite-sized tasks）”的形式给出，并遵循以下原则：DRY、YAGNI、TDD、频繁提交。
技能还要求假设执行者是一位熟练的开发者，但几乎不了解我们的工具链或问题领域，并且不太懂良好的测试设计。
使用方式
开始时需要声明：“I'm using the writing-plans skill to create the implementation plan.”
该技能应在专用的 worktree 中运行（由 brainstorming 技能创建）。
计划保存路径为：docs/plans/YYYY-MM-DD-<feature-name>.md
细粒度任务拆分
每个步骤是一个动作（2-5 分钟），例如：
- “编写失败的测试”——一个步骤
- “运行它以确保失败”——一个步骤
- “实现最小代码使测试通过”——一个步骤
- “运行测试并确保通过”——一个步骤
- “提交”——一个步骤
计划文档头部
每份计划必须以如下头部开始：
[Feature Name] Implementation Plan
For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
Goal: [One sentence describing what this builds]
Architecture: [2-3 sentences about approach]
Tech Stack: [Key technologies/libraries]
任务结构
Task N: [Component Name]
Files:
- Create:
exact/path/to/file.py - Modify:
exact/path/to/existing.py:123-145 - Test:
tests/exact/path/to/test.py
Step 1: Write the failing test
def test_specific_behavior():
result = function(input)
assert result == expected
Step 2: Run test to verify it fails
Run: pytest tests/path/test.py::test_name -v Expected: FAIL with "function not defined"
Step 3: Write minimal implementation
def function(input):
return expected
Step 4: Run test to verify it passes
Run: pytest tests/path/test.py::test_name -v Expected: PASS
Step 5: Commit
git add tests/path/test.py src/path/file.py git commit -m "feat: add specific feature"
要点提醒
- 始终使用精确的文件路径
- 计划中包含完整代码（而不是“添加校验”这类描述）
- 使用精确命令并给出预期输出
- 用 @ 语法引用相关技能
- DRY、YAGNI、TDD、频繁提交
执行交接
保存计划后，提供执行方式选择：
“Plan complete and saved to docs/plans/<filename>.md. Two execution options:
1. Subagent-Driven (this session) - I dispatch fresh subagent per task, review between tasks, fast iteration
2. Parallel Session (separate) - Open new session with executing-plans, batch execution with checkpoints
Which approach?”
如果选择 Subagent-Driven：
- REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development
- 留在当前会话
- 每个任务使用全新子代理 + 代码审查
如果选择 Parallel Session：
- 引导他们在 worktree 中打开新会话
- REQUIRED SUB-SKILL: 新会话使用 superpowers:executing-plans
适用场景
适用于已有规格说明或需求、需要为多步骤任务编写实施计划、且尚未开始写代码的阶段。特别适合需要把复杂功能拆解为可逐步执行、可测试、可提交的细粒度任务的场景。
限制
资料未提供关于收费、价格、平台支持范围、具体效果等方面的信息。该技能依赖 brainstorming 技能创建专用 worktree，并引用 superpowers:executing-plans 与 superpowers:subagent-driven-development 等子技能。