writing-plans
把已批准的设计/规格拆成 2-5 分钟粒度的 bite-sized 任务计划:每个任务带精确文件路径、完整代码、失败/通过测试步骤与提交指令,配合无占位符硬规则、自检三查和评审子代理模板,专为低上下文执行者(子代理/新人)设计。
仓库:obra/superpowers
热度证据:所属仓库 obra/superpowers 271402 star,Claude Code 官方插件市场可装,社区最火开发方法论
五维评分
热度5/5
质量5/5
创新4/5
易用4/5
文档5/5
优秀点拆解
- 零上下文工程师心智模型 + No Placeholders 负面清单:把 TBD、'add error handling'、'similar to Task N' 等六类内容明确定义为 plan failures,让'计划要写多细'变成可判定的硬规则
- Interfaces 的 Consumes/Produces 契约块:任务间依赖以精确函数签名显式化,实现者只看自己的任务也能对齐相邻任务,支持乱序阅读与并行派发
- Task Right-Sizing 可操作判据:以'reviewer 能否有意义地拒绝此任务而批准其邻居'作为拆分标准,兼顾可审查性与防过度拆分
- TDD 五步法内嵌为每任务标准节拍:写失败测试→验证失败→最小实现→验证通过→提交,每步含具体命令与期望输出,测试先行成为结构性默认
- 两级质量闭环:作者侧 Self-Review 三查(spec 覆盖/占位符扫描/类型一致性)+ 外部评审子代理模板带 Calibration 规则,只报真会影响实现的问题
可复用的设计模式
- 模板即协议:强制 Plan Header(Goal/Architecture/Spec/Global Constraints)+ 固定 Task 结构,保证输出可被下游执行器与评审器解析
- 负面清单比正向要求有效:显式列出'计划失败'模式,为自检与评审提供客观判据
- 任务间接口契约块(Consumes/Produces):以精确签名固化跨任务依赖,适配低上下文执行者与子代理并行
- 技能流水线 handoff:产物存固定路径(docs/superpowers/plans/),末尾给出明确的执行二选一交接话术与 REQUIRED SUB-SKILL 声明
适用场景
有明确 spec/设计文档的多步骤编码任务,动代码前先产出可审查的实现计划把实现委托给低上下文执行者:每任务派发新鲜子代理或交给新人工程师需要中途可审查、可中断、可勾选跟踪进度的团队开发流程强制 TDD 纪律的项目:计划即测试用例清单,每任务自带红-绿-提交循环
边界与注意:计划写作成本高(要求每步带完整代码、零占位符),对探索性/设计未定/单文件小改动属过度工程;spec 质量差则计划质量等比下降,且计划随代码库演化容易过期;默认依赖 superpowers 全家桶(worktree、执行技能、评审技能),单独抽取需自备执行与评审环节。
完整拆解分析文档
本页为摘要版,完整精读分析(核心机制、逐条优秀点拆解、写作过程)见本地 Markdown 文档:
analysis/superpowers-writing-plans.md