Como ler de verdade o código que seu agente de IA escreveu

说明与用途

审查 AI 代理生成的代码需要结构化方法：确定更改格式，查看 diff 统计信息，按依赖顺序阅读文件，验证逻辑，并保持审查步骤小。

问题

Revisar código gerado por agentes de IA pode ser confuso quando o resumo e o diff não coincidem, levando a merges sem revisão adequada.

结果

A adoção desse fluxo de revisão reduz a probabilidade de merges com código inesperado ou incompleto, aumentando a confiança nos resultados gerados por agentes de IA.

工作流

• Identificar o formato de saída do agente (commit, branch ou mudanças locais).
• Executar git diff --stat e git diff --name-status para visão geral.
• Perguntar: todos os arquivos esperados? Onde está o peso? Testes foram alterados?
• Ordenar a leitura por dependências: contratos, lógica, chamadas, testes.
• Abrir funções afetadas para contexto completo.
• Verificar se o código resolve a causa do bug, não apenas o sintoma.
• Confirmar chamadas e definições de funções citadas no resumo.
• Revisar em etapas pequenas, pedindo commits a cada passo lógico.
• Usar ferramentas auxiliares como Yenpo para diffs inline e navegação de definição.
• Executar testes para garantir que todos passam.
• Merge apenas após confirmação de que o resumo e o código estão alinhados.

证据

Uma sessão com um agente termina com um resumo animado e um diff que mexe em um monte de arquivos.

来源

O resumo diz o que o agente pretendia fazer; o diff mostra o que ele fez de fato, e as duas coisas nem sempre batem.

来源

Antes de ler qualquer hunk, tenha uma visão geral: git diff --stat main...feature e git diff --name-status main...feature

来源

Leia na ordem das dependências, com o código ao redor aberto.

来源

Mantenha os checkpoints pequenos

来源