命令 Pipeline

/dr-verify

独立三层自验证:确定性底层、运行时自有的同行评审,以及原生只读调度

选定的任务文档

自 4.3.3 起,验证器会读取任务描述中的 prd 和 plan 指针,包括显式版本化的 PRD 和计划。选择损坏即为错误;干净的旧版副本不能替代选定的文档。缺少指针时保留现有的旧版及依赖复杂度的行为。期望项 parent_prd 必须指向选定的 PRD。任务标识和允许路径会被检查,但无关的文档元数据和并发写入的原子性不会被认证。

概述

/dr-verify 运行三个仅报告发现的层,从成本最低的开始。第 1 层是确定性 shell 底层。第 2 层是由选定智能体运行时拥有的隔离同行评审。第 3 层是原生只读调度。外部 Coworker 提供者故意不适用于对抗性验证;AC 验证、隐藏缺口发现和语义判断保留在选定的运行时中。

用法

/dr-verify {TASK-ID}                          # 零标志 — 提供者自动解析
/dr-verify {TASK-ID} --stage do
/dr-verify {TASK-ID} --floor-only             # 仅第 1 层,快速合并前门禁
/dr-verify {TASK-ID} --peer-provider sonnet  # 显式运行时自有的同行评审

三个层

  1. 第 1 层:确定性底层 — 运行 dev-tools/dr-verify-floor.sh,一个纯 shell 流水线,执行 AC 覆盖 grep、文件触碰审计、测试存在性解析,以及对 dev-tools/scripts 的 shellcheck。零 LLM 成本;数秒内完成。在 stdout 上输出带有 source_layer: "floor" 的 JSONL 发现。
  2. 第 2 层:运行时自有的同行评审 — 从 CLI、项目配置、用户配置或有界运行时回退中解析 sonnet、haiku、opus 或 none。发现记录 source_layer、提供者、模式和解析来源。任务 ID 传播仍然是可审计成本和结果日志的强制要求。
  3. 第 3 层:原生运行时调度 — 本地运行时上的验证智能体:
    • Claude 路径(规范): 3 个并行只读子智能体(评审者 + 测试者 + 安全)。发现按元组 (artifact_ref, ac_criteria, category) 联合合并并去重;冲突时较高严重性胜出。
    • Codex 路径 [实验性] 回退: 单提示循环,采用规范的对抗性框架。从规范降级 — 在 Codex 上也优先使用第 2 层跨模型覆盖。

同行评审解析(零标志用户体验)

dev-tools/resolve-peer-provider.sh 使用五步、失败关闭的链:

  1. 显式 --peer-provider CLI 值。
  2. 项目 datarim/config.yaml。
  3. 用户 ~/.config/datarim/config.yaml。
  4. Claude 运行时上的跨 Claude 家族 同行评审者 回退。
  5. Codex 上的同模型隔离回退,并带有明确警告。

白名单为 sonnet | haiku | opus | none。未知和外部值会以非零退出,而不是静默更改评审者所有权。

peer_review_mode 分类

  • cross_claude_family — 一个隔离的 Claude 家族检查点评审另一个检查点的输出。
  • same_model_isolated — 隔离的同模型评审,仅用作最后的运行时回退。

Codex 目前使用实验性的同模型隔离路径,并在审计日志中记录该限制。

发现模式

每个发现遵循标准化模式(规范位于 skills/self-verification/SKILL.md § 发现模式):

  • source_layer — 枚举:floor、peer_review、dispatch
  • severity — 枚举:high、medium、low
  • category — 枚举:correctness、completeness、consistency、safety
  • evidence — {type, source, excerpt},其中 type 为 {file_quote, test_output, absent}(absent 自动丢弃)
  • ac_criteria — 发现映射到的 AC 标签数组(可为空)
  • peer_review_provider — 可选,仅第 2 层(提供者名称)
  • peer_review_mode — 可选,仅第 2 层(cross_claude_family 或 same_model_isolated)
  • peer_review_provider_source_layer — 可选,仅第 2 层(cli_flag、per_project_config、per_user_config、fallback_subagent 或 fallback_isolated)
  • check_name — 可选,仅第 1 层(例如 ac_coverage_grep、shellcheck)

JSONL 输出纪律(第 2 层提示)

仅当检查失败或出现新漂移时才输出发现。PASS 即发现的条目(例如 {"check_name":"F001 cleared, no finding"})会被拒绝 — 确认信息应放在最后一行摘要 {cleared_iter1: [...], total_new_findings: N} 中,而不是数组中。保持审计日志信号密集。

判定

  • PASS — 仅有低严重性(或零)未丢弃的发现
  • CONDITIONAL — ≥1 个中等且零个高
  • BLOCKED — ≥1 个高(在解决前阻止合并/归档)

--floor-only 标志

--floor-only 标志在第 1 层短路 — 非常适合 CI 中的快速合并前门禁。数秒内完成,零 LLM 成本,仅在结构/shellcheck 错误问题上阻止。跳过第 2 层和第 3 层。

验证结果标记

在 /dr-archive 时,操作员在归档 frontmatter 中填写 verification_outcome 块(规范模式位于 templates/archive-template.md):caught_by_verify、missed_by_verify、false_positive、n_a、dogfood_window(操作员提供的窗口 ID,用作分组键,而非日期范围)。聚合器 dev-tools/measure-prospective-rate.sh --since <YYYY-MM-DD> 遍历所有 archive-*.md 文件,并为下一个流水线门禁计算带有 decision_hint 的 caught_per_5_tasks。

示例会话(零标志用户体验,无外部 API 密钥)

> /dr-verify {TASK-ID} --stage all --max-iter 2

第 1 层 — 底层:dr-verify-floor.sh --task {TASK-ID} --stage all
  → 2 个发现(中等,安全,check_name=shellcheck)
  → 退出码 0(无高严重性,继续)

第 2 层 — peer_review(运行时自有解析)
  步骤 #1 --peer-provider 标志    → 未设置
  步骤 #2 ./datarim/config.yaml   → 未设置
  步骤 #3 ~/.config/datarim/...   → 未设置
  步骤 #4 跨 Claude 家族          → 匹配(子智能体 peer-reviewer @ sonnet)
  调度 agents/peer-reviewer.md,model=sonnet,隔离上下文
  → 1 个发现(中等,正确性,peer_review_mode=cross_claude_family)

第 3 层 — 调度 runtime=claude
  3 个并行智能体:评审者 / 测试者 / 安全
  → 评审者:1 个发现(完整性)
  → 测试者:0 个发现
  → 安全:0 个发现

聚合:去重后 4 个唯一发现
判定:CONDITIONAL(0 高,4 中)
source_layer_breakdown: {floor: 2, peer_review: 1, dispatch: 1}
peer_review_mode_breakdown: {cross_claude_family: 1}
审计:datarim/qa/verify-{TASK-ID}-all-1.md (chmod a-w)

相关命令

  • /dr-qa — 多层质量验证(不同界面;互补)
  • /dr-archive — 操作员在此填写 verification_outcome 块

报告结果

在面向人员的更新或结果之前,应用 Human Outcome Reporting。解释用户可见的结果、原始条件、检查和证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。若要在不继续工作的情况下再次解释,请使用 /dr-explain。