Modalità personalizzate: Code Review, Deploy, Lint
In questa pagina
Lezione aggiornata il 2 novembre 2026. I file degli agenti di esempio utilizzano ora le chiavi documentate da Vibe:
instructions(nonsystem_prompt),active_model(nonmodel), blocchi[tools.<tool>]per le approvazioni (la chiaveauto_approvenon esiste in un file agente) e nomi reali degli strumenti (edit, nonedit_file; nessuno strumentolist_dir). Promemoria dalla Lezione 3:safetyè un indicatore visivo, non un permesso. Fonte: Riferimento configurazione.
Crea modalità su misura per il tuo flusso di lavoro
La lezione sulle modalità unificate ha introdotto il concetto; ora è il momento di metterlo alla prova. Costruiremo tre modalità personalizzate che coprono esigenze ricorrenti per ogni sviluppatore: code review, deployment e linting. Ognuna è un file .toml posizionato in ~/.vibe/agents/, con istruzioni specifiche. Ciò che distingue queste tre modalità non sono tanto le istruzioni, quanto la coppia enabled_tools / [tools.<tool>]: questa decide cosa può toccare Vibe e, di conseguenza, quale rischio corri; safety è semplicemente l’etichetta visiva.
Un revisore che non può rompere nulla
La modalità code review trasforma Vibe in un revisore esigente che analizza la qualità, la sicurezza e la manutenibilità del tuo codice. Poiché si limita a leggere, è contrassegnata come safe e i suoi strumenti di lettura sono impostati su permission = "always": funziona senza interromperti e senza rischi, poiché nessun file verrà modificato. L’elenco degli strumenti mantiene questa promessa: niente write_file, niente edit, niente bash.
# ~/.vibe/agents/review.toml
display_name = "Code Review"
description = "Revisione approfondita del codice: sicurezza, prestazioni, manutenibilità."
safety = "safe"
active_model = "mistral-medium-3.5" # modello integrato in Vibe
instructions = """
Sei un sviluppatore senior in modalità revisione codice.
Processo:
1. Leggi i file modificati (git diff o file specificati)
2. Analizza ogni modifica su 4 assi:
- Sicurezza (injection, XSS, CSRF, segreti esposti)
- Prestazioni (N+1, loop annidati, memoria)
- Manutenibilità (naming, complessità, duplicazione)
- Correttezza (logica, casi limite, tipi)
Formato output:
## 🔴 Critiche (da correggere prima del merge)
## 🟡 Avvertenze (da correggere presto)
## 🟢 Suggerimenti (miglioramenti opzionali)
Per ogni punto: file, riga, problema, correzione proposta.
"""
enabled_tools = [
"read_file",
"grep",
]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Il formato di output imposto nel prompt non è cosmetico: ti permette di distinguere a colpo d’occhio cosa blocca una pull request e cosa può aspettare. Avvii la modalità, poi le fornisci un’istruzione libera o un ambito specifico.
vibe --agent review
# > Analizza i file modificati nel branch corrente
# > /review src/api/
Un deployment che rifiuta di improvvisare
La modalità deploy è l’esatto opposto. Tocca la produzione, quindi è contrassegnata come destructive, e i suoi strumenti di scrittura e bash rimangono a permission = "ask": ogni azione richiede la tua validazione. L’intero valore della modalità risiede nella sequenza fissa del suo prompt e, soprattutto, nelle sue condizioni di arresto. Un deployment improvvisato di venerdì sera inizia sempre con un passo saltato; qui, un test fallito ferma tutto.
# ~/.vibe/agents/deploy.toml
display_name = "Deploy"
description = "Deployment controllato con test, build e verifica."
safety = "destructive"
active_model = "codestral" # alias dichiarato in config.toml (Lezione 2)
instructions = """
Sei in modalità deployment. Segui questa sequenza SENZA ECCEZIONI:
1. VERIFICA — stato git pulito, nessun file non committato
2. TEST — esegui l'intera suite di test
3. BUILD — build di produzione
4. VALIDA — controlla la build (dimensioni, errori, avvisi)
5. CONFERMA — chiedi all'utente prima di continuare
6. DEPLOY — esegui il comando di deployment
7. VERIFICA — conferma che il servizio risponda correttamente
Se un passo fallisce: FERMATI. Spiega il problema e proponi una soluzione.
Non fare mai il deploy se i test falliscono.
Non fare mai il deploy se la build contiene avvisi critici.
"""
enabled_tools = [
"read_file",
"write_file",
"bash",
"grep",
"ask_user_question"
]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
La presenza di ask_user_question negli strumenti è essenziale: senza di essa, il passo 5 sarebbe un’illusione, poiché l’agente non avrebbe alcun modo tecnico per interrogarti.
vibe --agent deploy
# > Segue la sequenza test → build → deploy → verifica
Pulizia automatica ma disciplinata
Tra le due si colloca la modalità lint, che automatizza la formattazione, le convenzioni e l’ordinamento degli import. Modifica i file, quindi è neutral, ma le sue correzioni sono meccaniche e reversibili tramite Git: approvare i suoi strumenti a priori (permission = "always") ti risparmia cinquanta clic. Se il suo elenco include bash, fallo solo in un ambiente isolato, oppure limita bash a una allowlist di soli comandi di lint. Le tre regole alla fine del prompt sono ciò che impedisce di andare fuori strada: un agente lasciato libero installerà rapidamente Biome in un progetto che vive perfettamente bene con ESLint.
# ~/.vibe/agents/lint.toml
display_name = "Lint & Fix"
description = "Pulizia automatica: lint, formattazione, import, convenzioni."
safety = "neutral"
active_model = "codestral" # alias dichiarato in config.toml (Lezione 2)
instructions = """
Sei in modalità pulizia codice.
Compiti:
1. Rileva gli strumenti del progetto (ESLint, Biome, Prettier, oxlint)
2. Esegui lint con auto-fix
3. Esegui la formattazione
4. Ordina e pulisci gli import
5. Rimuovi il codice morto rilevabile
6. Segnala gli errori che non possono essere corretti automaticamente
Regole:
- Usa gli strumenti già configurati nel progetto
- Non modificare la configurazione degli strumenti
- Non aggiungere nuovi strumenti senza chiedere
"""
enabled_tools = [
"read_file",
"edit",
"bash",
"grep",
]
[tools.read_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.bash]
permission = "always" # riservare solo ad ambienti isolati
[tools.grep]
permission = "always"
Altre due modalità e una regola di organizzazione
Lo stesso ragionamento si applica ad altre esigenze. Una modalità documentazione rimane neutral ma mantiene write_file ed edit a "ask", perché generare file in un repository merita uno sguardo prima della scrittura.
# ~/.vibe/agents/docs.toml
display_name = "Documentation"
description = "Genera e aggiorna la documentazione tecnica."
safety = "neutral"
active_model = "mistral-medium-3.5" # modello integrato in Vibe
instructions = """
Genera documentazione tecnica. Per ogni file:
- JSDoc/TSDoc per le funzioni pubbliche
- README con esempi di utilizzo
- Variabili d'ambiente documentate
- Schema API se applicabile
"""
enabled_tools = ["read_file", "write_file", "edit", "grep",]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
Una modalità migrazione, invece, si unisce a deploy nella categoria destructive: una migrazione dello schema andata male non può essere annullata con un git revert, da qui la necessità di uno script di rollback sistematico.
# ~/.vibe/agents/migrate.toml
display_name = "Migration"
description = "Gestisce le migrazioni di database e dipendenze."
safety = "destructive"
active_model = "mistral-medium-3.5" # modello integrato in Vibe
instructions = """
Gestisci le migrazioni. Regole assolute:
- Genera sempre uno script di rollback
- Testa la migrazione su una copia prima della produzione
- Documenta ogni modifica allo schema
"""
enabled_tools = ["read_file", "write_file", "bash", "grep", "ask_user_question"]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Infine, organizza la tua directory degli agenti in modo che la criticità sia leggibile nella struttura stessa dell’albero. Quando cambi modalità tramite tastiera a metà sessione, devi sapere senza pensarci se la modalità appena attivata può scrivere sul tuo disco.
~/.vibe/agents/
├── review.toml # safe — sola lettura
├── lint.toml # neutral — modifiche controllate
├── docs.toml # neutral — generazione file
├── deploy.toml # destructive — con conferma
└── migrate.toml # destructive — con conferma
Punti chiave
- Ogni modalità è un file
.tomlin~/.vibe/agents/progettato per un flusso di lavoro specifico - La modalità review ha solo strumenti di lettura, approvati a priori: può solo leggere
- La modalità deploy mantiene
bashe la scrittura a"ask": chiede conferma - La modalità lint approva i suoi strumenti di modifica a priori: corregge automaticamente
- Regola
active_modelin base alla complessità del compito - Le
instructionssono fondamentali: sii preciso sulla sequenza e sulle regole