Open Code Review Skill:阿里开源 AI 代码审查工具,精度超越通用 Agent
Alibaba 内部两年实践后开源的 AI 代码审查工具,融合确定性工程与 LLM Agent 双重架构,在 10 种编程语言、200 个真实 PR 上验证,精度和 F1 均超越通用 Agent,Token 消耗却仅为 1/9。已服务数万名开发者,发现数百万代码缺陷,现已开放给社区。
功能与原则
Open Code Review 核心解决通用 AI 编程助手做代码审查时的三大痛点:覆盖不全(大改动集只审部分文件)、位置漂移(反馈行号与实际代码错位)、质量不稳定(自然语言驱动导致审查质量随提示词波动)。
其设计哲学是”确定性工程做硬约束,Agent 做动态决策”:文件选择、规则匹配、评论定位等必须正确的步骤由工程逻辑保证;动态上下文检索、场景化提示优化交由 LLM Agent 处理。两者各司其职,避免语言模型在结构化任务上自由发挥导致的噪声。
认可度
- GitHub Star:截至 2026-10-03 约 43k(Trending 月榜常驻,多篇技术媒体报道)
- 下载量:npm 包
@alibaba-group/open-code-review全球安装 - 背景:Alibaba 集团内部官方 AI 代码审查助手,历时两年大规模验证,服务数万开发者
- Benchmark:在 50 个热门开源仓库、200 个真实 PR、10 种编程语言上交叉验证,由 80+ 高级工程师标注(1505 个真实问题),对比 Claude Code 等通用 Agent,Open Code Review 的 Precision 和 F1 均显著更高,Token 消耗约为 1/9
链接
GitHub:https://github.com/alibaba/open-code-review
原作者
Alibaba Group(阿里巴巴) — 中国最大电商集团的技术工程团队,两年内部打磨后开源,社区版与内部版功能一致。
介绍
Open Code Review(简称 OCR)是一款 AI 驱动的代码审查 CLI 工具。它读取 Git diff,将变更文件发送给可配置 LLM(支持 OpenAI、Anthropic 等),生成结构化审查意见,精确定位到具体代码行。Agent 不仅能读完整文件内容、搜索代码库、查看其他变更文件获取上下文,还能执行深度审查——而非仅做表层 diff 反馈。
除 diff 审查外,ocr scan 可对整个文件或目录进行全量审计,适合审查不熟悉的代码库或没有有效 diff 的场景。
OCR 的定位是”专业级代码审查”,不是通用 Agent 的附加功能。其架构专为代码审查设计,从文件选择、规则匹配、到评论定位,每一步都有硬约束,而非依赖自然语言引导模型”尽力做好”。
特点
- 混合架构:确定性工程(文件选择/bundling/规则匹配/定位模块)+ LLM Agent(动态决策/上下文检索),各司其职
- 行级精确:外部定位与反思模块(positioning & reflection)确保反馈位置和内容双重准确,解决通用 Agent 位置漂移顽疾
- 规则引擎:内置多语言规则集,覆盖空指针(NPE)、线程安全、XSS、SQL 注入等常见缺陷类型,模板驱动匹配更稳定可预测
- 高效率:同等模型下 Token 消耗约为通用 Agent 的 1/9,审查速度更快
- 多 Agent 集成:官方提供 Claude Code、Codex、Cursor、Kimi Code、OpenCode 插件,支持 Delegation Mode(由 AI 编程助手自己调用 LLM 执行审查,无需单独配置 OCR 的 API Key)
- CI/CD 友好:支持 GitHub Actions、GitLab CI、GitFlic CI、Gerrit 集成,审查结果可输出 JSON 格式
使用方法
安装:
npm install -g @alibaba-group/open-code-review
配置 LLM:
ocr config provider # 选择内置 provider 或添加自定义
ocr config model # 为当前 provider 选择模型
执行审查:
cd your-project
# 工作区模式 — 审查所有 staged、unstaged、未跟踪变更
ocr review
# 分支范围 — 审查 feature-branch 相对于 main 的变更
ocr review --from main --to feature-branch
# 单次提交
ocr review --commit abc123
# 全量扫描 — 审查整个仓库(无需 git 历史)
ocr scan
ocr scan --path internal/agent # 指定目录或文件
# 结果保存为 JSON(推荐用于 AI 主机 Agent)
ocr review --format json --output result.json
# Delegation 模式 — 让 AI 编程助手自行完成审查,无需配置 LLM
ocr delegate preview
ocr delegate rule src/main.go src/handler.go
使用场景与人群
适用场景:
– PR 审查流程(CI/CD 集成或本地触发)
– 全量代码库审计(接手陌生项目、代码重构前)
– AI 编程助手的代码质量守卫(Claude Code、Cursor 等内置审查能力)
– 多语言大型项目的一致性审查
目标用户:
– 开发团队(希望将 AI 审查纳入 CI 流程)
– AI 工程团队(为内部 Agent 添加可验证的代码审查能力)
– 安全/测试团队(需要系统性发现 NPE、SQL 注入等典型缺陷)
输入与输出案例
案例 1:PR 审查
输入命令:
ocr review --from main --to feature-branch --format json --output result.json
OCR 自动完成:
1. 确定需要审查的文件,bundling 相关文件(如 i18n 属性文件)
2. 对每个 bundle 调用 LLM,按规则引擎匹配规则(NPE、线程安全等)
3. 定位评论到具体行号,过滤误报
4. 输出结构化 JSON,包含文件路径、行号、缺陷类型、严重程度
输出片段:
{
"file": "src/main/java/com/alibaba/UserService.java",
"line": 42,
"type": "NPE",
"severity": "major",
"message": "Potential null pointer dereference: user.getId() called without null check after query."
}
案例 2:Delegation 模式(由 Claude Code 调用)
用户对 Claude Code 说:”用 Open Code Review 审查这个 PR”,Claude Code 内部调用 ocr delegate 命令,OCR 负责文件选择和规则解析,Claude Code 内置 LLM 执行审查,输出结果直接回到 Claude Code 对话中,无需用户配置 OCR 的 API Key。
评论区
登录后可评论。