2026年8月20日

requesting-code-review 技能——一个没有对话历史的审查者

Datarim 的 requesting-code-review 技能会派发一个隔离的审查者 agent,它只能看到 diff 和需求——看不到作者的思考过程。这种隔离正是关键所在。

一个 agent 审查自己的工作,会带着塑造原始实现的所有假设。requesting-code-review 技能通过派发一个独立的审查者 agent 来解决这个问题,该 agent 的上下文被精确限定:只有 diff、需求,以及编写会话中其他任何内容都不包含。

该技能的核心原则很直接:尽早审查,经常审查。审查者会拿到 git SHA 范围(BASE_SHA 到 HEAD_SHA)、对构建内容的简要描述,以及指向计划或需求的指针。它不会拿到对话历史、走过的弯路,或导致所做选择的推理过程。

何时请求审查

有三个时刻是强制性的:在子 agent 驱动开发中每完成一个任务后、完成一个主要功能后,以及合并到主分支之前。该技能还列出了可选的触发条件——当卡住时、在重构之前作为基线检查、修复复杂 bug 之后。强制性清单之所以存在,是因为在多任务流水线中,累积才是真正的风险:在任务 2 发现的问题只需一次修复;同样的问题在任务 7 才发现,则需要在建立于其上的所有内容中进行重构。

审查者如何被派发

该技能使用位于 requesting-code-review/code-reviewer.md 的模板文件,其中有四个占位符:描述、计划或需求引用、基础 SHA 和头部 SHA。运行时用于生成隔离 agent 的任何机制都会将该模板作为其完整输入——不附带任何对话历史。

反馈以三个层级返回。关键问题立即修复。重要问题在继续下一个任务之前修复。次要问题记录下来供后续处理。该技能在一点上很明确:如果审查者有误,要用技术推理进行反驳。一个无法被质疑的审查者是没有用的。

无法实现隔离时的回退方案

并非每个运行时都能生成真正隔离的 agent。该技能提供了两个回退选项。次优方案是同一操作者的全新会话,只加载审查者提示和 git diff——没有先前的对话。第三优方案是针对同一检查清单进行自我审查。每级回退质量都会下降,但该结构仍能捕获相当一部分问题。

它所防止的反模式

因为变更看起来简单就跳过审查,正是该技能所指名的特定失败。审查者的工作不是去质疑显而易见的事情——而是去捕获那些不明显的问题。看似简单的变更往往恰好隐藏了这些问题。

阅读Datarim 是什么了解更广泛的 agent 架构,或查看reflecting 技能了解审查发现如何反馈到长期框架改进中。