2026年8月17日

接收代码审查技能 — 在实施审查反馈前先验证

Datarim 的 receiving-code-review 技能如何用六步验证模式取代表演式认同——阅读、理解、对照代码库验证、评估、回应、实施。

一个对每条审查意见都回复“您说得完全正确!我现在就实施”的 AI 助手,并不是在做代码审查——它是在做社交表演。receiving-code-review 技能用一个围绕单一原则构建的六步流程取代了这种模式:在实施前先验证。

六步模式

回应顺序是固定的:完整阅读反馈而不急于反应,用智能体自己的话复述技术要求(如果要求不明确则请求澄清),对照实际代码库进行验证,评估该建议对本项目在技术上是否合理,以技术性确认或有理有据的反对来回应,然后逐项实施并逐项测试。如果反馈中有任何一项不明确,该技能会在第二步完全中止流程——基于部分理解的部分实施会产生错误的结果。

何时应当反驳

该技能列出了反驳的具体条件:当建议破坏现有功能时,当审查者缺乏代码库的完整上下文时,当变更添加了当前没有任何调用方的功能时(YAGNI),当变更对所用技术栈在技术上不正确时,或当它与先前的架构决策冲突时。反驳的机制是技术性推理——检查拟议变更是否会破坏现有测试、引用当前实现存在的原因,或提出具体问题。该技能将外部审查建议视为需要评估的事项,而非必须服从的命令。

不要表演式认同

诸如“好观点!”或“感谢发现!”之类的回应被列为禁止——不是因为致谢不礼貌,而是因为它们用社交信号替代了技术信号。当反馈正确时,正确的回应是简要描述改了什么,或者直接给出修复本身。当反馈错误时,正确的回应是具体的技术性反驳。两种情况都需要精确,而非热情。

GitHub 行内回复

在回应 GitHub 拉取请求上的行内审查意见时,该技能规定回复应通过 gh api repos/{owner}/{repo}/pulls/{pr}/comments/{id}/replies 端点进入评论线程——而不是作为 PR 的顶层评论。这样可以让对话串接在其所引用的代码行之下,而不是散落在整个 PR 中。参见 receiving-code-review 参考文档,或阅读什么是 Datarim 以了解全貌。