用途:在实施前对已完成的计划做一次关键问题访谈式验证,把每个含假设的决策、每个需保留的关键行为都交由用户确认,防止未声明的假设悄悄进入代码。
主要能力:先判定计划类型(bugfix/feature/migration/refactor/other),据此决定问题类别权重;读取 plan.md 与全部 phase-*.md,标记决策点、假设、风险与取舍;按 8 类主题(架构、假设、取舍、风险、范围、新技术/库、测试规格、保留性)提取问题;每题给出 2-4 个具体选项并标注推荐项;以直接向用户提问的方式完成访谈(每次不超过 4 题);最后把结果写入 plan.md 的 ## Validation Summary。
使用方式:通过 $plan-validate 调用。计划路径取自 $ARGUMENTS 或 ## Plan Context,找不到时询问用户或先运行 $plan。问题数量范围(如 3-8)与 mode 来自 ## Plan Context,作为硬约束。若计划引入新依赖,需追问是否评估过替代方案。
适用场景:计划评审、实施前确认、bugfix 计划的保留性核查等。
限制:必须真实访谈用户,不得自行代答;仅询问影响实施的真实选择;bugfix 类计划必须触发保留性问题,回答“不确定”时返回 BLOCKED 并建议先运行 $plan;只向 plan.md 追加 Validation Summary,绝不修改 phase 文件;步骤须按声明顺序执行,跳过或合并需用户明确批准;任务跟踪与证据(file:line 或可追溯证据)为强制要求。具体配置项、命令与平台细节以仓库资料为准,其余暂未提供。