/dr-verify 命令 — 三层产物验证
/dr-verify 如何运行三个独立的验证层——确定性 shell 检查、跨模型同行评审和并行子代理——在合规之前暴露发现。
一份看起来完整的 PRD 可能包含无法被证伪的验收标准。一份看似周全的计划可能包含未覆盖任何验收标准的步骤。一份实现报告可能声称完整,却留下一个 AC 项未处理。/dr-verify 在不修改任何文件的情况下检查所有这些。
它是 Datarim 中的独立验证命令——可在流水线的任意节点调用,设计上仅报告发现。不会自动修复任何内容。所有内容都会被标记以供操作员分诊。
三层,最快者优先
架构按成本从低到高运行。第 1 层是确定性 shell 流水线:dr-verify-floor.sh 在无 LLM 参与的情况下运行,以近乎零成本生成结构化 JSONL 发现。如果传入 --floor-only,命令在此停止——适用于速度比深度更重要的合并前健全性检查。
第 2 层是运行时自有的同行评审。其五步原生解析链按顺序检查:显式 CLI 选择、项目配置、用户配置、跨 Claude 家族评审者,最后是隔离的同模型评审者。选定的运行时读取产物并返回结构化发现,标记有提供者和选择它的解析步骤;语义评审不会委托给文档摘要服务。
第 3 层在 Claude 运行时上派发三个并行子代理:评审者、测试者和安全专家。每个都接收自包含的上下文包,并返回标记有其角色的发现。三者同时运行,而非顺序运行。
验证内容
--stage 标志控制范围。阶段 prd 检查 PRD 和任务描述中 AC 覆盖的完整性和可证伪性。阶段 plan 检查每个 AC 是否映射到至少一个计划步骤,以及回滚路径是否明确。阶段 do 检查 QA 报告中未覆盖的 AC 项。阶段 all 运行上述所有内容,外加跨产物漂移检查,查找范围蔓延、规格衰减、执行偏差和孤立需求。
三种裁决及其路由
发现使用产物引用、AC 标准和类别的元组在所有三层之间去重——最先来源的层胜出。然后命令应用裁决逻辑:PASS 表示仅有低严重性发现或无发现;CONDITIONAL 表示至少有一个中严重性发现且无高严重性发现;BLOCKED 表示至少有一个未被丢弃的高严重性发现。
BLOCKED 根据最高严重性发现的类别进行路由。安全发现路由到 /dr-design——安全缺口需要重新设计。正确性发现路由到 /dr-do。完整性发现路由到 /dr-plan 或 /dr-prd。路由目标是最早能够实际解决问题的流水线阶段。
审计日志
每次运行都会在 datarim/qa/verify-{task-id}-{stage}-{iter}.md 生成仅追加的审计日志。写入后,文件会执行 chmod a-w——事后无法修改。修复后的重新运行会获得 -v2、-v3 后缀。先前的日志保持完整,用于审计追踪。
有关完整流水线上下文,请参阅什么是 Datarim。要了解验证通过后会发生什么,请阅读/dr-compliance。