用途:GSD Path 的规划阶段,派发一个规划器、校验其产物,并取得唯一一次批准以授权构建。仅在用户显式调用 $gsd-path-plan 或处于活动流程时使用。
主要能力:生成 <track>/plan/PLAN.md 与每个任务一个 <track>/tasks/T###-slug.md;校验任务 id 唯一、波次对应 ## Wave N、依赖存在且无环、同波次文件不重叠;要求任务含 Context、Approach、可观测验收标准、可失败的 Verify 命令、Interface contract、Intent coverage 与 Log;要求每波有 Review depth(full/deep/verify-only),涉及认证、授权、支付、数据迁移或并发的波次必须 full 或 deep;支持 quick、milestone、patch、Lookahead 等模式。
使用方式:前置要求 .project/STATE.md 含 pipeline: gsd-path/v2,且存在 INTENT.md(普通模式还需 research/SYNTHESIS.md)。通过 pipeline_state.py transition 进入 plan/active,再按运行时派发契约派发逻辑任务名 plan。Git 仓库运行 python3 <workflow_run.py> gate-plan --repo <repo root>;批准时运行 python3 <pipeline_state.py> approve --repo <root> --kind plan --project-dir <.project 或 .project/next> --expected-head <HEAD>,非 Git 或 new-github 用 --defer-checkpoint。
限制:不得直接编辑 STATE;规划失败仅允许一轮修订,仍失败则置 plan/blocked 并停止;批准后不得再增设批准门;缺失事实(如具体模型 slug、价格)暂未提供。