技能 Core

不可变性

适用于所有流水线阶段的不可变性契约:产物冻结、V-AC 对等、非代码对等、反同义反复规则,以及返回源头的转换。

概述

本技能为每个 Datarim 流水线阶段定义了不可变性契约。某个阶段产出的产物不得为了迁就下游阶段发现的约束而被削弱。当真实约束导致产物无法满足时,返回源头转换提供了正式的修订路径。

基础:契约式设计(Meyer,1986)——前置条件和后置条件是不可协商的规格。ADR(Nygard,2011)——已接受的决策不可变;变更通过取代而非编辑来完成。配置管理(IEEE 828-2012)——基线只能通过正式的变更控制来改变。

加载

由每个流水线命令(/dr-prd、/dr-plan、/dr-design、/dr-do、/dr-qa、/dr-compliance)以及架构师和开发者代理加载。通用部分和通用规则始终加载;各阶段片段由消费命令按条件加载。前端 UI 任务还会额外加载前端 UI 片段。

通用规则

验收与证据循环

每个任务(包括快速任务和非代码工作)在执行前都定义可证伪的验收用例。契约位于 datarim/tasks/{TASK-ID}-acceptance.json(范围、工作流路线、标准与用例,每个用例绑定到所选路线的一个阶段),其仅追加的证据包位于 datarim/qa/{TASK-ID}-evidence.json。在实现之前,dev-tools/check-live-evidence.sh --stage preflight 记录前置状态;随后每个阶段追加一次尝试,包含 git 修订、契约与范围摘要以及逐用例结果,并在给出结论前使用各自的 --stage 运行同一检查器。退出码 1 表示 BLOCKED;缺失、过期、失败、跳过或仅模拟的实时证据永远不会变为绿色。一次更正会使后续评审失效,必须重新验证。在没有基线的情况下恢复的遗留任务在存在新证据之前处于 UNCERTIFIED 状态。

产物不可变性规则

当出现以下情况时,产物即被「削弱」:某项需求(V-AC、D-REQ)被放宽;某项设计决策在没有新的创意文档的情况下被悄然推翻;某项测试或验证命令被放宽以使失败的交付物通过;某个检查清单项的完成标准被收窄;某项 QA 标准被重新界定范围以规避失败;某项合规检查被跳过或降级;或在没有操作员差异评审的情况下替换了视觉基线。

只有两种响应是有效的:修复下游工作(产物是正确的,工作是错误的),或认识到产物规定了错误的契约——这会触发返回源头转换。

V-AC 对等规则

每个阶段的 V-AC 行都受同样的不可变性约束。用于验证交付物的 V-AC 不得被改为更弱的检查,以使交付物在未满足原始标准的情况下通过。这将 TDD 纪律中的 V-AC 对等规则扩展到所有流水线阶段。

非代码对等规则

对于非代码任务,待办事项/检查清单就是「测试」。检查清单项的完成标准不得被削弱——「检查清单范围缩减」就是削弱 V-AC 断言在非代码场景下的等价物。

反同义反复规则

验证标准必须是可证伪的。无论实现状态如何都始终通过的标准是同义反复,必须被移除或重新界定范围。示例:「检查文件是否存在」(如果实现创建了该文件,则始终通过)、「检查变量 X 为真值」(如果测试运行器初始化了它,则始终通过)。

返回源头转换

触发条件。 一个真实阻塞项,确实需要更改不可变产物——不是实现难度(永远不是有效理由),而是发现的约束:不可能的前置条件、错误的规格层级、新理解的需求,或使原始契约失效的上游 API 变更。

由谁决定。 阶段执行者不能单独决定。升级给操作员,并附上 (a) 原始产物文本的逐字内容,(b) 必须更改的具体原因,(c) 提议的新文本。

记录位置。 在 datarim/tasks/{TASK-ID}-task-description.md § Decisions 中,携带产物 id、逐字原文、原因、逐字提议以及路由目标。记录必须在更改产物之前写入。

阶段如何恢复。 在操作员批准修订且上游阶段更新或重新发布其产物后,执行者恢复工作。下一步建议必须路由到拥有该不可变产物的阶段,而不是继续当前阶段。

路由表

  • PRD V-AC / D-REQ → 由 /dr-prd 拥有 → 路由到 /dr-prd
  • 计划 V-AC / 实现步骤 → 由 /dr-plan 拥有 → 路由到 /dr-plan
  • 设计决策(创意文档)→ 由 /dr-design 拥有 → 路由到 /dr-design
  • 测试 / V-AC 验证命令 → 由 /dr-do 拥有(记录在计划中)→ 路由到 /dr-plan
  • QA 标准 / 层级结构 → 由 /dr-qa 拥有 → 路由到 /dr-qa
  • 合规检查清单项 → 由 /dr-compliance 拥有 → 路由到 /dr-qa 以重新验证
  • 视觉基线(前端)→ 由 /dr-do 拥有并经操作员签核 → 路由到 /dr-do

这不是什么

  • 不是实现难度的逃生通道。
  • 不是没有证据的事后合理化。
  • 不是单独决策——需要操作员评审。

各阶段片段

每个片段由拥有该阶段的命令按条件加载,并定义该阶段的不可变产物、其取代路径以及该阶段特有的不可变性规则。片段适用于 /dr-prd、/dr-plan、/dr-design、/dr-do、/dr-qa、/dr-compliance 以及前端 UI 工作。