/writing-plans

name: writing-plans
description: 把 spec 拆成可执行计划(每个 ≤ 2h)— 来自 superpowers 体系。本 skill 是桥接层,完整纪律见 <SUPERPOWERS_SKILL_ROOT>/writing-plans/。
version: 4.0.0

Writing-Plans(桥接到 superpowers)

Contract

• Inputs: signed design spec, interface/domain model as available
• Outputs: `docs/superpowers/plans/YYYY-MM-DD-<topic>-plan.md`
• Gates: tasks are independently executable and each is no larger than 2 hours
• Required disciplines: `stage-gate`
• Next: `/tdd`

> **本仓库不维护此 skill 的内容**。完整纪律请读: > `<SUPERPOWERS_SKILL_ROOT>/writing-plans/SKILL.md`

何时调

• brainstorming / design-an-interface / domain-modeling 之后
• 需要把 spec 拆成可逐步执行的计划

衔接点

• **产出**:`docs/superpowers/plans/YYYY-MM-DD-<topic>-plan.md`(含 ≤ 2h 子任务列表)
• **下一步**:`/tdd`(开始红绿循环)
• **门控**:`disciplines/stage-gate` 第 2 层 + 第 3 层(每个子任务)

降级方案(superpowers 未装时)

如果 `<SUPERPOWERS_SKILL_ROOT>/writing-plans/` 不存在,按以下 4 步产出可执行计划:

1. 拆任务(每个 ≤ 2h)

按以下规则拆:

• **可独立运行**(一个任务完不依赖另一个任务的产物)
• **可独立验证**(每个任务有明确的 PASS 标志)
• **可估时**(≤ 2h,超出则继续拆)
• **依赖关系显式**(用 `Blocked by:` 标注)

2. 每个任务写 7 件套

| 字段 | 例子 | |---|---| | Title | "实现 ASN 收货状态机 10→30" | | Files | `service/AsnReceiveService.java` | | Test | `AsnReceiveServiceTest#shouldTransitionFrom10To30` | | Steps | 1. 写 RED 2. 跑确认失败 3. 写实现 4. GREEN 5. 提交 | | Verify | `mvn test -Dtest=AsnReceiveServiceTest` | | Blocked by | - | | Estimate | 1.5h |

3. 顺序 + 依赖图

• **第 1 个任务**:数据模型 / 状态机先建(后面的都依赖)
• **中间任务**:业务逻辑 / 接口契约
• **最后任务**:联调 / E2E 测试

4. 输出 + 签字

写到 `docs/superpowers/plans/YYYY-MM-DD-<topic>-plan.md`,末尾 `## Sign-off` 等用户白名单签字(4 句之一)。

最小纪律摘要

• **每个任务 ≤ 2h**:超 2h 必须拆(否则 TDD 红绿循环失控)
• **7 件套不能少**:缺 Verify = 不知道什么时候算 PASS
• **依赖写显式**:不写 = 后续乱序执行
• **第 1 个任务不含集成**:先建地基,再在上面盖楼

安装提示

npx skills@latest add obra/superpowers-writing-plans