Revisão de código com IA: um checklist para devs e QAs
Como usar assistentes de IA para revisar código sem terceirizar o julgamento. O que pedir, um modelo de prompt, como conferir as sugestões e os cuidados com segurança e confidencialidade.
Assistentes de IA são bons em ler código rápido e apontar o que parece estranho. Também são capazes de sugerir, com toda a confiança, uma "correção" que introduz um defeito novo. A revisão com IA funciona quando ela é mais um revisor, e não o único.
Onde a IA costuma ajudar
- Erros fáceis de deixar passar: variável não usada, condição invertida, tratamento de erro ausente,
nullnão verificado. - Casos de borda: listas vazias, valores negativos, datas no fim do mês, fusos horários.
- Legibilidade: nomes confusos, funções longas demais, duplicação.
- Sugestões de teste: quais cenários o código novo deveria ter cobertos.
Onde ela costuma errar
- Não conhece o contexto: regras de negócio, decisões de arquitetura do time e restrições que não estão no trecho enviado.
- Inventa APIs: pode sugerir uma função ou opção de biblioteca que não existe na versão que você usa.
- Excesso de confiança: apresenta palpites como certezas.
- Mudanças grandes demais: propõe reescrever tudo quando o problema era uma linha.
Um modelo de prompt
Revise o código abaixo como um revisor sênior.
Contexto: [o que este código faz e onde ele roda, em 2 ou 3 frases]
Linguagem e versões: [ex.: TypeScript 5, Node.js 22]
Procure, nesta ordem:
1. Defeitos que causariam comportamento errado (com um exemplo de entrada que mostra o problema).
2. Problemas de segurança (entrada não validada, dados sensíveis em log, permissões).
3. Casos de borda não tratados.
4. Testes que estão faltando.
Regras:
- Para cada ponto, diga o quanto você tem certeza (alta, média, baixa).
- Não reescreva o código inteiro: sugira a menor mudança possível.
- Se precisar de uma informação que não está aqui, pergunte em vez de supor.
[código]
Pedir um exemplo de entrada que mostra o problema é o truque mais útil: ele transforma uma opinião em algo que você pode testar em segundos.
Como conferir as sugestões
- Reproduza antes de corrigir. Escreva um teste com a entrada que a IA apontou. Se o teste não falha, a "falha" provavelmente não existe.
- Confira na documentação qualquer função ou opção de biblioteca sugerida.
- Rode a suíte de testes depois da mudança.
- Desconfie de mudanças grandes. Peça a menor alteração possível e entenda cada linha antes de aceitar.
- A decisão é sua. Se você não consegue explicar a mudança para outra pessoa do time, não faça o merge.
O papel do QA aqui
Para quem trabalha com qualidade, a revisão com IA é uma boa fonte de ideias de teste: cada risco apontado pode virar um caso de teste. Também vale o caminho inverso: quando o time usa IA para escrever código, aumenta a importância de testes que verifiquem o comportamento de verdade, e não só que o código "parece certo".
Segurança e confidencialidade
- Não envie segredos: senhas, tokens, chaves de API e arquivos de configuração com credenciais.
- Respeite a política da empresa. Muitas empresas permitem apenas ferramentas aprovadas, ou proíbem enviar código proprietário para serviços externos. Pergunte antes.
- Dados pessoais de clientes nunca devem ir para a conversa, nem em exemplos. Use dados fictícios.
Resumo
Use a IA para ampliar a revisão, não para substituí-la: peça exemplos concretos, transforme cada suspeita em um teste e mantenha a decisão com quem entende o contexto. Veja também como usar IA para criar casos de teste.