IBM Bob
Configurazione

Modalità personalizzate

Personalizza il comportamento di Bob creando modalità personalizzate con ruoli specializzati, restrizioni degli strumenti e flussi di lavoro di team. Configurale globalmente o per progetto usando il formato YAML.

Perché usare modalità personalizzate

  • Specializzazione: Ottimizza le modalità per attività specifiche come generazione di documentazione, ingegneria dei test o revisioni di sicurezza
    •
  • Sicurezza: Limita i comandi o l'accesso ai file per operazioni sensibili
    •
  • Collaborazione di team: Condividi flussi di lavoro standardizzati nel tuo team
    •
  • Sperimentazione: Testa diverse configurazioni senza influenzare altre modalità
    •

Componenti della modalità

ComponenteDescrizione
SlugIdentificatore univoco utilizzato internamente e per file di istruzioni specifici della modalità
NomeNome visualizzato mostrato nell'interfaccia di Bob
Definizione del ruoloIdentità ed esperienza principale che definisce la personalità e il comportamento di Bob
Quando usare(Opzionale) Guida su quando usare questa modalità, utilizzata dall'Orchestrator per il coordinamento delle attività
Strumenti disponibiliGruppi di strumenti e permessi di accesso ai file che la modalità può utilizzare
Regole personalizzate(Opzionale) Linee guida o regole comportamentali aggiuntive

Come creare modalità personalizzate

Puoi creare modalità personalizzate chiedendo a Bob con la modalità "Mode writer", utilizzando il menu delle impostazioni o modificando manualmente i file di configurazione.

Utilizzare la modalità "Mode writer"

  1. Fai clic sull'icona nel pannello Bob per aprire le impostazioni.
    2.
  2. Seleziona la scheda Modalità.
    3.
  3. Fai clic sul pulsante per creare una nuova modalità.
    4.

Utilizzare il menu delle impostazioni

  1. Fai clic sull'icona nel pannello Bob per aprire le impostazioni.
    2.
  2. Seleziona la scheda Modalità.
    3.
  3. Fai clic sul pulsante per creare una nuova modalità.
    4.
  4. Compila i campi per Nome, Slug, Posizione di salvataggio, Definizione del ruolo, Quando usare (opzionale), Descrizione (opzionale), Strumenti disponibili e Istruzioni personalizzate.
    5.
  5. Fai clic su Salva.
    6.

Bob salva la nuova modalità in formato YAML. Puoi aggiungere restrizioni sui tipi di file per il gruppo di strumenti edit tramite configurazione manuale YAML.

Modificare manualmente i file di configurazione

Puoi modificare manualmente i file di configurazione delle modalità in formato YAML:
  • Modalità globali: Modifica ~/.bob/settings/custom_modes.yaml tramite Impostazioni → Modalità → Modifica modalità globali
    •
  • Modalità di progetto: Modifica .bob/custom_modes.yaml nel tuo progetto. Fai clic su Impostazioni → Modalità → Modifica modalità di progetto
    •

Questi file definiscono un array di modalità personalizzate in formato YAML.

Esempio (~/.bob/settings/custom_modes.yaml o .bob/custom_modes.yaml):

 
customModes:
  - slug: docs-writer
    name: 📝 Scrittore di documentazione
    roleDefinition: Sei un redattore tecnico specializzato in documentazione chiara.
    whenToUse: Usa questa modalità per scrivere e modificare la documentazione.
    customInstructions: Concentrati sulla chiarezza e completezza nella documentazione.
    groups:
      - read
      - - edit
        - fileRegex: \.(md|mdx)$
          description: Solo file Markdown
      - browser

Proprietà di configurazione della modalità

Gruppi di strumenti disponibili

  • read: Leggere file e directory
    •
  • edit: Modificare file (può essere limitato con fileRegex)
    •
  • browser: Utilizzare l'automazione del browser
    •
  • command: Eseguire comandi terminale
    •
  • mcp: Accedere ai server MCP
    •
  • skill: Accedere agli skill
    •
  • workflow: Avviare workflow predefiniti
    •

Restrizioni sui file per lo strumento di modifica

Limita quali file una modalità può modificare con fileRegex in formato YAML (backslash singolo):

 
groups:
  - read
  - - edit
    - fileRegex: \.(js|ts)$
      description: Solo file JavaScript e TypeScript

Pattern regex comuni

