2026年7月26日

规格可追溯性毕业:从独立命令到自动流水线层

/dr-spec 已退役。同一个将每项需求追溯到其证据的图验证器,现在会自动运行于 /dr-prd、/dr-plan、/dr-do、/dr-qa 和 /dr-compliance 内部——无需额外步骤,无需单独调用。

Datarim 2.58.0 退役了独立的 /dr-spec 命令,并将其引擎——spec-graph-gate.sh——提升为嵌入五个流水线阶段的自动层。如果你以前使用过 /dr-spec,你不会失去任何东西:同一个验证器现在会在每个生成或消费规格产物的阶段为你静默运行。

规格可追溯性做什么

其核心是,规格可追溯性回答一个问题:每项需求都有证据吗?它从任务已经产生的四个产物构建一个有向图:

wish_id → D-REQ → V-AC → plan-step → evidence

这条链中的每个节点都是流水线已经生成的具体产物:PRD 中的验收愿望、派生需求(D-REQ-NN)、可验证的验收标准(V-AC-NN)、实现它的计划步骤,以及证明该步骤有效的证据——测试、测量、文件。图验证器检查每个愿望都被覆盖、每个标准都被追溯、每个步骤都有证据。没有并行的规格树,没有第二条流水线,没有外部依赖。

历程:独立 → 自动层

规格可追溯性在 v2.42.0 中作为 /dr-spec 落地,这是一个独立的只读验证命令。你在某个阶段之后手动调用它来检查需求图。它有效,但增加了一个步骤——而你必须记住的步骤,有时就是你会跳过的步骤。

第一个月的使用反馈很明确:验证器足够有价值,应该每次都运行,而不仅仅是在有人记得调用它时。在 v2.58.0(<TASK-ID>)中,/dr-spec 被退役,其引擎——spec-graph-gate.sh——被直接接入生成或消费规格产物的流水线阶段:

  • /dr-prd — 验证每个愿望都有可追溯的标识符和覆盖断言。
  • /dr-plan — 验证每个验收标准都映射到计划步骤。
  • /dr-do — 验证每个完成的步骤都带有证据(实现期间为建议性,因为证据仍在累积)。
  • /dr-qa — 在归档前端到端验证完整图。
  • /dr-compliance — 验证在加固期间没有需求被丢弃。

/dr-verify 确定性底线通过同一个门适配器继承同一个图——其 Layer 1 发现带有 check_name: "dr-spec-lint:<rule>" 来源,与之前保持不变。

什么变了,什么没变

变了:调用界面。你不再输入 /dr-spec {TASK-ID}。图检查在其阶段完成时自动运行——它是阶段的一部分,而不是阶段之后的单独命令。

没变:其他一切。基于共享规则注册表的四个纯 shell 验证器是相同的文件:

  • dev-tools/dr-spec-lint.sh — 核心图验证器,命名规则,支持 --scope git-diff。
  • dev-tools/dr-trace.sh — 覆盖桶:已覆盖 / 未覆盖 / 悬空 / 孤立 / 延迟。
  • dev-tools/dr-lint.sh — 伞形外观,具有规则注册表内省和失败关闭的强制规则守卫。
  • dev-tools/dr-spec-grade.sh — 仅计算投影,从不手工编辑,从不影响路由。
  • dev-tools/dr-spec-rules.yaml — 规则集的唯一真相来源。

所有五个共享相同的契约:--format json、退出码 0/1/2,以及配置错误的规则集是配置错误(退出码 2),绝不是静默的“0 违规”。建议优先的推出方式(试运行 → 基线 → 建议窗口 → 硬门)保持不变。

为什么自动层是正确的界面

独立验证命令存在可发现性问题:你必须知道它存在、记得运行它,并记得何时运行它。自动层解决了所有三个问题:

  • 可发现性 — 如果你运行流水线,你就会得到检查。无需额外知识。
  • 一致性 — 每个阶段运行与其产物相关的检查。你不可能忘记验证计划,因为计划阶段会自我验证。
  • 正确性 — 检查在正确的时刻、针对正确的产物、以正确的范围运行。手动命令运行得太早或太晚可能会遗漏或对进行中的更改产生误报。

成本为零:图验证器是纯 shell,在典型任务上运行时间不到一秒,其发现使用与所有其他流水线检查相同的严重性分类和路由。如果你已经在手动运行 /dr-spec,唯一的区别是你不再需要这样做。

命令数量:27

随着 /dr-spec 退役,Datarim 提供 27 个命令:25 个 /dr-* 流水线和实用命令,加上 2 个独立斜杠命令(/factcheck 和 /humanize)。自动层从界面上移除了一个命令,但保留——并强化——了其功能。查看变更日志了解完整的 v2.58.0 条目。