iCode Agent · Guia · Fluxo de trabalho
Refatore um módulo.
Refatorar é, em grande parte, entender: o que chama isto, o que isto chama e o que precisa continuar verdadeiro enquanto a forma muda. O iCode Agent faz esse mapeamento no código real antes de editar qualquer coisa.
A tarefa
Nomeie o módulo e a mudança que você quer, depois deixe o agente mapear o raio de impacto primeiro:
Refactor src/report/builder.ts. Extract the formatting into a separate module, update all callers, and make sure the tests still pass.
Indicar o arquivo delimita o trabalho. Se você não tem certeza de onde a mudança deve ficar, descreva o objetivo e deixe o agente encontrar o limite — mas um alvo nomeado mantém a mudança focada.
O que acontece
- Mapear.
grepefindlocalizam os chamadores do módulo;readmostra o código com números de linha, para que o agente veja a estrutura em vez de adivinhá-la. - Planejar a mudança. Ele identifica o que se move, o que fica e cada chamador que precisa ser atualizado.
- Edite em passos pequenos.
editsubstitui um trecho exato por vez e mostra o diff, para que a revisão veja a mudança, não um arquivo reescrito. - Mantenha os testes verdes. Ele executa sua suíte — a rede de segurança que torna uma refatoração segura em vez de arriscada.
Nada é reescrito por completo: edit altera um trecho alvo e write é usado apenas para arquivos realmente novos. O diff fica sempre visível antes de você aceitar.
Revisando o diff
É aqui que o valor aparece: o agente propõe, você decide. Um bom prompt para uma refatoração pede um raciocínio que você possa conferir, não apenas um resultado:
Refactor the auth module. Show me the callers you found first, then make the smallest change that removes the duplication. Run the tests after each file you touch.
Se uma mudança estiver errada, oriente no meio da tarefa em vez de reverter depois — o agente não fez commit de nada, então um redirecionamento é barato.
Bons prompts para este fluxo de trabalho
Find every caller of parseConfig() before changing its signature. Extract the duplicated retry logic into one helper and update both call sites. Explain what this module does, then suggest a refactor — but make no edits yet.
O último é deliberadamente somente leitura: peça a análise, leia-a e depois peça a mudança. Para uma refatoração grande, esse formato costuma ser melhor.