Entregue contexto ao revisor
Uma revisão começa com a mudança que você quer avaliar e com o comportamento esperado. Informe entrada, resultado desejado, arquivos envolvidos e verificações já feitas. O revisor precisa saber o que pode ser considerado correto, não apenas receber um diretório enorme.
Uma segunda IA, como Codex, pode oferecer outra análise, mas não se torna automaticamente mais confiável. Trate suas sugestões como hipóteses que devem apontar um cenário concreto. O valor aparece quando a revisão encontra algo que pode ser demonstrado.
Por que aprender
Contexto reduz comentários genéricos e evita que o revisor proponha mudanças que contradizem o objetivo. Também limita o custo e o alcance da revisão.
✓ Fazer
Relacionar cada achado a um comportamento.
✗ Evitar
Aceitar uma revisão porque ela soa convincente.
Conceitos-chave
Prepare uma base comparável
Em um projeto Git, o diff mostra o que mudou. Antes de revisar, confira a pasta atual e o estado do repositório. Separe arquivos próprios da mudança e materiais que não devem ser publicados. Uma revisão de alterações não versionadas pode incluir arquivos novos.
Com a CLI Codex instalada e autenticada, consulte a ajuda local e use uma revisão compatível com a versão disponível. O exemplo abaixo mostra a revisão de alterações não commitadas. Ela não substitui o teste da aplicação.
Por que aprender
Uma base clara impede que o revisor compare arquivos errados ou trate código antigo como parte da alteração atual. A inspeção do status também evita publicar dados de preparação por engano.
Um caminho para aplicar
- Descreva a mudança e escolha uma base.
- Peça evidência, reproduza e classifique os achados.
- Aplique a menor correção e repita o cenário.
Conceitos-chave
Peça achados acionáveis
Solicite que cada achado descreva gatilho, efeito, localização e forma de reproduzir. Prefira “dois cliques enviam o mesmo pedido duas vezes” a “melhore a robustez”. O primeiro enunciado permite construir um teste; o segundo não define um comportamento.
Diferencie erro funcional, manutenção e preferência de estilo. Todos podem importar, mas não devem receber a mesma prioridade. Uma exportação que inclui registros de outro cliente exige uma resposta diferente de um nome de variável pouco claro.
Por que aprender
Achados acionáveis tornam a revisão uma ferramenta de decisão. Você consegue priorizar pelo impacto e verificar se a menor alteração realmente resolveu o caso.
git status --short
git diff --stat
# Confira as opções da versão instalada:
codex review --help
# Revise as mudanças ainda não commitadas:
codex review --uncommitted
Conceitos-chave
Teste repetição e interrupção
Muitos erros aparecem na segunda execução. Se um pedido é reenviado depois de uma falha de conexão, a operação precisa saber se já foi processada. Uma chave de idempotência identifica a mesma intenção para evitar criar dois resultados.
Outro cenário é a interrupção no meio de uma atualização. Registrar metade de uma operação pode deixar os dados inconsistentes. Em exercícios, simule a falha entre os passos e observe o estado final. Não conclua que um fluxo é correto só porque funciona uma vez.
Por que aprender
Esses cenários são fáceis de esquecer em demonstrações. Testar repetição e interrupção revela problemas que uma leitura superficial ou uma única execução não mostra.
✓ Fazer
Guardar o caso que reproduzia o erro.
✗ Evitar
Corrigir estilo e falha crítica como se fossem iguais.
Conceitos-chave
Saia de um ciclo de tentativas
Quando uma correção falha repetidamente, registre o que já foi tentado e o resultado de cada tentativa. Reduza o problema até uma entrada pequena que ainda falhe. Entregue esse caso a uma nova revisão.
Trocar de modelo sem organizar as evidências pode apenas reiniciar o mesmo ciclo. A mudança mais importante é fornecer um experimento menor, uma hipótese por vez e uma condição clara de parada. Preserve o caso que falhava depois da correção.
Por que aprender
Um caso mínimo reduz a quantidade de explicações possíveis. Ele permite distinguir um problema de lógica, uma configuração incompatível e uma dependência indisponível.
| Critério | Evidência esperada |
|---|---|
| Reprodução | Duas entradas iguais demonstram o problema. |
| Correção | A mesma intenção produz um único efeito. |
| Conflito | Conteúdo divergente não é descartado silenciosamente. |
Conceitos-chave
Prática: encontre uma duplicação
Imagine um formulário fictício que acrescenta pedidos a uma lista. O mesmo identificador pode chegar duas vezes. Descreva como reproduzir a duplicação e proponha uma regra que preserve apenas um efeito para o mesmo pedido.
Não basta esconder a segunda linha na tela. A regra deve atuar no registro da operação. Explique também o que fazer quando o identificador é igual, mas o conteúdo mudou: isso exige tratar um conflito, e não descartar silenciosamente a informação.
Por que aprender
A prática liga revisão, teste e comportamento de negócio. Você aprende a verificar o efeito real da correção e a reconhecer quando duas entradas aparentemente iguais representam situações diferentes.
Seu exercício
O pedido R-14, “revisar catálogo”, chega duas vezes por uma nova tentativa de envio. Depois chega R-14 com “revisar contrato”. Defina o resultado esperado para cada recebimento.
Baixar ficha da práticaConferir resposta comentada
Primeiro R-14: registrar o pedido. Segundo R-14 com conteúdo idêntico: devolver o registro existente, sem duplicar. Terceiro R-14 com conteúdo diferente: sinalizar conflito para revisão. Testar a contagem e o conteúdo armazenado após as três entradas.
Cheque sua compreensão
O revisor escreveu “há risco de duplicação”. O que falta?
Conceitos-chave
O que fica deste módulo
Um relatório curto com um problema reproduzido e sua correção mínima.
- ✓ Duas entradas iguais demonstram o problema.
- ✓ A mesma intenção produz um único efeito.
- ✓ Conteúdo divergente não é descartado silenciosamente.
O progresso registra sua leitura. A prática fica concluída quando você confere a entrega.