The open source AI code review agent — 阿里巴巴开源的 AI 代码审查工具

7.4k stars | Go | Apache-2.0 | 2026-05 | 文档

一句话定位

阿里巴巴内部 AI 代码审查工具开源版。两年间服务数万开发者、识别数百万代码缺陷,经大规模生产验证后开源。读取 Git diff,用 LLM Agent 生成精确到行的代码审查意见。

核心设计:确定性工程 × Agent 混合架构

为什么不用通用 Agent(如 Claude Code Skill)做代码审查

通用 Agent 做代码审查有三个痛点:

  • 覆盖不完整:大 changeset 时 Agent 会「偷懒」,跳过部分文件
  • 位置漂移:报告的问题行号/文件经常不准
  • 质量不稳定:纯自然语言驱动,Prompt 微小变化导致质量大幅波动

解法:让确定性工程负责「不能出错」的事,让 Agent 负责「需要动态判断」的事

确定性工程层(硬约束):

  • 精确文件选择:工程逻辑决定哪些文件需要 review,不遗漏
  • 智能文件分组:相关文件打包成一个 review 单元(如多语言 properties 文件),每个分组是独立子 Agent,天然支持并发
  • 细粒度规则匹配:基于文件特征匹配 review 规则,模板引擎驱动,比纯语言更稳定
  • 外部定位 + 反射模块:独立的注释定位和反射模块,系统性提升位置精度和内容精度

Agent 层(动态决策):

  • 场景定制 Prompt(针对代码审查深度优化)
  • 场景定制工具集(从大规模生产数据的 trace 分析中蒸馏)
  • 动态上下文检索(可读取完整文件、搜索代码库、查看其他变更文件)

内置规则集

开箱即用的安全和质量规则:

  • NPE(空指针异常)
  • 线程安全
  • XSS(跨站脚本)
  • SQL 注入

使用方式

安装

npm install -g @alibaba-group/open-code-review
# 安装后 ocr 命令可用

配置 LLM

# 交互式配置(推荐)
ocr config provider   # 选择 provider
ocr config model      # 选择模型
 
# 手动配置(以 Anthropic 为例)
ocr config set llm.url https://api.anthropic.com/v1/messages
ocr config set llm.auth_token your-api-key-here
ocr config set llm.model claude-opus-4-6
ocr config set llm.use_anthropic true
ocr config set llm.auth_header x-api-key

支持 OpenAI 兼容 API 和 Anthropic 原生 API,claude-opus-4-6 是文档中的推荐模型。

运行审查

# 审查当前 Git diff
ocr review
 
# 审查指定 commit 范围
ocr review --from HEAD~3 --to HEAD

技术栈

  • 主语言:Go(CLI + 工程层)
  • LLM 层:OpenAI 兼容 + Anthropic 原生双协议
  • 分发:npm 包 + 预编译二进制(macOS/Linux/Windows,arm64/amd64)

为什么值得关注

  • 生产验证:阿里内部数万开发者使用,不是玩具项目
  • 解决了通用 Agent 做代码审查的核心问题:行级精度 + 完整覆盖 + 稳定质量
  • 架构思路有参考价值:确定性工程 + Agent 混合这种设计模式值得借鉴

局限性

  • 仍处于早期开源阶段(2026-05 开源,stars 增长较快)
  • 规则集主要覆盖 Java 生态场景(NPE、线程安全),其他语言覆盖待验证
  • 自定义规则的灵活度有待社区验证

关联页面

  • agent-harness-anatomy — LangChain 对 Agent Harness 的系统解剖
  • papers/wildclaw-bench — WildClawBench:Agent 长视野基准,含代码任务
  • aisuite — 多 LLM 统一接口,与本工具 LLM 配置层互补