核心用法
PlanSuite 是一种文件驱动的项目管理方法论,将传统"边想边做"的混乱模式转化为可恢复、可审计的标准化流程。
三个阶段
- 计划阶段:在
task_plan.md中拆解任务为子计划(里程碑),明确定义输入/输出、验收标准(DoD)、风险与回滚点 - 冻结阶段:用户确认后标记
STATUS: FINALIZED,建立变更控制基线,防止执行中随意改计划 - 执行阶段:建议用隔离会话运行,每完成子计划更新
progress.md(进度)和findings.md(决策/坑点/验证命令)
关键约束
- 未 FINALIZED 不得进入执行(最多补充调研)
- 执行中计划不成立时,必须先记录到
findings.md,再提案变更,经用户确认后重新冻结 - 默认每个子计划设置检查点:执行前复述 DoD+风险+回滚,执行后给出验证步骤
显著优点
- 会话可恢复:进度写进文件,随时断点续跑
- 防止上下文污染:推荐隔离会话执行复杂子计划
- 变更可控:冻结机制强制暂停,避免"边做边改"导致的范围蔓延
- 知识沉淀:
findings.md形成项目记忆,减少重复踩坑
潜在局限
- 启动成本高:简单任务可能显得繁琐
- 依赖用户配合:冻结/变更控制需用户主动确认,流程可能阻塞
- 模板维护负担:多项目并行时需管理多组
task_plan/progress/findings文件 - 无自动化集成:检查点、进度更新需手动执行
适合人群
- 需多会话协作的复杂项目(如多模块开发、调研报告、系统迁移)
- 对"可审计性"有要求的场景(需向第三方展示决策过程)
- 容易"跑偏"的用户或模型(结构化流程强制纠偏)
常规风险
- 文件冲突:多代理同时写入可能覆盖进度
- 冻结僵化:紧急修复时变更流程可能延误时机
- 模板误用:子计划拆分过细导致管理开销大于执行收益