用途:/plan-pipeline:validate 用于在执行前独立校验 /plan-pipeline:start 生成的实施计划,本身不写任何代码。设计上校验与规划分离,避免校验者被计划假设锚定。前置条件:docs/plans/plan-{name}.md 已提交;若存在多个计划,会列出并询问校验哪一个。
第一层结构校验(无需智能体,立即执行):检查必需章节(Summary、Decisions、Architecture、Tasks、Test Plan、Out of Scope);每个任务是否含描述、涉及文件、验收标准、层级归属;依赖链是否有环、高层任务是否只依赖低层、依赖是否存在;用 Glob 确认待改文件真实存在、新文件目录是否符合约定;计划决策是否与 ADR 及 docs/adr/ 一致;是否遵守 CLAUDE.md 硬规则与第一性原理;测试覆盖是否完整、TDD 任务是否先写失败测试。问题按 BLOCKER/WARNING/INFO 记录。
第二层专家评审:按客观触发规则自动选择智能体并并行启动(Task 工具,run_in_background: true),包括 security-reviewer、db-migration-reviewer、performance-reviewer、design-system-reviewer、ux-reviewer、cross-platform-reviewer、native-app-reviewer、integration-reviewer,各自使用 Opus 或 Sonnet。每个智能体接收计划文件、相关 ADR 与领域问题,返回结构化 FINDING(严重级别、位置、问题、风险、建议)。通过 Read 读取输出路径监控进度(TaskOutput 已在 v2.1.278 移除)。
自动修复:合并两层问题为单一列表,逐条分诊。A 类可自动解决(匹配已有 ADR、PATTERNS.md 模式或 CLAUDE.md 第一性原理规则);B 类需人工输入(新架构问题、ADR 冲突、无解 BLOCKER),会说明原因、给出选项并等待决策,决策记入计划 Decisions 章节,必要时新建 ADR。所有问题分诊后批量应用修复、更新并提交计划。问题记录在 docs/plans/metrics/{name}.json 的 validation.issues 中。
自动衔接:若全部为 A 类自动解决,直接自动启动 /plan-pipeline:execute;若涉及人工输入,则先询问“All issues resolved. Ready to execute?”。
用法:/plan-pipeline:validate 自动选取最近未提交的计划,或 /plan-pipeline:validate plan-user-authentication 指定计划。建议在任何 /plan-pipeline:execute 前运行。资料称校验成本约 $0.20-3.00。
限制:需已提交计划文件;依赖 ADR、PATTERNS.md、CLAUDE.md 等既有约定;B 类问题必须人工决策;具体平台与安装方式资料未提供。