命令 Pipeline

/dr-qa

跨 PRD、设计、计划和代码的穷尽式单遍多层质量验证,并汇总为批量修复

概述

/dr-qa 在 PRD、设计、计划、期望、规范图和代码质量上运行穷尽式单遍审计。首先运行来源门禁:它将被认证的提交记录到 datarim/provenance/{TASK-ID}.sha,并拒绝脏工作区,以便 /dr-compliance 之后能证明它认证的是同一个提交。Step 0 通过后,/dr-qa 绝不会短路于第一个失败的层、期望或子门禁:它在单遍中评估 100% 适用的层和子检查,并将所有阻塞性失败汇总为一个带编号的汇总修复批次([QA-BATCH-1..N]),以便 /dr-do 在一次返工迭代中修复所有差异,而不是 N 次来回循环。

用法

/dr-qa

各层

  1. 第 1 层:PRD 对齐 — 将声明的需求与实现进行比较。标记缺失的功能和范围蔓延。仅在 datarim/prd/*.md 存在时运行。
  2. 第 2 层:设计一致性 — 验证架构决策(ADR)在代码中得到遵守,且所选模式确实被使用。仅在 datarim/creative/*.md 存在时运行。
  3. 第 3 层:计划完整性 — 检查每个计划的实现步骤是否已完成,标记跳过或未计划的步骤。仅在 tasks.md 有实现步骤时运行。
  4. 第 3b 层:期望验证 — 当 datarim/tasks/{TASK-ID}-expectations.md 存在时,对照实现检查每个操作者期望并编写逐项报告;此处 FAIL 会阻塞整体结论。
  5. 第 3c 层:规范图验证 — spec-graph-gate.sh --stage qa 将需求追溯到计划、代码和证据(L1 跳过,L2 建议性,L3-L4 建议性,除非设置硬模式)。
  6. 第 4 层:代码质量 — 始终运行。核心子检查,加上条件门禁:
    • 4a. 测试 — 运行项目测试套件并报告通过/失败/跳过计数
    • 4b. 安全 — 扫描硬编码密钥、暴露的端点、缺失的输入验证、依赖漏洞
    • 4c. 反模式 — 超过 50 行的方法、7 个以上参数、重复代码、缺失错误处理、多余的 console.log 语句
    • 4d. 实时冒烟测试门禁 — 如果更改的代码使用 $queryRaw、raw()、sequelize.query() 或任何绕过 ORM 类型检查器的路径,则针对实际目标数据源的实时冒烟测试是强制性的。模拟/单元测试不满足此门禁。在多数据源项目中,验证注入了正确的客户端。确切的冒烟测试命令、命中的数据源和结果记录在 QA 报告中。无冒烟测试 = 第 4 层结论为 FAIL。
    • 4e. 完成定义 — 从 tasks.md 或 prd/*.md 读取 DoD 并检查每个标准
    • 条件门禁 — 智能体入口接线和实时运行(4d-bis)、证据归因(4d-ter)、基于浏览器的前端 QA(4f)、部署类任务的生产就绪性(4g),以及行为交付任务的测试环境验证(4h)

CLI 智能体退出码模式

许多 CLI 智能体即使 JSON 输出包含 is_error: true 也返回退出码 0。测试与 CLI 智能体的集成时,检查 JSON 中的 is_error/subtype — 不要依赖退出码来判断通过/失败。

参数

无。作用于当前活动任务(通过任务解析确定)。

输出

创建:datarim/qa/qa-report-{task-id}.md,包含逐层结论。

结论

  • PASS — 所有检查满足,无问题
  • PASS_WITH_NOTES — 所有检查满足,有轻微观察但不阻塞
  • FAIL — 一项或多项检查失败,必须处理

总体:ALL_PASS(继续)、CONDITIONAL_PASS(带注释继续)或 BLOCKED(返回 /dr-do,附带完整的汇总修复批次 [QA-BATCH-1..N],包含所有层中发现的所有阻塞性差异,以便 /dr-do 在一次返工迭代中解决 100% 的问题)。

示例会话

> /dr-qa

任务解析:<TASK-ID>(级别 3)

第 1 层:PRD 对齐 — PASS
  8/8 需求已实现
  未检测到范围蔓延

第 2 层:设计一致性 — PASS_WITH_NOTES
  ADR-001(WebSocket):已遵循
  ADR-002(Redis 缓存):已遵循
  注意:添加了连接池(不在设计中,但属于改进)

第 3 层:计划完整性 — PASS
  8/8 步骤已完成
  无跳过步骤

第 4 层:代码质量 — PASS
  4a. 测试:14 通过,0 失败
  4b. 安全问题:0
  4c. 反模式:0
  4d. 冒烟测试:在 auth DB 上 SELECT 1 — OK(1 行)
  4e. DoD:5/5 标准满足

总体:ALL_PASS
报告已保存:datarim/qa/qa-report-<TASK-ID>.md

下一步:/dr-compliance 或 /dr-archive

相关命令

报告结果

在面向人员的更新或结果之前,应用人类结果报告。解释用户可见的结果、原始条件、检查和证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持确切的协议和技术记录完整。如需在不继续工作的情况下再次解释,请使用 /dr-explain。