| name | my-super-powers-planning-flow |
| description | Use when a task in this project needs a clearer proposal or implementation plan while keeping all documents inside the project's Docs system. |
MySuperPowers Planning Flow
概述
本技能用于把外部 brainstorming 与 writing-plans 的长处，转译为本项目可接受的方案与计划流程。
何时使用
- 当前任务被判定为 M 级或 L 级。
- 用户明确要求先看方案。
- 任务跨文件、跨模块，或存在关键决策尚未确认。
核心规则
- 先按
AGENTS.md 确认是否允许进入方案阶段。
- 方案必须覆盖目标、范围、风险点、验证方式、非目标。
- 方案与计划写入
Docs/Plans/ 或用户指定位置。
- 不写入
docs/superpowers/specs/ 或 docs/superpowers/plans/。
- 计划文档必须先写出整体迭代总览，再展开当前迭代。
- 计划中必须先给出推荐推进方向或推荐方案，不能等执行后才补推荐。
- 计划执行时必须先定义当前迭代目标，再拆当前迭代内部步骤。
- 一个迭代可以拆多个步骤，但不能在未收口前自动推进到下一个迭代。
- 计划文档成稿后，必须先停在“等待用户确认计划”，不得自动开始第一次迭代。
- 当前迭代完成后，必须先验证、写日志、等用户确认，再进入下一迭代。
- 写入
Docs/Plans/ 的计划文件与写入 Docs/IterationLogs/ 的日志文件，文件名都必须带 YYYY-MM-DD- 年月日前缀。
推荐动作
- M 级：先给最小方案，确认后再补简洁计划。
- L 级：先拆功能点，给多个方案选项，再形成分步计划。
- S 级：通常不启用本技能，除非用户明确要求先出方案。
- 方案或计划成稿后，先按
plan-review.md 做一次自检，再进入用户确认或执行。
- 计划成稿后先请求用户确认整体迭代计划；只有确认后才定义并启动第一次迭代。
计划粒度
- 计划开头应显式给出“整体迭代总览”。
- 每个计划迭代至少要写清目标、顺序和收口条件。
- 计划中应显式写出“推荐推进方向”或“推荐方案”。
- 计划中应显式标出“当前迭代目标”。
- 当前迭代下可以列出多个步骤。
- 当前迭代只是整体迭代计划中的一部分，不能代替整体迭代总览。
- 下一迭代只能在当前迭代完成验证、写完日志并获用户确认后开始。
文档落点
- 计划：
Docs/Plans/
- 若需要写阶段入口或当前重点：同步更新
Docs/Current/
- 若当前迭代完成需要留痕：在
Docs/IterationLogs/ 下新增独立日志文件，不能只回写到计划文档
