Sep 21, 2026

Open Code Review 把确定性评审带进你的 Git 工作流

阿里巴巴开源的 38k star CLI,用确定性流水线加 LLM agent 做行级代码评审,还提供无需 OCR API key 的委派模式。

#tutorial#developer-tools#workflow

你可以让通用 agent 评审你的 diff,它会照做——但不稳定。Open Code Review(OCR)的 README 点名了这些失败模式:大改动集上 agent 会选择性跳过文件、报告的行号偏离目标、质量随提示词的微小波动而起伏。这个 38k star 的 CLI 起源于阿里巴巴集团内部的 AI 代码评审助手,用混合架构正面解决这些问题。

为什么这个 Skill 重要

OCR 把确定性工程与 agent 配对,按各自可靠的边界分工。工程逻辑负责不能出错的步骤:精确的文件选择、把相关文件打包成一个评审单元(README 的例子:message_en.properties 和 message_zh.properties 一起送审)、按文件类型的模板引擎规则匹配,以及独立的评论定位与反思模块。agent 负责判断:针对代码评审场景调优的提示词与工具集(从生产环境工具调用轨迹中提炼),并能读取完整文件、搜索代码库、查看其他变更文件补充上下文。

README 在 AACR-Bench 上做了基准测试,该基准由 50 个开源仓库、200 个真实 PR、10 种编程语言构成,经 80 多位资深工程师交叉验证,标注出 1505 个真实缺陷。其结论:在同一底层模型上与通用 agent 对比,OCR 的精确率和 F1 显著更高,token 消耗约为后者的九分之一——召回率刻意更低,用发现问题的数量换取更少的误报。

安装

需要 Git 2.41 或更高版本,然后一次全局安装:

npm install -g @alibaba-group/open-code-review

首次评审前先配置 LLM——交互式命令会引导你选择 provider、填 API key、选模型,并自动测试连通性:

ocr config provider
ocr config model

实战:开 PR 之前评审整个分支

  1. 在项目目录里,评审分支自 main 分叉以来的完整范围(merge-base 模式):
ocr review --from main --to feature-branch
  1. 评审被打断或耗时较长时,找回并续跑会话:
ocr session list
ocr review --from main --to feature-branch --resume <session-id>
  1. 想把评审结果喂给 AI 宿主 agent,输出 JSON:
ocr review --format json --output result.json

实战:扫描整个目录

审计陌生代码库时不存在 diff。ocr scan 直接评审完整文件——不需要 git 历史:

ocr scan --path internal/agent

实战:委派给你的编码 agent

委派模式反转了配置方向:OCR 负责文件选择和规则解析,你的编码 agent 用它自己的 LLM 执行评审——无需配置 OCR 的 LLM:

ocr delegate preview
ocr delegate rule src/main.go src/handler.go

在 Claude Code 里,插件把它暴露成斜杠命令:

/plugin marketplace add alibaba/open-code-review
/plugin install open-code-review@open-code-review

这会安装 /open-code-review:review 和 /open-code-review:delegate-review。

技巧

  • 除了 diff 评审,不带路径的 ocr scan 会扫描整个仓库——接手遗留代码库之前很有用。
  • 提供 Claude Code、Codex、Cursor、Kimi Code 插件,另有面向兼容 skill 的 agent 的可移植 agent skill。
  • Session Viewer 让你在浏览器里浏览和回放评审会话,逐条处理时可以把评论标记为已修复或忽略。

何时不用这个 Skill

如果你的优先级是找出所有可能的问题,刻意调低的召回率意味着通用 agent 会找到更多——OCR 优化的是精确率,即每次评审更少的误报。除非使用委派模式,LLM 评审仍需要一个已配置的模型端点;确定性流水线也假定这是一个 Git 仓库(2.41+)而不是散落文件。


查看 排行榜 了解更多 skill。