my-super-powers-planning-flow

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 级。
• 用户明确要求先看方案。
• 任务跨文件、跨模块，或存在关键决策尚未确认。

核心规则

1. 先按 AGENTS.md 确认是否允许进入方案阶段。
2. 方案必须覆盖目标、范围、风险点、验证方式、非目标。
3. 方案与计划写入 Docs/Plans/ 或用户指定位置。
4. 不写入 docs/superpowers/specs/ 或 docs/superpowers/plans/。
5. 计划文档必须先写出整体迭代总览，再展开当前迭代。
6. 计划中必须先给出推荐推进方向或推荐方案，不能等执行后才补推荐。
7. 计划执行时必须先定义当前迭代目标，再拆当前迭代内部步骤。
8. 一个迭代可以拆多个步骤，但不能在未收口前自动推进到下一个迭代。
9. 计划文档成稿后，必须先停在“等待用户确认计划”，不得自动开始第一次迭代。
10. 当前迭代完成后，必须先验证、写日志、等用户确认，再进入下一迭代。
11. 写入 Docs/Plans/ 的计划文件与写入 Docs/IterationLogs/ 的日志文件，文件名都必须带 YYYY-MM-DD- 年月日前缀。

推荐动作

• M 级：先给最小方案，确认后再补简洁计划。
• L 级：先拆功能点，给多个方案选项，再形成分步计划。
• S 级：通常不启用本技能，除非用户明确要求先出方案。
• 方案或计划成稿后，先按 plan-review.md 做一次自检，再进入用户确认或执行。
• 计划成稿后先请求用户确认整体迭代计划；只有确认后才定义并启动第一次迭代。

计划粒度

• 计划开头应显式给出“整体迭代总览”。
• 每个计划迭代至少要写清目标、顺序和收口条件。
• 计划中应显式写出“推荐推进方向”或“推荐方案”。
• 计划中应显式标出“当前迭代目标”。
• 当前迭代下可以列出多个步骤。
• 当前迭代只是整体迭代计划中的一部分，不能代替整体迭代总览。
• 下一迭代只能在当前迭代完成验证、写完日志并获用户确认后开始。

文档落点

• 计划：Docs/Plans/
• 若需要写阶段入口或当前重点：同步更新 Docs/Current/
• 若当前迭代完成需要留痕：在 Docs/IterationLogs/ 下新增独立日志文件，不能只回写到计划文档