Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Revisão de Código Automatizada

Aula 11 de 20 Atualizada a 3 de novembro de 2026 Programador
Nesta página
  1. Melhore a Qualidade do Código com Revisões por IA
  2. Executar uma Revisão num PR
  3. Direcionar Revisões para um Domínio
  4. Automatizar Revisões no GitHub
  5. Autorrevisão Antes de Abrir o PR
  6. Defina os Seus Padrões em AGENTS.md
  7. Pontos-chave

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 review ou com a revisão automática ativada nas definições, localmente via codex review --uncommitted ou /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:

  1. Ligue o seu repositório GitHub ao Codex (precisa de direitos de push ou de administrador nas suas definições).
  2. Abra as definições de revisão de código.
  3. 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