Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Editar Código com o Vibe

Aula 10 de 16 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Descreva, Não Escreva
  2. Reveja Antes de Aceitar
  3. Quando as Alterações Abrangem Vários Ficheiros
  4. Faça Rever o Seu Código
  5. O Que Separa um Bom Prompt de um Mau
  6. Pontos-chave

Atualização de 2 de novembro de 2026 — Devstral. O Devstral 2 (devstral-2512) chegou ao fim da sua vida útil a 31 de julho de 2026, e o Devstral Small 2 a 31 de março de 2026: as chamadas a estes modelos já não estão garantidas. A tabela oficial redireciona-os agora para o Mistral Medium 3.5, que está, por sua vez, preterido em favor do Mistral Large 4. O Codestral (codestral-2508) mantém-se geralmente disponível para conclusão de código. Consulte a tabela de modelos para verificar para onde apontam os aliases -latest antes de executar estes exemplos.

Descreva, Não Escreva

Editar código com o Vibe começa por declarar o que pretende em linguagem natural, sem tentar formular uma instrução técnica:

Add email validation to the registerUser function
Refactor this component to use React hooks instead of classes
Fix the bug in the login handler that doesn't handle timeouts

O agente lê o código existente, compreende o contexto e propõe uma alteração adaptada. Recorre principalmente à ferramenta edit (anteriormente search_replace), que funciona de forma cirúrgica: apenas o bloco relevante é reescrito, deixando o restante ficheiro intocado. Isto evita o temido efeito secundário das reescritas completas de ficheiros, onde uma correção de três linhas vem acompanhada de cinquenta linhas de reformatação indesejada.

Reveja Antes de Aceitar

O Vibe nunca modifica um ficheiro silenciosamente. Apresenta um diff colorido no terminal, utilizando exatamente o formato git diff: as linhas eliminadas aparecem a vermelho prefixadas com -, as linhas adicionadas a verde prefixadas com +, e o contexto circundante permanece visível para que possa localizar a alteração no ficheiro. Qualquer programador lê este formato sem esforço, que é precisamente o objetivo.

Segue-se a aprovação. No modo predefinido, a sequência é fixa: o agente analisa o código e prepara a alteração, apresenta o diff, o utilizador verifica exatamente o que irá mudar e, em seguida, aprova com y ou rejeita com n. Nenhuma alteração chega à sua base de código sem esta etapa. Isto torna a ferramenta segura para código de produção: mantém o controlo final, linha por linha.

Rejeitar não é a sua única opção quando uma proposta está apenas parcialmente correta. A abordagem mais eficiente é corrigir a rota na conversa:

Close, but use a regex instead of split for email parsing

O Vibe ajusta a sua proposta com base no seu feedback e em tudo o que foi dito anteriormente na sessão.

Quando as Alterações Abrangem Vários Ficheiros

As funcionalidades reais raramente residem num único ficheiro, e o Vibe gere esta dispersão sem exigir que fragmente o seu pedido:

Add a /api/users/:id/avatar endpoint with file upload. 
Create the route handler, validation middleware, and unit test.

O agente identifica quais os ficheiros a modificar e quais a criar, prepara as alterações para cada um e submete-as depois para aprovação, ficheiro por ficheiro. Pode aceitar o gestor (handler) mas rejeitar o teste se a sua estrutura não lhe convier.

Faça Rever o Seu Código

A edição é apenas parte do trabalho: o Vibe é igualmente útil para revisões. Peça uma revisão de segurança num ficheiro específico com “Review changes in @src/api/auth.ts and tell me if there are security issues”, uma análise de desempenho com “Analyze this file and suggest performance improvements”, ou uma verificação de estilo com “Verify this code follows TypeScript best practices.” Em cada caso, o agente lê, assinala potenciais problemas e propõe correções fundamentadas.

Para uma auditoria onde qualquer escrita seria inaceitável, não confie na sua própria vigilância no momento da aprovação: basta remover as ferramentas de escrita de um agente dedicado.

# ~/.vibe/agents/reviewer.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]   # edit: formerly search_replace

Execute-o com:

vibe --agent reviewer

Este agente só pode ler e analisar. Esta é a configuração preferida para auditorias de segurança ou para rever o repositório de um contratante.

O Que Separa um Bom Prompt de um Mau

A qualidade da modificação segue diretamente a precisão da instrução. Compare estas duas formulações: a primeira deixa o agente a adivinhar a sua intenção, a segunda não deixa nada para inventar.

# Too vague
Improve this file

# Precise
Add logging with the winston module for errors in the createOrder handler,
logging the HTTP error code and message

O segundo reflexo é designar explicitamente a área alvo com @, como em “In @src/middleware/auth.ts, add a token expiry check before validating the session.” O terceiro é nunca encerrar uma série de alterações sem verificação: peça “Run tests to verify the changes didn’t break anything,” e o agente executará o comando apropriado para o seu projeto—npm test, pytest, cargo test—antes de lhe dizer se tudo passou.

Finalmente, há o caso de aprovar demasiado depressa. Nem tudo está perdido: pode pedir ao agente para desfazer a última alteração em @src/api/auth.ts, ou retomar o controlo via Git sem sair do modo interativo, usando o prefixo ! para executar o comando de shell diretamente.

!git checkout -- src/api/auth.ts

Pontos-chave

  • Descreva as suas alterações em linguagem natural; o Vibe gera o código
  • Diffs coloridos mostram exatamente o que muda antes da aprovação
  • O modo predefinido exige aprovação explícita para cada alteração
  • Alterações em vários ficheiros são geridas automaticamente
  • Um agente só de leitura é ideal para revisão de código
  • Verifique sempre os testes após uma série de alterações