技能 Quality

测试环境验证

强制门禁:在准备生产或归档之前,自主在测试环境(后端 + 前端)上验证变更。会阻止 /dr-qa、/dr-compliance、/dr-archive。

规则

当项目空间拥有测试环境时,变更必须在准备生产部署或归档之前在测试环境上完成验证——后端和前端都要验证。验证以自主方式完成:智能体自行发现测试环境、将变更部署到该环境、执行验证并记录结果,无需询问操作者是否要测试。每个任务都问一句“我们在测试环境上测过了吗?”正是本门禁要消除的失败模式。

与 prod-readiness-probe 的区别

本门禁与 prod-readiness-probe 并行运行,但检查的内容不同:prod-readiness-probe 检查运行器对称性(测试↔生产的 sudoers/PATH/端口)——生产环境能否接受这次部署。本门禁检查已部署测试构建上的功能行为——变更在真实环境上端到端是否真的可用。对于在拥有测试环境的项目中交付运行时行为的任务,两者都必须在生产准备/归档之前通过。

启用时机

当以下两个条件同时成立时启用:(1) 变更交付运行时行为(代码、配置、迁移——而非仅文档或仅框架),且 (2) 项目空间声明了测试环境或可发现测试环境。解析链:空间注册表 spaces/<space>/space.yml → test_environments[](权威来源),然后是 CI 启发式(一个 deploy:test 作业,由指定测试主机的分支推送触发)。两者均未找到 ⇒ 判定为 NO-TEST-ENV——记录在案,不算通过。仅文档/仅框架/基础设施清单类任务 ⇒ 判定为 SKIP。

自主流程

  1. 解析测试环境并记录解析来源。
  2. 交付变更:通过项目自身的 deploy:test CI 作业——集成到触发该作业的分支(通常是 dev)。当功能分支从 main 切出而 dev 已远远领先时,仅将本任务的提交 cherry-pick 到基于 origin/dev 的临时工作树上——绝不做功能分支→dev 的盲目合并。轮询 CI 直到通过。
  3. 验证后端:健康检查端点 + 至少一次触及变更路径的行为调用。当测试环境可能变更真实外部系统时,优先使用安全模式(dry_run、只读路径)。
  4. 验证前端:加载受影响的页面/流程并确认其渲染/行为正常。如果测试环境的认证受阻,则回退到已部署包检查 + 来自 /dr-qa 第 4f 层的组件/实时渲染 Playwright 运行——不得静默跳过。
  5. 记录所有内容到 ### Layer 4h — Test-Environment Verification 下。

判定

PASS(后端和前端均已验证,行为确认),PASS_WITH_NOTES(已验证,但记录了环境限制),SKIP(无运行时行为),NO-TEST-ENV(未注册/不可发现),FAIL(未交付到测试环境,或已损坏)。FAIL 是硬性阻断,会路由回 /dr-do 或部署步骤;SKIP / NO-TEST-ENV 从不阻断,但会原样记录。

/dr-auto 模式

在 DATARIM_AUTO_MODE=1 下,门禁无需询问即可运行——“我应该在测试环境上测试吗?”已预先解析为是。唯一允许的操作者升级是硬门禁的边界操作(生产部署,或无安全模式等效项的可计费/破坏性外部操作);其余一切自主进行并记录日志。