Pular para o conteúdo principal

Revisar código no VS Code

Objetivo: revisar as mudanças do seu working tree no VS Code, entender os achados, aplicar as correções revisando cada diff e gerar a mensagem de commit — sem sair do editor.

A extensão do Imaginne traz o agente para dentro do VS Code e roteia toda edição por uma área de Proposed Changes, então nada toca o disco sem a sua aprovação. Para a visão completa, veja Usar no VS Code.

Pré-requisitos​

  • O binário imaginne (CLI) instalado e a extensão Imaginne (nnumbers.imaginne) ativa. Veja Instalar VS Code.
  • Estar autenticado (comando Imaginne: Login ou /login no chat).
  • Um repositório Git aberto como workspace, com mudanças para revisar.

Passo a passo​

1. Revisar as mudanças atuais​

Você pode disparar a revisão de duas formas:

  • Pela paleta de comandos: Imaginne: Review Current Changes.
  • Pelo menu da aba Source Control (SCM): a ação de revisão das mudanças atuais.

A extensão coleta o seu diff e o agente analisa o código.

Outros escopos de revisão

Há também Review Staged Changes, Review Branch vs Base e Review File (no explorer). Use o escopo certo para o que você quer auditar.

2. Ler os achados​

Os resultados aparecem no painel Review, organizados por severidade. Cada achado descreve o problema e o local. Use a lista para priorizar — comece pelos itens mais graves.

3. Aplicar correções com /fix​

Para corrigir, peça ao agente diretamente no chat, referenciando o problema:

/fix Corrija o vazamento de recurso apontado em src/db/pool.ts:
o cliente não é liberado quando a query lança exceção.

Para erros que o próprio editor já sinaliza (sublinhados de diagnóstico), use o atalho da lâmpada Fix with Imaginne sobre o diagnóstico — ele envia o /fix já com o contexto do erro.

4. Revisar e aplicar os diffs​

Toda edição proposta entra em Proposed Changes (Composer) antes de ir para o disco. Ali você decide:

  • Diff — veja exatamente o que muda em cada arquivo.
  • Apply / Reject — por arquivo; ou Apply All / Discard All para todos.
  • Hunks — aplique ou rejeite trecho a trecho, se quiser aceitar só parte.

Se um arquivo mudou desde a proposta, a guarda de conflito avisa (selo conflict) para você reavaliar antes de aplicar.

Permissões e limites

Dependendo do nível de autonomia (Ask / Fix / Agent / Bypass), o agente pode pedir confirmação por arquivo ou por comando. Escrever fora do workspace sempre confirma, e comandos destrutivos nunca rodam automaticamente. Veja Autonomia & permissões.

5. Gerar a mensagem de commit​

Com as correções aplicadas, gere a mensagem:

  • Comando Imaginne: Generate Commit Message, ou a mesma ação no menu SCM.
  • No painel Review, use Copy & fill SCM para colar a mensagem direto na caixa de commit.

Revise o texto e faça o commit normalmente pelo Git.

Resultado​

Mudanças revisadas, correções aplicadas (cada diff aprovado por você) e uma mensagem de commit pronta na caixa do SCM. Como tudo passou pelo Composer, o working tree reflete só o que você aceitou.

Veja também​

Usar no VS Code

Chat, Proposed Changes, painéis de Review e Tests, e os modos de autonomia.

Abrir →Autonomia & permissões

Ask/Fix/Agent/Bypass e os limites que sempre valem.

Abrir →Instalar VS Code

Extensão, CLI e configurações.

Abrir →