PlanSuite

将“编写计划（含子计划）→ 冻结计划（变更控制）→ 独立会话执行（带检查点）”整合为一个最小可用流程。

文件结构（在当前工作目录创建/维护）

• - task_plan.md：计划主文件（含子计划/里程碑）
• progress.md：执行进度（每次推进均需记录）
• findings.md：发现/决策/踩坑记录（避免重复犯错）

请勿将这三份文件内容写入聊天：写入文件，方可恢复/续跑。

工作流（强约束，防止偏离）

0) 初始化（首次开展该项目）

1. 1. 若缺少文件：使用模板创建 task_plan.md/progress.md/findings.md（参见 templates/）。
2. 请用户确认目标、范围、约束、完成定义（DoD）。

1) 计划阶段（拆分子计划）

在 task_plan.md 中输出：

• - 背景/目标
• 范围（做/不做）
• 风险 & 回滚方案
• 子计划（里程碑）：每个子计划需包含

- 输入/输出 - 验收标准 - 预计工具调用/文件改动 - 风险与回滚点

2) 冻结阶段（FINALIZED）

仅当用户明确表示“按此计划执行”后：

1. 1. 在 task_plan.md 顶部写入：STATUS: FINALIZED + 时间戳。
2. 将“接下来要执行的子计划编号/名称”写入 progress.md 的 Next。

规则：未 FINALIZED 不得进入执行阶段（最多进行调研/补充计划）。

3) 执行阶段（独立会话 + 检查点）

进入执行时：

1. 1. 建议使用 sessions_spawn 开启一个隔离执行会话（避免污染主会话上下文）。
2. 每完成一个子计划：

- 更新 progress.md（Done/Next/Blockers） - 更新 findings.md（关键决策、踩坑记录、验证命令、回滚步骤）

1. 3. 检查点策略（默认每个子计划至少一次）：

- 执行前：复述子计划的 DoD + 风险 + 回滚方案 - 执行后：提供验证步骤 + 结果

4) 变更控制（计划变更）

若执行中发现计划不可行：

1. 1. 不要“边做边改”。先写入 findings.md，再将变更提案写入 task_plan.md。
2. 将 STATUS 改为 DRAFT，等待用户重新确认。

你在何时使用何文件

• - 需要澄清/拆分任务 → task_plan.md
• 需要告知用户进度/下一步 → progress.md
• 需要记录结论/命令/坑点/回滚 → findings.md

模板

• - templates/task_plan.md
• templates/progress.md
• templates/findings.md