writing-plans
starsforks
How to install writing-plans?
blueprintos/analysis-to-delivery/writing-plans
$npx -y skills add BlueprintOS/analysis-to-delivery --skill writing-plans把 spec 拆成可执行计划(每个 ≤ 2h)— 来自 superpowers 体系。本 skill 是桥接层,完整纪律见 <SUPERPOWERS_SKILL_ROOT>/writing-plans/。
SKILL.md
| 1 | # Writing-Plans(桥接到 superpowers) |
| 2 | |
| 3 | ## Contract |
| 4 | |
| 5 | - Inputs: signed design spec, interface/domain model as available |
| 6 | - Outputs: `docs/superpowers/plans/YYYY-MM-DD-<topic>-plan.md` |
| 7 | - Gates: tasks are independently executable and each is no larger than 2 hours |
| 8 | - Required disciplines: `stage-gate` |
| 9 | - Next: `/tdd` |
| 10 | |
| 11 | > **本仓库不维护此 skill 的内容**。完整纪律请读: |
| 12 | > `<SUPERPOWERS_SKILL_ROOT>/writing-plans/SKILL.md` |
| 13 | |
| 14 | ## 何时调 |
| 15 | |
| 16 | - brainstorming / design-an-interface / domain-modeling 之后 |
| 17 | - 需要把 spec 拆成可逐步执行的计划 |
| 18 | |
| 19 | ## 衔接点 |
| 20 | |
| 21 | - **产出**:`docs/superpowers/plans/YYYY-MM-DD-<topic>-plan.md`(含 ≤ 2h 子任务列表) |
| 22 | - **下一步**:`/tdd`(开始红绿循环) |
| 23 | - **门控**:`disciplines/stage-gate` 第 2 层 + 第 3 层(每个子任务) |
| 24 | |
| 25 | ## 降级方案(superpowers 未装时) |
| 26 | |
| 27 | 如果 `<SUPERPOWERS_SKILL_ROOT>/writing-plans/` 不存在,按以下 4 步产出可执行计划: |
| 28 | |
| 29 | ### 1. 拆任务(每个 ≤ 2h) |
| 30 | |
| 31 | 按以下规则拆: |
| 32 | |
| 33 | - **可独立运行**(一个任务完不依赖另一个任务的产物) |
| 34 | - **可独立验证**(每个任务有明确的 PASS 标志) |
| 35 | - **可估时**(≤ 2h,超出则继续拆) |
| 36 | - **依赖关系显式**(用 `Blocked by:` 标注) |
| 37 | |
| 38 | ### 2. 每个任务写 7 件套 |
| 39 | |
| 40 | | 字段 | 例子 | |
| 41 | |---|---| |
| 42 | | Title | "实现 ASN 收货状态机 10→30" | |
| 43 | | Files | `service/AsnReceiveService.java` | |
| 44 | | Test | `AsnReceiveServiceTest#shouldTransitionFrom10To30` | |
| 45 | | Steps | 1. 写 RED 2. 跑确认失败 3. 写实现 4. GREEN 5. 提交 | |
| 46 | | Verify | `mvn test -Dtest=AsnReceiveServiceTest` | |
| 47 | | Blocked by | - | |
| 48 | | Estimate | 1.5h | |
| 49 | |
| 50 | ### 3. 顺序 + 依赖图 |
| 51 | |
| 52 | - **第 1 个任务**:数据模型 / 状态机先建(后面的都依赖) |
| 53 | - **中间任务**:业务逻辑 / 接口契约 |
| 54 | - **最后任务**:联调 / E2E 测试 |
| 55 | |
| 56 | ### 4. 输出 + 签字 |
| 57 | |
| 58 | 写到 `docs/superpowers/plans/YYYY-MM-DD-<topic>-plan.md`,末尾 `## Sign-off` 等用户白名单签字(4 句之一)。 |
| 59 | |
| 60 | ### 最小纪律摘要 |
| 61 | |
| 62 | - **每个任务 ≤ 2h**:超 2h 必须拆(否则 TDD 红绿循环失控) |
| 63 | - **7 件套不能少**:缺 Verify = 不知道什么时候算 PASS |
| 64 | - **依赖写显式**:不写 = 后续乱序执行 |
| 65 | - **第 1 个任务不含集成**:先建地基,再在上面盖楼 |
| 66 | |
| 67 | ### 安装提示 |
| 68 | |
| 69 | ```bash |
| 70 | npx skills@latest add obra/superpowers-writing-plans |
| 71 | ``` |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
