不可变性
适用于所有流水线阶段的不可变性契约:产物冻结、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 工作。