PlanSuite

核心用法

PlanSuite 是一套计划-执行分离的文件驱动工作流，专为需要严格变更控制的多阶段项目设计。用户通过三段式操作管理任务：

1. 计划阶段：在 task_plan.md 中拆解背景、范围、风险及子计划（里程碑），每个子计划需定义输入输出、验收标准、预计改动及回滚方案；
2. 冻结阶段：用户确认后标记 STATUS: FINALIZED，锁定计划内容，防止执行期随意变更；
3. 执行阶段：建议使用独立会话（sessions_spawn）推进，每完成子计划更新 progress.md 进度，关键决策与踩坑记录至 findings.md，每个子计划前后设置检查点验证。

显著优点

• 会话隔离：执行与会话分离，避免上下文污染，支持随时中断续跑；
• 变更受控：计划变更必须显式回退至 DRAFT 状态并重新确认，防止"边做边改"的混乱；
• 知识沉淀：findings.md 强制记录决策依据与回滚命令，形成可复用的项目资产；
• 模板化启动：提供标准模板降低启动成本。

潜在缺点与局限性

• overhead 较高：简单任务（如单次脚本编写）使用此流程显得冗余；
• 依赖用户配合：冻结与变更控制需用户主动确认，自动化程度受限；
• 文件冲突风险：多会话同时写入同一文件可能产生冲突（未内置锁机制）；
• 无内置可视化：进度追踪依赖 Markdown 文本，无甘特图等图形化呈现。

适合人群

• 需要跨多次对话完成的复杂项目（如系统重构、多模块开发）；
• 团队协作场景，需留痕审计与交接；
• 对"计划稳定性"有强诉求的谨慎型用户。

常规风险

• 计划僵化风险：过度冻结可能导致无法响应真实执行中的新信息；
• 文件管理负担：三文件分散存储，长期项目需定期归档清理；
• 执行会话漂移：若未严格执行 sessions_spawn，主会话上下文膨胀可能影响后续交互质量。

核心用法

PlanSuite 是一套文件驱动的项目规划与执行工作流，将传统「计划→执行→复盘」拆解为可冻结、可恢复、可审计的会话化流程：

1. 计划阶段：在 task_plan.md 中拆解背景、范围、风险，并将大目标拆分为带输入/输出、验收标准、回滚点的子计划（里程碑）；
2. 冻结阶段：用户确认后写入 STATUS: FINALIZED，锁定基线，防止执行中随意变更；
3. 执行阶段：建议通过独立会话（如 sessions_spawn）运行，每完成子计划即更新 progress.md（进度/阻塞）与 findings.md（决策/踩坑/回滚命令）；
4. 变更控制：若计划不成立，必须回退至 DRAFT 状态，经用户重新确认后方可继续。

显著优点

• 会话隔离：主会话保上下文，执行会话保纯净，防止长对话污染；
• 变更可追溯：FINALIZED/DRAFT 状态机 + 三文件分离，确保「计划变更」是显式决策而非隐性漂移；
• 零工具依赖：纯 Markdown，任何编辑器/版本控制均可接管；
• 抗中断恢复：文件即状态，随时可续跑。

潜在缺点与局限性

• 学习成本：需理解「冻结」与「变更控制」的严格语义，新手易误操作；
• 无自动化触发：依赖用户显式指令推进状态机，无法自动感知代码完成；
• 无协作锁：多用户同时编辑 Markdown 时可能产生冲突（需外部 Git 等解决）；
• 适合复杂度阈值：简单任务（<3 步骤）用此工具反而 overhead 过高。

适合人群

• 需要结构化交付的软件开发、研究、咨询项目；
• 多会话、长周期、易中断的异步工作流；
• 对「计划基线」有强合规或审计需求的团队。

常规风险

• 状态机误用：用户可能在 FINALIZED 后仍期望灵活调整，导致认知冲突；
• 文件路径污染：若工作目录管理不当，三文件可能与其他项目文档混淆；
• 回滚点形同虚设：子计划若未设计可验证的 rollback 命令，findings.md 中的回滚步骤可能无法执行。