PatternCorrisponde aFile di esempio
\.md$File Markdownreadme.md, docs/guide.md
^src/.*File nella directory srcsrc/app.js, src/components/button.tsx
\.(css|scss)$File CSS e SCSSstyles.css, theme.scss
^(?!.*(test|spec)).*\.(js|ts)$File JS/TS senza testapp.js, utils.ts (non app.test.js)
Suggerimento:

Chiedi a Bob di generare pattern regex per te invece di scriverli manualmente.

Aggiungere istruzioni specifiche della modalità

Puoi aggiungere istruzioni specifiche della modalità utilizzando una struttura di directory (preferita) o un singolo file.

Metodo preferito (struttura di directory):
01-style-guide.md
02-formatting.txt

Metodo alternativo (file singolo):

 
.bobrules-{mode-slug}

Il metodo della directory ha la precedenza se entrambi esistono. I file nella directory vengono caricati alfabeticamente e combinati con la proprietà customInstructions dalla configurazione della tua modalità.

Per aggiungere istruzioni specifiche della modalità:
  1. Crea una directory .bob/rules-{mode-slug}/ nella radice del tuo progetto (o un file .bobrules-{mode-slug}).
    2.
  2. Aggiungi file di istruzioni alla directory (ad es. 01-style-guide.md e 02-formatting.txt).
    3.

Bob carica automaticamente queste istruzioni quando usi la modalità.

Come sovrascrivere le modalità predefinite

Puoi sovrascrivere le modalità Bob predefinite (come Agent, Ask o Plan) creando una modalità personalizzata con lo stesso slug nella configurazione del tuo progetto.

Per sovrascrivere una modalità predefinita:
  1. Fai clic sull'icona nel pannello Bob per aprire le impostazioni.
    2.
  2. Seleziona la scheda Modalità.
    3.
  3. Fai clic su Modifica modalità di progetto per modificare il file .bob/custom_modes.yaml.
    4.
  4. Aggiungi la configurazione della tua modalità con lo slug della modalità predefinita che vuoi sovrascrivere:
    5.  
customModes:
  - slug: ask  # Corrisponde alla modalità Ask predefinita
    name: ❓ Ask
    roleDefinition: Sei un assistente esperto per questa codebase React e TypeScript.
    whenToUse: Usa questa modalità per fare domande sulla codebase.
    customInstructions: Fai sempre riferimento ai file rilevanti nelle tue risposte. Suggerisci la modalità Ask se l'utente prova a fare modifiche.
    groups:
      - read
      - mcp
      - skill

Le sovrascritture specifiche del progetto hanno la precedenza sulle sovrascritture globali, che hanno la precedenza sui valori predefiniti.

Formato YAML

YAML è il formato preferito e raccomandato per le modalità personalizzate:

Vantaggi di YAML:
  • Più leggibile con struttura basata su indentazione
    •
  • Supporta commenti (#)
    •
  • Sintassi più pulita per stringhe multilinea
    •
  • Richiede meno punteggiatura
    •
  • Più facile da modificare e mantenere
    •

Migrazione automatica:
  • Modalità globali: Migrate automaticamente da custom_modes.json legacy a custom_modes.yaml all'avvio
    •
  • Modalità di progetto: Convertite in YAML quando modificate tramite l'interfaccia utente
    •

Sebbene i file in formato JSON legacy siano ancora supportati per retrocompatibilità, tutte le nuove modalità dovrebbero essere create in formato YAML.

Per saperne di più

Prova direttamente ed estendi le capacità di Bob creando una modalità personalizzata per product manager.

Come valuti questo argomento?

Ignorare file

Controlla a quali file Bob può accedere creando un file `.bobignore` nel tuo progetto.

Persona agenti

Crea file di persona riutilizzabili che definiscono il ruolo, il focus e l'accesso ai tool di un subagent. Definisci cosa cerca un subagent, come formatta il suo output e cosa non può fare.

In questa pagina

Perché usare modalità personalizzateComponenti della modalitàCome creare modalità personalizzateUtilizzare la modalità "Mode writer"Utilizzare il menu delle impostazioniModificare manualmente i file di configurazioneProprietà di configurazione della modalitàGruppi di strumenti disponibiliRestrizioni sui file per lo strumento di modificaPattern regex comuniAggiungere istruzioni specifiche della modalitàCome sovrascrivere le modalità predefiniteFormato YAMLPer saperne di più