2026年6月25日

/dr-qa 命令 — 四层验证

了解 /dr-qa 如何按顺序检查 PRD 对齐、设计一致性、计划完整性、操作者期望和代码质量——在允许任何内容归档之前。

代码能编译并不等于代码能正常工作。/dr-qa 命令是实现与归档之间的验证关卡。它运行四层检查——每层相互独立,各有自己的判定——只有当汇总结果达到标准时才继续推进。

该命令读取上游产生的每一个产物:PRD、设计文档、实现计划、操作者期望以及代码本身。每一层都是有条件的:只有当对应的产物存在时才会运行。没有 PRD 的任务跳过第 1 层;没有设计文档的任务跳过第 2 层。每个已执行层的判定汇入总体结果。

它做什么

第 1 层检查 PRD 对齐。每一条陈述的需求都会与实现进行比对。缺失的功能——PRD 中列出但未构建的内容——会被标记。范围蔓延——构建了但 PRD 中没有的内容——也会被标记。两者都是明确的发现,而非观察。

第 2 层检查设计一致性。创意文件中记录的架构决策会与实际代码进行比对。偏差会被识别并评估:它是改进还是回归?该层不假定偏差就是错误的,但要求它们被承认,而不是被忽视。

第 3 层检查计划完整性。实现计划中的每一步都会被核实为已完成、已跳过或已修改。跳过的步骤会评估风险。计划外的添加会被列出。第 3b 层在存在期望文件时运行,与操作者的原始意图联系最为直接。期望文件中的每个愿望都会使用捕获该愿望时定义的成功标准,对照实现进行评估。每个愿望的判定会写回期望文件,命令会运行验证脚本以确认汇总状态。

第 4 层检查代码质量:运行测试套件、扫描安全问题、检查反模式(例如超过 50 行的方法或异步操作缺少错误处理),并验证每一条完成定义标准。当变更文件包含前端标记时,会运行一次 Playwright 流程,以捕获运行中界面的截图和跟踪记录。

一个具体示例

一个实现按租户限流的任务在实现完成后到达 /dr-qa。第 1 层发现 PRD 要求返回带有 Retry-After 头的 HTTP 429 响应——而实现中缺少该头。第 1 层判定:FAIL。由于第 1 层是最早失败的层,总体判定为 BLOCKED,路由指回 /dr-do,聚焦于缺失的头。其他层仍会运行并记录,但最早的失败决定了返回目标。修复并重新运行后,所有层通过,任务推进到 /dr-compliance。

它在流水线中的位置

对于 Level 3 和 Level 4 任务,该命令在 /dr-do 之后运行。Level 1 和 Level 2 任务可以跳过它,直接进入归档。QA 报告写入 datarim/qa/ 并作为审计线索保留。如果修复后重新运行该命令,新报告会获得版本后缀,而不是覆盖之前的报告。

当总体判定为 ALL_PASS 或 CONDITIONAL_PASS 时,流水线路由到 /dr-compliance 进行归档前的最终加固。当判定为 BLOCKED 时,/dr-qa 绝不会在第一个失败的检查处短路:它会在单次运行中完整执行所有适用的层和验证器,将 100% 发现的差异汇总为单个 Consolidated Remediation Batch,并路由到最早失败的阶段——第 1 层到 /dr-prd;第 2 层到 /dr-design;第 3 层到 /dr-plan;第 3b 层和第 4 层回到 /dr-do——因此所有发现都在一次返工迭代中解决,而不是每轮修复一个错误。

在什么是 Datarim中了解更多关于完整流水线的信息,或回到/dr-do 命令中描述的实现阶段。