Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Modifica il codice con Vibe

Lezione 10 di 16 Aggiornata il 2 novembre 2026 Sviluppatore
In questa pagina
  1. Descrivi, non scrivere
  2. Rivedi prima di accettare
  3. Quando le modifiche riguardano più file
  4. Fai revisionare il tuo codice
  5. Cosa separa un buon prompt da uno cattivo
  6. Punti chiave

Aggiornamento 2 novembre 2026 — Devstral. Devstral 2 (devstral-2512) ha raggiunto la fine del supporto il 31 luglio 2026 e Devstral Small 2 il 31 marzo 2026: le chiamate a questi modelli non sono più garantite. La tabella ufficiale li reindirizza ora a Mistral Medium 3.5, che è a sua volta deprecato a favore di Mistral Large 4. Codestral (codestral-2508) rimane generalmente disponibile per il completamento del codice. Consulta la tabella dei modelli per verificare dove puntano gli alias -latest prima di eseguire questi esempi.

Descrivi, non scrivere

Modificare il codice con Vibe inizia dicendo cosa vuoi in linguaggio naturale, senza cercare di formulare un’istruzione tecnica:

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

L’agente legge il codice esistente, comprende il contesto e propone una modifica su misura. Si basa principalmente sullo strumento edit (precedentemente search_replace), che opera in modo chirurgico: riscrive solo il blocco rilevante, lasciando intatto il resto del file. Questo evita il temuto effetto collaterale delle riscritture complete del file, dove una correzione di tre righe si trascina dietro cinquanta righe di riformattazione indesiderata.

Rivedi prima di accettare

Vibe non modifica mai un file silenziosamente. Mostra una diff colorata nel terminale, utilizzando esattamente il formato git diff: le righe eliminate appaiono in rosso prefissate da -, quelle aggiunte in verde prefissate da +, e il contesto circostante rimane visibile per permetterti di localizzare la modifica nel file. Ogni sviluppatore legge questo formato senza sforzo, ed è proprio questo l’obiettivo.

Segue l’approvazione. In modalità predefinita, la sequenza è fissa: l’agente analizza il codice e prepara la modifica, mostra la diff, tu verifichi esattamente cosa cambierà, poi approvi con y o rifiuti con n. Nessuna modifica raggiunge il tuo codebase senza questo passaggio. Questo rende lo strumento sicuro per il codice di produzione: mantieni il controllo finale, riga per riga.

Rifiutare non è l’unica opzione quando una proposta è solo parzialmente corretta. L’approccio più efficiente è correggere il tiro nella conversazione:

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

Vibe adatta la sua proposta in base al tuo feedback e a tutto ciò che è stato detto in precedenza nella sessione.

Quando le modifiche riguardano più file

Le funzionalità reali raramente vivono in un singolo file e Vibe gestisce questa distribuzione senza costringerti a frammentare la tua richiesta:

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

L’agente identifica quali file modificare e quali creare, prepara le modifiche per ciascuno e poi le sottopone all’approvazione file per file. Puoi accettare il gestore ma rifiutare il test se la sua struttura non ti convince.

Fai revisionare il tuo codice

La modifica è solo una parte del lavoro: Vibe è altrettanto utile per le revisioni. Chiedi una revisione di sicurezza su un file specifico con “Review changes in @src/api/auth.ts and tell me if there are security issues”, un’analisi delle prestazioni con “Analyze this file and suggest performance improvements”, o un controllo di stile con “Verify this code follows TypeScript best practices”. In ogni caso, l’agente legge, segnala potenziali problemi e propone correzioni motivate.

Per un audit in cui qualsiasi scrittura sarebbe inaccettabile, non affidarti alla tua sola vigilanza al momento dell’approvazione: rimuovi semplicemente gli strumenti di scrittura da un agente dedicato.

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

Eseguilo con:

vibe --agent reviewer

Questo agente può solo leggere e analizzare. Questa è la configurazione preferita per gli audit di sicurezza o per la revisione del repository di un collaboratore esterno.

Cosa separa un buon prompt da uno cattivo

La qualità della modifica dipende direttamente dalla precisione dell’istruzione. Confronta queste due formulazioni: la prima lascia l’agente nell’incertezza sulle tue intenzioni, la seconda non lascia nulla all’invenzione.

# 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

Il secondo riflesso è designare esplicitamente l’area target con @, come in “In @src/middleware/auth.ts, add a token expiry check before validating the session.” Il terzo è non chiudere mai una serie di modifiche senza verifica: chiedi “Run tests to verify the changes didn’t break anything” e l’agente eseguirà il comando appropriato per il tuo progetto—npm test, pytest, cargo test—prima di dirti se tutto è passato.

Infine, c’è il caso dell’approvazione troppo rapida. Non tutto è perduto: puoi chiedere all’agente di annullare l’ultima modifica in @src/api/auth.ts, oppure riprendere il controllo tramite Git senza uscire dalla modalità interattiva, usando il prefisso ! per eseguire direttamente il comando di shell.

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

Punti chiave

  • Descrivi le tue modifiche in linguaggio naturale; Vibe genera il codice
  • Le diff colorate mostrano esattamente cosa cambia prima dell’approvazione
  • La modalità predefinita richiede un’approvazione esplicita per ogni modifica
  • Le modifiche su più file sono gestite automaticamente
  • Un agente in sola lettura è ideale per la revisione del codice
  • Verifica sempre i test dopo una serie di modifiche