gsd-plan-phase 是 gsd-core 中的规划命令,负责为指定阶段生成详细的 PLAN.md,并走“研究(如需要)→ 计划 → 验证 → 完成”的默认流程。它充当编排器:解析参数、校验阶段、按需研究领域、调用 gsd-planner、用 gsd-plan-checker 验证,并在通过或达到最大迭代次数前反复迭代,最后呈现结果。
用法与主要标志:--research 强制重新研究;--skip-research 跳过研究直接规划;--gaps 缺口闭合模式(读取 VERIFICATION.md,跳过研究);--skip-verify 跳过验证循环;--prd <file> 用 PRD/验收标准文件替代 discuss-phase;--ingest <path-or-glob> 用 ADR 文件替代 discuss-phase,--ingest-format 可覆盖 ADR 解析格式;--reviews 依据 REVIEWS.md 的跨 AI 评审反馈重新规划;--text 使用纯文本编号列表,远程会话必需;--mvp 在默认 tracer-first 排序上做 MVP 增强,可在 ROADMAP.md 持久化为 Mode: mvp;--no-tracer 放弃默认的 tracer-first 分解,改为水平分层规划;--no-reversibility-gates 抑制单向门决策的人工检查点。
研究专用模式 --research-phase <N>:调用 gsd-phase-researcher 为第 N 阶段生成 RESEARCH.md 后退出,不进入规划器;适用于跨阶段研究、方案确定前的文档审阅,以及“只改研究不改计划”的循环。无标志时若 RESEARCH.md 已存在会自动使用并提示后退出;--research 强制刷新;--view 仅打印现有 RESEARCH.md,不存在则报错。
限制:TUI 提问在 VS Code Copilot 中需改用 vscode_askquestions;具体参数取值、依赖环境、版本要求与安装方式官方资料暂未提供。