Revisão de Código Automatizada
Nesta página
Atualizado a 3 de novembro de 2026 com base nas páginas Code Review e Use Codex in GitHub da documentação do Codex e na ajuda da CLI versão 0.166.0: as revisões são acionadas via
@codex reviewou com a revisão automática ativada nas definições, localmente viacodex review --uncommittedou/review; a secção AGENTS.md intitula-se## Code Review Rules. O comando de extensão “Codex: Review Changes” e o URL codex.openai.com foram removidos, e o exemplo de relatório é apresentado como uma ilustração. Fontes: Code review · Use Codex in GitHub.
Melhore a Qualidade do Código com Revisões por IA
Na maioria das equipas, a revisão de código tornou-se o gargalo no pipeline de entrega: os pull requests acumulam-se porque os revisores qualificados estão ocupados a escrever código. O Codex não substitui os revisores humanos; trata da primeira passagem — detetando lapsos óbvios, desvios da arquitetura existente e casos limite não testados. Quando um programador abre finalmente o PR, já não precisa de assinalar testes em falta para caminhos de erro; pode focar a sua atenção em decisões que exigem julgamento empresarial.
Executar uma Revisão num PR
No GitHub, a abordagem mais direta é mencionar o Codex num comentário do pull request: @codex review. O Codex reage (👀) e publica a sua revisão no PR. Na aplicação de ambiente de trabalho, o módulo Code Review apresenta a descrição do PR, os ficheiros alterados, os comentários e as verificações, permitindo-lhe questionar o Codex sobre a alteração. Em ambos os casos, a qualidade do relatório depende da precisão do pedido: indique as áreas a cobrir.
"Review PR #142. Check:
- Consistency with existing architecture
- Potential security issues
- Test coverage
- TypeScript code quality
- Unhandled edge cases"
O Codex analisa o diff, mas também lê o contexto dos ficheiros modificados — não apenas as linhas alteradas — e entrega depois um relatório estruturado. Eis um exemplo do tipo de relatório que pode esperar para um PR que adiciona notificações:
## Review PR #142 — Notification System Addition
### Security
⚠️ src/api/routes/notifications.ts:34
The userId parameter comes from the request body without
validation. A user could send notifications on behalf of
another. Use req.user.id from the authentication middleware.
### Architecture
✅ The service follows the same pattern as other services
⚠️ The notification.service.ts file is already 200 lines.
Consider separating channels (email, webhook) into
distinct files.
### Tests
❌ No test for when the email service is
unavailable (timeout/network error)
⚠️ Tests mock the DB but not the email service
### Code quality
💡 The sendBatch function could use Promise.allSettled
instead of Promise.all to avoid failing if one
notification out of 50 fails.
Preste atenção à natureza dos comentários e não à sua formatação. A vulnerabilidade userId é exatamente aquilo que um revisor apressado deixa passar numa sexta-feira à noite: o código compila, os testes passam, mas qualquer utilizador pode escrever em nome de outro. A sugestão Promise.allSettled reflete uma compreensão do comportamento esperado — um envio em lote não deve falhar porque um endereço em cinquenta rebate — e não a aplicação mecânica de uma regra de estilo.
Direcionar Revisões para um Domínio
As revisões gerais diluem a atenção por cinco tópicos de uma vez. Ao preparar uma lançamento sensível para produção, solicite antes uma passagem especializada num âmbito restrito. Para segurança, o prompt é o seguinte:
"Security review on files modified in
src/api/ over the last 5 commits. Look for:
- SQL injections
- Potential XSS
- Missing authentication
- Exposed sensitive data
- Unchecked permissions"
O Codex conhece padrões comuns de vulnerabilidade e consegue detetá-los no seu código, mesmo quando ocultos atrás de uma camada de abstração personalizada. O mesmo princípio aplica-se ao desempenho, exceto que procura sintomas muito diferentes — não um defeito, mas uma consulta executada cem vezes quando uma seria suficiente:
"Analyze performance of src/services/report.service.ts.
Identify:
- N+1 database queries
- Loops that could be parallelized
- Loaded but unused data
- Calculations that could be cached"
Automatizar Revisões no GitHub
Uma vez estabelecida a prática na equipa, torne-a sistemática em vez de depender da memória individual. A documentação do Codex descreve a configuração da seguinte forma:
- Ligue o seu repositório GitHub ao Codex (precisa de direitos de push ou de administrador nas suas definições).
- Abra as definições de revisão de código.
- Selecione o repositório e ative Automatic review em Review code.
Todos podem também ativar a revisão automática para os seus próprios PRs nas suas preferências pessoais e escolher quando esta é acionada (Review trigger), sem terem de escrever @codex review. Esta revisão na nuvem não requer a criação de um ambiente Codex Cloud. Os comentários aparecem diretamente no PR do GitHub, no mesmo local que os comentários de um revisor humano — um detalhe que impulsiona a adoção: uma observação que obrigue as pessoas a abrir outra ferramenta não será lida. A revisão de merge requests do GitLab também existe, em pré-visualização.
Autorrevisão Antes de Abrir o PR
O melhor momento para corrigir um problema é antes de alguém o ver. A partir do IDE ou da CLI, uma autorrevisão sobre alterações não submetidas demora segundos e poupa-lhe um ciclo completo de revisão:
# From CLI, non-interactive: review uncommitted changes
codex review --uncommitted
# Or review a branch against main
codex review --base main
Numa sessão interativa, o comando /review faz o mesmo na sua árvore de trabalho; na aplicação de ambiente de trabalho, Code Review também oferece a revisão de alterações locais.
Experimente no seu próximo branch antes de fazer push: vai descobrir que metade dos comentários que costuma receber dos colegas já está resolvida e a conversa de revisão começa num nível mais interessante.
Defina os Seus Padrões em AGENTS.md
Uma revisão só tem valor se aplicar os critérios da sua equipa, e não os de algum projeto imaginário. O Codex procura ficheiros AGENTS.md no repositório e segue as suas regras de revisão: adicione uma secção ## Code Review Rules ao ficheiro mais próximo do código relevante, com subcabeçalhos ### para agrupar verificações.
## Code Review Rules
### API
- Every API route must verify authentication
- User data must be validated with Zod
- No TypeScript any (use unknown + type guard)
- Errors must be logged with context
- Functions > 50 lines must be broken down
- TODO comments must have an associated ticket
O Codex aplica estes padrões a cada revisão, com uma consistência que nenhum revisor humano mantém ao longo de trezentos pull requests consecutivos.
Pontos-chave
- O Codex realiza uma revisão de primeira passagem para filtrar problemas óbvios
- As revisões podem ser especializadas: segurança, desempenho, arquitetura
- A integração com o GitHub permite revisões automáticas em cada PR
- Utilize a revisão antes de criar o PR para poupar tempo
- Documente os seus padrões em AGENTS.md para revisões consistentes