← Voltar ao blog
Aicerca de 7 min de leitura

O revisor que nunca quis o seu trabalho

Publicado 9 de nov. de 2026
O revisor que nunca quis o seu trabalho

A maioria dos agentes de programação com IA que as pessoas discutem em 2026 está tentando escrever o seu código. O PR-Agent está tentando ler.

Ele tem 15.539 estrelas, mora em The-PR-Agent/pr-agent, e o README agora abre com uma frase que parece escrita por alguém que já teve essa conversa vezes demais: «O revisor de PR open source original. Este projeto não é o plano gratuito do Qodo.»

Essa frase faz muito trabalho. O PR-Agent nasceu como o revisor open source da Qodo e virou aquilo que toda equipe instalou sem alarde e depois parou de pensar a respeito. O projeto desde então se mudou para a própria organização e agora precisa declarar, sem rodeio, que hospedar por conta própria não é o mesmo que usar o plano gratuito de um fornecedor. Justo. A distinção importa: um é uma ferramenta que você roda, o outro é um serviço que roda você.

O que ele faz, em quatro comandos

O produto inteiro são quatro comandos de barra num pull request.

/describe escreve a descrição do PR — o que mudou, por quê, e o que um revisor deve olhar primeiro. /review faz a revisão: bugs possíveis, questões de segurança, testes faltando, inconsistências com o resto do arquivo. /improve sugere mudanças concretas de código. /ask responde uma pergunta sobre o diff, na thread, com o diff como contexto.

Cada um desses é uma única chamada de LLM. O README fala em cerca de trinta segundos e custo baixo, que é a restrição de design que moldou todo o resto. Não há loop de agente, nem árvore de chamada de ferramenta, nem plano multi-etapa. Um prompt, uma resposta, um comentário.

Isso soa fraco até você lembrar o que ele substituiu: um revisor abrindo um PR de 1.400 linhas às 18h e passando os olhos.

Instalando

Três caminhos, em ordem de quanto você precisa pensar neles.

A GitHub Action é um único arquivo de workflow. Coloque isto em .github/workflows/pr-agent.yml:

on: pull_request: types: [opened, synchronize]
uses: the-pr-agent/pr-agent@main
env: OPENAI_KEY, GITHUB_TOKEN

Essa é a configuração inteira. Todo PR novo e todo push num PR existente ganha revisão automática. Vinte minutos entre decidir testar e estar rodando, se os seus secrets já estão configurados.

A CLI é para rodar localmente contra um PR que você não escreveu:

pip install "pr-agent[github]"
export OPENAI_KEY=your_key_here
pr-agent --pr_url <url> review

Instale o extra do provedor da plataforma que você usa, ou pr-agent[all] se quiser todas as integrações.

Webhooks e auto-hospedagem são para equipes que precisam que a revisão aconteça dentro da própria rede. Existem imagens Docker. O GitLab usa configuração de webhook, o Bitbucket instalação de app, o Azure DevOps tem o próprio caminho. O Gitea também é suportado.

A printed page with a red pen mark in the margin beside a cooling cup of coffee

As duas decisões de engenharia que o tornam usável

Compressão de PR. Um revisor que só funciona em diffs pequenos é uma demo. O PR-Agent tem uma estratégia de compressão para diffs grandes — ele não apenas trunca, decide o que manter para que o modelo ainda veja a forma da mudança. É a parte menos glamourosa e mais importante da base de código, porque a alternativa é uma ferramenta que funciona no tutorial e cai no seu repositório real.

Configuração de prompt como dado. As categorias de revisão, o tom, as coisas que você quer sinalizadas e as que quer ignoradas ficam num arquivo de configuração TOML, não em Python. Você pode adicionar uma categoria — «verifique se toda coluna nova de banco tem migração» — sem tocar em código. As equipes que adotam isso costumam acabar com uma config que codifica a própria cultura de revisão, e essa é a diferença entre um linter genérico e algo que um engenheiro sênior aprovaria de fato.

