PlanSuite

核心用法

PlanSuite 是一套基于 Markdown 文件的项目规划与执行管理框架，将复杂项目拆解为可追踪的标准化流程：

1. 计划阶段：在 task_plan.md 中定义项目背景、范围、风险及子计划（里程碑），每个子计划明确输入输出、验收标准、预计改动和风险回滚点
2. 冻结阶段：用户确认后标记 STATUS: FINALIZED，建立变更控制基线
3. 执行阶段：建议隔离会话执行，每完成子计划更新 progress.md 进度和 findings.md 关键发现
4. 变更控制：发现计划偏差时先记录再提案，将状态切回 DRAFT 待重新确认

显著优点

• 状态机清晰：FINALIZED/DRAFT 双状态强制防止"边做边改"的混乱
• 会话隔离：推荐 sessions_spawn 独立执行，避免污染主上下文
• 知识沉淀：findings.md 强制记录坑点与决策，形成可复用组织记忆
• 零依赖：纯 Markdown 模板，无需安装任何工具

潜在局限

• 无自动化集成：不提供 CI/CD 钩子或自动检查点，依赖人工更新进度
• 模板简陋：基础 Markdown 结构，大型团队可能需要扩展字段（如负责人、工时估算）
• 协作盲区：无并发锁机制，多人同时编辑文件可能产生冲突

适合人群

• 独立开发者管理 2-4 周中型项目
• 需要可审计执行轨迹的技术调研任务
• 对"计划漂移"敏感、追求结构化交付的工程师

常规风险

• 过度规划陷阱：新手可能在 task_plan.md 阶段消耗过多时间，建议首轮迭代采用"骨架计划+快速冻结"策略
• 文件同步遗漏：执行会话若崩溃，需手动核对 progress.md 与实际完成状态的一致性
• 变更疲劳：频繁触发 DRAFT→FINALIZED 循环可能降低流程严肃性，建议设定每日最多 1 次变更配额

核心用法

PlanSuite 是一套"计划-冻结-执行"分离的项目管理工作流，核心在于用文件状态机强制约束流程阶段，防止"边想边做"导致的范围蔓延。

三阶段工作流：

• 计划阶段：在 task_plan.md 中拆解主计划与子计划（里程碑），每个子计划需定义输入输出、验收标准、风险回滚点
• 冻结阶段：用户明确确认后写入 STATUS: FINALIZED 与时间戳，计划进入不可变状态，同时向 progress.md 写入首个执行目标
• 执行阶段：建议通过 sessions_spawn 开启隔离会话，每完成一个子计划更新 progress.md（Done/Next/Blockers）与 findings.md（决策/踩坑/回滚步骤）

三文件协作机制：

• task_plan.md：计划唯一真相源，变更需降级为 DRAFT 状态重新确认
• progress.md：会话间可恢复的执行状态，支持断点续跑
• findings.md：知识沉淀，避免重复踩坑

显著优点

1. 状态机防漂移：FINALIZED/DRAFT 状态强制阻断"边做边改"的本能冲动
2. 会话隔离：推荐 sessions_spawn 执行，避免主会话上下文污染
3. 可恢复性：文件化进度使长周期任务能跨会话续跑
4. 子计划粒度：里程碑级拆解自带验收标准，降低"做到哪算哪"风险

潜在缺点与局限

• 流程 overhead 高：简单任务可能"杀鸡用牛刀"
• 依赖用户纪律：状态机需用户主动遵守，无强制技术约束
• 无自动回滚：风险回滚步骤需人工执行，非自动化机制
• 模板简陋：三文件模板需用户自行丰富字段说明

适合人群

• 需要运行数小时/跨多会话的复杂开发任务
• 团队场景下需交接执行上下文的协作项目
• 对"范围蔓延"有创伤后应激障碍的焦虑型 PM

常规风险

• 用户可能跳过 FINALIZED 直接执行（习惯对抗）
• findings.md 若维护不善会成为僵尸文档
• 过度规划导致启动延迟（"分析瘫痪"）