Tema

Tamanho do texto

Largura da leitura

Entrelinha

Fonte

Acento

0 de 0 0%

MÓDULO 1.3

Uma segunda opinião que ajuda

Use revisão independente para encontrar falhas reproduzíveis, sem trocar evidência por opinião.

6 tópicos Conceitos e aplicação
~35 minutos Estimativa com prática
Prático Passo a passo
Sua entrega Um relatório curto com um problema reproduzido e sua correção mínima.
ETAPA 1 Mudança ETAPA 2 Revisão ETAPA 3 Reprodução ETAPA 4 Correção ETAPA 1 Mudança ETAPA 2 Revisão ETAPA 3 Reprodução ETAPA 4 Correção
Um relatório curto com um problema reproduzido e sua correção mínima.
1

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

Contrato Comportamento esperado
Diff Mudança entre versões
Hipótese Possível problema a investigar
Reprodução Passos que mostram o efeito
2

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

  1. Descreva a mudança e escolha uma base.
  2. Peça evidência, reproduza e classifique os achados.
  3. Aplique a menor correção e repita o cenário.

Conceitos-chave

Base Versão usada na comparação
Status Arquivos novos e modificados
Escopo O conjunto a revisar
Ajuda local Contrato da CLI instalada
3

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.

Exemplo de trabalho
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

Gatilho Condição que inicia a falha
Efeito Resultado observado
Prioridade Impacto e probabilidade
Correção mínima Mudança suficiente para resolver
4

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

Retry Nova tentativa da mesma operação
Idempotência Repetir sem duplicar o efeito
Atomicidade Completar tudo ou não aplicar
Interrupção Falha entre etapas
5

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érios para conferir sua entrega
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

Caso mínimo Menor entrada que mantém a falha
Histórico Tentativas e resultados
Hipótese única Uma causa testada por vez
Parada Condição objetiva de conclusão
6

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ática
Conferir 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

Identificador Chave estável da solicitação
Duplicação Dois efeitos para a mesma intenção
Conflito Mesma chave com conteúdo diferente
Teste de retorno Repetir o cenário após corrigir

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.