| 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
