iCode Agent · Guia · Fluxo de trabalho

Rastreie um bug.

A parte difícil de um bug geralmente não é a correção — é encontrar a causa. O iCode Agent segue as evidências pelo código e conta o que encontrou, em vez de adivinhar um patch.

A tarefa

Descreva o sintoma e, se puder, como reproduzi-lo:

Users report that saving a duplicate name overwrites the original.
Reproduce it, find the cause, then fix it.

Uma reprodução é a entrada mais valiosa que você pode fornecer. Sem uma, peça ao agente para encontrar ou escrever uma primeiro — um bug que você não consegue disparar é um bug que você não consegue confirmar que corrigiu.

O que acontece

  1. Reproduzir. Ele executa o comando ou teste que falha e lê a saída real — um stack trace, um erro, um valor errado.
  2. Siga as evidências. Ele rastreia do sintoma de volta à causa: o código que chama, os dados, o estado. Uma falha é informação, e ele continua puxando o fio.
  3. Nomeie a causa. Ele explica o que está errado e por quê, com o código que mostra isso — não apenas onde aplicar a correção.
  4. Corrigir e verificar. Ele faz a menor mudança que resolve a causa e executa novamente a verificação que falhou.

Pergunte antes de aceitar a correção

Um patch que faz um sintoma desaparecer não é o mesmo que um bug corrigido. Peça o raciocínio e pergunte se a causa foi tratada:

Reproduce the failure in tests, explain the root cause, then fix it.
Don't change the test to make it pass — the test is correct.
Show me every place this same bug could occur.

Essa última linha importa: uma boa caça a bugs pergunta se este é um caso de um padrão, não algo isolado.

Quando a resposta é “não consigo reproduzir”

Esse é um resultado útil, não uma falha. O agente dirá o que tentou e o que observou. A partir daí, você pode restringir o ambiente, fornecer uma entrada que dispare o problema ou pedir instrumentação para registrar o estado no ponto onde você espera o bug.