A escolha de modelo é aberta via LiteLLM: OpenAI, Claude, Gemini, DeepSeek, Mistral, além de Azure OpenAI, Bedrock, Vertex, Databricks, OpenRouter e Ollama. Se você roda um modelo local por confidencialidade, este é um dos poucos revisores que vai com você até lá.

Como é um comentário de revisão útil

A diferença entre um bot revisor que ajuda e um que é silenciado não é precisão. É se o comentário é específico o suficiente para agir.

«Considere adicionar tratamento de erro aqui» é pior que nada, porque faz o leitor se sentir supervisionado sem dizer nada. «Esta chamada pode retornar null quando o cache erra; quem chama três linhas abaixo desreferencia sem checar» é útil mesmo que o bot esteja certo só em 70% das vezes, porque conferir leva dez segundos.

O arquivo de configuração é o que te leva do primeiro tipo de comentário para o segundo. Aponte as categorias para o que de fato morde a sua base: cobertura de migração, semântica de retry, checagem de permissão em endpoints novos, se uma variável de ambiente nova está documentada. Um revisor que só conhece «qualidade de código» vai produzir comentários sobre qualidade de código, que não é o que ninguém precisa às 18h.

Há um efeito de segunda ordem que vale planejar. Quando o bot comenta em todo PR, humanos revisam com menos cuidado, porque algo já olhou. É a mesma dinâmica de um linter que quebra o build por estilo: treina as pessoas a parar de olhar estilo. Use o bot para as checagens mecânicas e diga isso explicitamente, para que a atenção humana vá onde o bot não chega — se a mudança é uma boa ideia.

Um defeito honesto no README

O /help_docs está desativado desde a v0.36.1, à espera de uma correção para um problema de exposição de credencial, registrado como issue #2445. A nota está ali na seção de recursos, não escondida num changelog.

Gosto que esteja visível. Um bot revisor tem acesso de leitura ao seu código. Um bug de exposição de credencial numa ferramenta que lê o seu código é o tipo de coisa que você quer que seja divulgada em voz alta, e os mantenedores fizeram isso em vez de remover o comando em silêncio e torcer para ninguém notar.

É também um lembrete da superfície de risco real aqui. Você está entregando a um prompt de terceiro, rodando num modelo de terceiro, acesso de leitura ao seu diff e aos arquivos em volta. É uma troca razoável para a maioria das equipes e inaceitável para algumas. O caminho auto-hospedado existe justamente para que a decisão seja sua.

Por que este sobreviveu e os agentes mais vistosos não

Havia dezenas de startups de revisão de código com IA em 2024 e 2025. A maioria morreu ou foi absorvida. O revisor open source que começou como projeto paralelo continua aqui, continua mantido, continua entregando mudanças de configuração.

O motivo é chato: ele faz uma coisa no momento em que essa coisa é útil. Uma revisão chega quando um PR abre, não quando você lembra de pedir. O comentário aparece onde a discussão já acontece. O custo é trinta segundos e uma fração de centavo. Não há nada para aprender e nada para integrar.

Compare com os frameworks de agente que querem assumir o seu fluxo de trabalho inteiro. Esses são mais impressionantes e muito mais difíceis de manter rodando. O PR-Agent pede um arquivo de workflow e uma chave.

Se você for testar

Comece com a Action em um repositório, não em todos. Rode num modo em que ele comenta mas não bloqueia, e dê duas semanas. Você vai descobrir rápido se a sua equipe lê os comentários ou passa o dedo por cima, e essa resposta decide se a ferramenta vale a configuração.

Depois escreva as categorias com as quais você realmente se importa e coloque na config. Um revisor genérico dá notas genéricas. O valor chega quando o bot está checando as três coisas que a sua equipe sempre esquece — e é você que diz quais são as três.

Artigos relacionados