PlanSuite

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

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

• task_plan.md：计划主文件（含子计划/里程碑）
• progress.md：执行进度（每次推进都要写）
• findings.md：发现/决策/坑点（避免重复踩坑）

不要把这三份写到聊天里：写到文件，才能恢复/续跑。

工作流（强约束，防跑偏）

0) 初始化（第一次做这个项目）

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

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

在task_plan.md里输出：

• 背景/目标
• 范围（做/不做）
• 风险 & 回滚
• Milestones: Each milestone should include
  • Input/Output
  • Acceptance Criteria
  • Estimated Tool Calls/File Changes
  • Risks and Rollback Points

2) Finalization Phase (FINALIZED)

Only after the user explicitly says "Execute according to this plan":

1. At thetop of task_plan.mdwrite:STATUS: FINALIZED+ timestamp.
2. Write the "Next milestone number/name to be executed" intoprogress.md'sNextsection.

Rule: Execution phase is not allowed unless FINALIZED (at most investigation/supplemental planning can be done).

3) Execution Phase (Independent Session + Checkpoints)

When entering execution:

1. It is recommended to usesessions_spawnto open an isolated execution session (to avoid contaminating the main session context).
2. Upon completing each milestone:
   • Updateprogress.md（已完成/下一步/阻塞项）
   • 更新findings.md（关键决策、踩坑、验证命令、回滚步骤）
3. 检查点策略（默认每个子计划至少一次）：
   • 执行前：复述子计划的 DoD + 风险 + 回滚
   • 执行后：给出验证步骤 + 结果

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

如果执行中发现计划不成立：

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