Modalità unificate: combina strumenti, permessi e comportamenti
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.
Il concetto di modalità unificate
Gli agenti personalizzati trattati nelle lezioni precedenti definiscono un profilo statico: un modello, un insieme di strumenti e un livello di sicurezza. Le modalità unificate vanno oltre, combinando più dimensioni in un’unica configurazione coerente che puoi attivare con un solo gesto. Una modalità unifica raggruppa strumenti autorizzati, permessi specifici, comportamenti guidati dal prompt di sistema, regole di approvazione automatica e restrizioni contestuali.
Il valore diventa evidente quando il tuo lavoro cambia più volte nell’arco della giornata. Senza modalità unificate, devi gestire manualmente diverse impostazioni ogni volta che il contesto cambia: passi dalla revisione del codice al deployment e devi scambiare agenti, adattare i permessi e modificare il prompt. Una modalità unificata incapsula tutto ciò in un unico profilo, che attivi all’avvio o a metà sessione.
# Abilita la modalità "deploy"
vibe --agent deploy-mode
# Passa alla modalità "review"
# Shift+Tab → seleziona review-mode
Struttura di una modalità unificata
Tecnicamente, una modalità unificata è un agente personalizzato; la differenza rispetto a un agente classico è concettuale. Non progetti più il file .toml come “un assistente che può fare X”, ma come un contesto di lavoro completo: cosa ti è consentito fare durante questa fase del progetto, con quale livello di cautela e in quale forma ti vengono restituiti i risultati.
La modalità di revisione qui sotto illustra questo concetto nel modo più chiaro. È di sola lettura, quindi viene approvata automaticamente senza rischi, e il suo prompt impone un formato di report che puoi inserire direttamente in una pull request.
# ~/.vibe/agents/review-mode.toml
display_name = "Review Mode"
description = "Modalità revisione codice: sola lettura, analisi approfondita, suggerimenti."
safety = "safe"
active_model = "mistral-medium-3.5" # modello integrato in Vibe
instructions = """
Sei in modalità revisione codice.
Obiettivo: analizzare qualità, sicurezza e manutenibilità del codice.
Regole:
- Non modificare mai i file
- Produrre un report strutturato (problemi critici, avvisi, suggerimenti)
- Citare le righe di codice interessate con i relativi numeri di riga
- Proporre correzioni come diff
Formato output: Markdown con sezioni Critical / Warning / Suggestion
"""
enabled_tools = [
"read_file",
"grep",
]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
La modalità di deployment è il suo esatto opposto, e questo contrasto è intenzionale. Include bash, quindi può rompere qualcosa, ma i suoi permessi ask su write_file e bash ti mantengono nel ciclo decisionale, e il suo prompt descrive una sequenza rigorosa che l’agente deve seguire dall’inizio alla fine.
# ~/.vibe/agents/deploy-mode.toml
display_name = "Deploy Mode"
description = "Modalità deployment: build, test, deploy con validazione a ogni passo."
safety = "destructive"
active_model = "codestral" # alias dichiarato in config.toml (Lezione 2)
instructions = """
Sei in modalità deployment.
Sequenza obbligatoria:
1. Verifica che tutti i test passino
2. Esegui la build del progetto
3. Valida la build (nessun errore, nessun avviso)
4. Richiedi conferma prima del deployment effettivo
5. Esegui il deployment
6. Verifica che il servizio risponda
Non eseguire mai il deployment se i test falliscono.
"""
enabled_tools = [
"read_file",
"write_file",
"bash",
"grep",
"ask_user_question"
]
[tools.write_file]
permission = "ask"
[tools.bash]
permission = "ask"
Progettazione di modalità complementari
L’idea è creare un insieme di modalità che coprano il tuo ciclo di sviluppo, dalla scoperta alla correzione. La modalità Esplorazione apre la strada: di sola lettura e approvata automaticamente, ti aiuta a comprendere un repository prima di toccarlo.
display_name = "Explore Mode"
safety = "safe"
instructions = """Esplora il codebase, identifica l'architettura, i pattern e le dipendenze."""
enabled_tools = ["read_file", "grep",]
[tools.read_file]
permission = "always"
[tools.grep]
permission = "always"
Segue la modalità Dev, dove passerai la maggior parte del tuo tempo. Scrive ed esegue comandi—per eseguire i test, ad esempio—ma chiede la tua approvazione e il suo prompt lega ogni modifica alla scrittura di test.
display_name = "Dev Mode"
safety = "neutral"
instructions = """Implementa le funzionalità richieste. Scrivi test per ogni modifica."""
enabled_tools = ["read_file", "write_file", "edit", "bash", "grep",]
[tools.write_file]
permission = "ask"
[tools.edit]
permission = "ask"
[tools.bash]
permission = "ask"
Infine, la modalità Fix è deliberatamente ristretta. Niente write_file, solo edit: l’agente modifica il codice esistente senza creare nuovi file, il che gli impedisce di “rifattorizzare strada facendo” un bug che ti ha semplicemente chiesto di correggere. Poiché è così vincolata, possiamo approvarla automaticamente in sicurezza.
display_name = "Fix Mode"
safety = "neutral"
instructions = """Correggi i bug segnalati. Minimizza le modifiche. Tocca solo il codice interessato."""
enabled_tools = ["read_file", "edit", "grep"]
[tools.read_file]
permission = "always"
[tools.edit]
permission = "always"
[tools.grep]
permission = "always"
Passaggio tra le modalità e organizzazione
In una sessione interattiva, Shift+Tab cicla tra le modalità: Vibe visualizza l’elenco di tutti i tuoi agenti, integrati e personalizzati, con le loro descrizioni—è qui che le descrizioni accurate della lezione precedente danno i loro frutti. Dalla riga di comando, avvii direttamente in una modalità oppure ispezioni il contenuto della directory degli agenti.
# Avvia direttamente in una modalità
vibe --agent review-mode
# Elenca gli agenti disponibili
ls ~/.vibe/agents/
Infine, adotta una convenzione di denominazione chiara. Il suffisso -mode distingue immediatamente i tuoi contesti di lavoro dagli agenti utility più ad hoc, e l’ordine alfabetico della directory rimane leggibile anche dopo una dozzina di file.
~/.vibe/agents/
├── review-mode.toml # Revisione codice
├── deploy-mode.toml # Deployment
├── dev-mode.toml # Sviluppo
├── fix-mode.toml # Correzioni
├── explore-mode.toml # Esplorazione
└── doc-mode.toml # Documentazione
Punti chiave
- Una modalità unificata è un agente personalizzato progettato come un contesto di lavoro completo
- Combina strumenti, permessi, prompt di sistema e modello in un’unica configurazione
- Crea modalità complementari per coprire il tuo ciclo di sviluppo
Shift+Tabti permette di passare tra le modalità in tempo reale- Dai nomi coerenti ai tuoi file per trovarli facilmente
- Ogni modalità deve avere un obiettivo chiaro e permessi appropriati