Alibaba abre CLI de revisão de código por IA usado por milhares de devs

O que é

Open Code Review é uma ferramenta de linha de comando de revisão de código com IA, aberta pelo Alibaba Group sob licença Apache-2.0. Segundo a descrição do projeto, ela nasceu como assistente interno oficial de revisão de código por IA do grupo e, ao longo de dois anos, atendeu dezenas de milhares de desenvolvedores e identificou milhões de defeitos de código. Após essa validação em escala, foi incubada como projeto open source. Para começar, basta configurar um endpoint de modelo.

A ferramenta lê diffs do Git, envia os arquivos alterados a um LLM configurável por meio de um agente com uso de ferramentas e gera comentários estruturados com precisão de linha. O agente pode ler arquivos completos, buscar no repositório e inspecionar outros arquivos alterados para obter contexto. Além da revisão de diffs, o comando ocr scan revisa arquivos inteiros, útil para auditar bases desconhecidas ou diretórios sem diff relevante.

Arquitetura híbrida

A tese central é combinar engenharia determinística com um agente, cada parte cuidando do que faz melhor. A fonte atribui a agentes de propósito geral, como o Claude Code com Skills, três sintomas: cobertura incompleta em conjuntos grandes de mudanças, desvio de posição (comentários que não correspondem à localização real no código) e qualidade instável, difícil de depurar. A causa raiz apontada é que uma arquitetura puramente guiada por linguagem não impõe restrições rígidas ao processo de revisão.

No lado determinístico ficam a seleção precisa dos arquivos a revisar, o agrupamento de arquivos relacionados em uma única unidade de revisão (o exemplo citado são os arquivos message_en.properties e message_zh.properties, agrupados), com cada pacote rodando como sub-agente de contexto isolado, a correspondência fina de regras às características de cada arquivo e módulos externos de posicionamento e reflexão de comentários. Ao agente ficam as decisões dinâmicas: prompts ajustados ao cenário e um conjunto de ferramentas derivado da análise de rastros de chamadas em dados de produção em escala.

Benchmark e trade-off

O projeto apresenta um benchmark de revisão de código construído a partir de 50 repositórios open source populares, 200 pull requests reais e 10 linguagens de programação, com validação cruzada por mais de 80 engenheiros sêniores e 1.505 problemas anotados como referência. O conjunto, chamado AACR-Bench, está publicado no Hugging Face.

Na comparação declarada com agentes de propósito geral, usando o mesmo modelo de base, o Open Code Review alcança Precision e F1 significativamente maiores, consumindo cerca de 1/9 dos tokens e concluindo as revisões mais rápido. A própria fonte ressalva que o Recall é menor, descrevendo isso como um trade-off deliberado que privilegia precisão sobre ruído. As métricas destacadas incluem F1, precisão, recall, tempo médio por revisão e tokens médios por revisão, este último associado diretamente ao custo de API. A ferramenta também descreve um conjunto de regras multi-linguagem embutido - como NPE, segurança de threads, XSS e injeção de SQL - e compatibilidade com OpenAI e Anthropic.

Uso e integrações

A ferramenta exige Git igual ou superior a 2.41 e pode ser instalada via npm install -g @alibaba-group/open-code-review, o que disponibiliza o comando global ocr. A configuração de provedor e modelo é interativa e testa a conectividade automaticamente. Entre os modos de uso estão revisão do espaço de trabalho, intervalo de branches em modo merge-base, commit único, retomada de revisões interrompidas por sessão, varredura completa de arquivos e saída em JSON.

Há ainda um modo de delegação em que o próprio agente de código do usuário executa a revisão com seu LLM, sem necessidade de chave de API do OCR. As integrações listadas incluem Claude Code, Codex, Cursor, OpenCode, QCA Forward e agentes compatíveis com skills, além de servidor MCP, pipelines de CI/CD (GitHub Actions, GitLab CI, GitFlic CI e Gerrit), visualizador de sessões e telemetria via OpenTelemetry. O repositório registra 22,3 mil estrelas, 1,7 mil forks e 673 commits.