技能 Reference

V-AC 轴拆分

模式指引 — 当验证-AC 组同时混合确定性轴(规则匹配)与统计轴(窗口内比率阈值)时,预先拆分为两组。

概述

验证-AC 组不得将按不变规则通过的检查与按观测比率通过的检查混在一起。这两个轴回答的是不同问题;将它们混合会在质量评审步骤产生虚假的信心。

模式

当单个组同时包含确定性条目(例如「schema 匹配 XSD」、「HTTP 状态为 200」)和统计条目(例如「p99 延迟低于 500 ms」、「一小时内错误率低于 1 %」)时,在最终确定 wishlist 之前拆分为两个独立的组。

为何拆分

确定性与统计有效性依赖不同的证据链。将基于比率的准则与基于规则的检查归为一组,会掩盖确定性轴始终通过、而统计轴才是真正不确定性来源这一事实。

如何应用

  1. 将每个条目标记为确定性(无歧义规则)或统计性(窗口内阈值)。
  2. 若两个轴共存,拆分为确定性组和统计组。
  3. 统计条目必须注明测量窗口、样本量和置信区间。
  4. 确定性条目必须绑定到 spec-runner 断言或等效的单调检查。
  5. 拆分条目时,保留或重新分配每个 Covers:、Verifies: 和 Evidence: 绑定,使自动 spec 图保持完整。

模式 2:门控激活试运行

当任务交付新的验证器门控,或将某个门控从建议性改为硬失败时,/dr-plan 会在其 --scope 上以试运行方式执行该门控,并列出每个失败文件。每个文件要么在任务内重写,要么通过有记录的豁免从范围中移除 — 绝不推迟,否则门控会拒绝激活它的那个归档。

模式 3:阈值门控

阈值门控(弃权、置信度截断、速率限制器)获得两个条目:一个确定性条目证明它读取正确字段并应用正确常量(单元测试),一个统计条目证明结果比率落在有记录的区间内(在代表性样本上运行 eval 或影子脚本)。