名称: plansuite
描述: 统一的规划与执行工作流:创建基于文件的计划(包含子计划),将其冻结为 FINALIZED 状态,并在独立会话中执行,同时记录检查点、进度与发现。适用于需要子计划(里程碑)、受控执行和基于会话实施运行的项目计划。
将“编写计划(含子计划)→ 冻结计划(变更控制)→ 独立会话执行(含检查点)”整合为一个最小可行流程。
task_plan.md:主计划文件(包含子计划/里程碑)progress.md:执行进度(每次推进时更新)findings.md:发现/决策/问题记录(避免重复踩坑)请勿将这三份文件内容直接写入聊天记录:写入文件才能支持恢复/继续执行。
templates/ 目录下的模板创建 task_plan.md、progress.md、findings.md。在 task_plan.md 中输出:
- 背景/目标
- 范围(包括与不包括的内容)
- 风险与回滚方案
- 子计划(里程碑):每个子计划需包含
- 输入/输出
- 验收标准
- 预计的工具调用/文件改动
- 风险与回滚点
仅当用户明确指示“按此计划执行”后:
1. 在 task_plan.md 顶部添加:STATUS: FINALIZED + 时间戳。
2. 将“接下来要执行的子计划编号/名称”写入 progress.md 的 Next 部分。
规则:未标记为 FINALIZED 时,不得进入执行阶段(仅允许进行调查或补充计划)。
进入执行时:
1. 建议使用 sessions_spawn 开启一个隔离的执行会话(避免污染主会话上下文)。
2. 每完成一个子计划:
- 更新 progress.md(Done/Next/Blockers)
- 更新 findings.md(关键决策、遇到的问题、验证命令、回滚步骤)
3. 检查点策略(默认每个子计划至少执行一次):
- 执行前:复述子计划的 DoD、风险与回滚方案
- 执行后:提供验证步骤与结果
若执行中发现原计划不可行:
1. 切勿“边做边改”。先将问题记录至 findings.md,再将变更提案写入 task_plan.md。
2. 将 STATUS 改为 DRAFT,等待用户重新确认。
task_plan.mdprogress.mdfindings.mdtemplates/task_plan.mdtemplates/progress.mdtemplates/findings.md