2026年6月10日

审查代理 — 一次完成 QA 与安全

Datarim 的审查代理如何将代码审查、安全合规检查和完成定义验证整合为单一的 QA 结论。

测试通过是发布的一个必要条件,而非充分条件。测试套件可能全部通过,而实现却悄悄跳过了身份验证检查、违反了项目的错误处理约定,或发布了一个安全审查不会接受的端点。审查代理就是实现与交付之间的检查点,用来捕捉这一差距。

该代理与测试员在同一阶段运行,但视角不同。测试员问的是「代码能否工作」,审查员问的是「这段代码是否可以接受发布」。

它做什么

审查员的工作涵盖三个方面。第一,代码审查:它依据项目的风格指南阅读实现,寻找预示未来维护问题的模式——过于复杂的逻辑、缺失的错误处理、泄漏内部细节的抽象。第二,安全合规:它依据安全技能的检查清单检查实现,寻找未验证的输入、代码中的凭据或缺失的访问控制等问题。第三,完成定义验证:它阅读任务的 DoD 标准,并确认每一项都已满足,而非推断。

结论不是摘要——而是一个路由决策。干净通过会将任务向前推进——复杂任务进入合规阶段,简单任务直接归档。有条件通过会列出任务推进前需要更改的内容。阻塞结论绝不会在第一个失败处停下:审查员会在所有适用的层、预期和子检查中完成一次穷尽式单遍审计,将 100% 的阻塞性差异汇总为一个带编号的合并修复批次([QA-BATCH-1..N]),并将任务路由回去,使 /dr-do 在单次返工迭代中解决每一项。

一个具体示例

某个实现添加了一个文件上传端点。测试通过。审查员依据安全检查清单阅读实现,注意到文件类型验证仅发生在扩展名上,而非文件内容上。这被标记为安全发现,结论为 BLOCKED,任务被路由回 /dr-do,并附有需要更改内容的具体描述。开发者添加了内容类型检查;审查员在下一个周期通过。

它位于何处

审查员在 /dr-qa 运行,与测试员代理并行。它运行在可用的最强模型上,因为生产中遗漏安全问题的代价超过仔细审查的代价。它产生的路由——通过、有条件或阻塞——决定流水线中接下来发生什么。

在审查员参考卡上查看完整的代理名册,或阅读Datarim 是什么以了解更大的图景。