Scopri come Bob Shell usa strumenti specializzati per leggere file, modificare codice, eseguire comandi e interagire con il tuo ambiente di sviluppo dalla riga di comando.

Flusso di lavoro degli strumenti

Quando descrivi cosa vuoi fare in linguaggio naturale, Bob Shell:

Seleziona lo strumento appropriato in base alla tua richiesta.

Presenta lo strumento con i suoi parametri per la tua revisione.

Esegue lo strumento approvato e ti mostra i risultati.

Continua questo processo finché il tuo task non è completato.

Categorie di strumenti

Gli strumenti di Bob Shell sono organizzati in categorie in base alla loro funzione principale. Capire queste categorie ti aiuta a sapere cosa può fare Bob Shell e come svolge i task.

Strumenti di lettura

Accedi al contenuto dei file e comprendi la struttura del codice senza apportare modifiche.

Strumento	Scopo	Esempio di utilizzo
`read_file`	Legge il contenuto di uno o più file	Visualizzare i file di configurazione, esaminare il codice sorgente
`search_files`	Cerca pattern in più file usando regex	Trovare tutti i commenti TODO, localizzare le definizioni delle funzioni
`list_files`	Elenca file e directory in un percorso specificato	Esplorare la struttura del progetto, trovare tipi di file specifici
`list_code_definition_names`	Estrae i nomi di classi, funzioni e metodi dai file sorgente	Ottenere una panoramica dell'organizzazione del codice

Quando Bob Shell usa gli strumenti di lettura: Quando gli chiedi di revisionare il codice, trovare pattern specifici o capire la struttura del progetto.

Strumenti di scrittura

Crea nuovi file o modifica il codice esistente con precisione.

Strumento	Scopo	Esempio di utilizzo
`write_to_file`	Crea un nuovo file o riscrive completamente un file esistente	Generare nuovi componenti, creare file di configurazione
`apply_diff`	Apporta modifiche mirate a sezioni specifiche di un file	Aggiornare la logica delle funzioni, correggere bug, effettuare refactoring del codice
`insert_content`	Aggiunge nuove righe in una posizione specifica di un file	Aggiungere import, inserire nuove funzioni

Quando Bob Shell usa gli strumenti di scrittura: Quando gli chiedi di creare file, implementare funzionalità, correggere bug o effettuare refactoring del codice.

Strumenti per i comandi

Esegui comandi ed effettua operazioni di sistema nel tuo terminale.

Strumento	Scopo	Esempio di utilizzo
`execute_command`	Esegue comandi CLI nel tuo workspace	Installare dipendenze, eseguire test, compilare progetti

Quando Bob Shell usa gli strumenti per i comandi: Quando gli chiedi di eseguire comandi, installare pacchetti, eseguire script o completare operazioni di sistema.

Strumenti MCP

Estendi le capacità di Bob Shell tramite server Model Context Protocol.

Strumento	Scopo	Esempio di utilizzo
`use_mcp_tool`	Accede agli strumenti forniti dai server MCP connessi	Interrogare database, interagire con API, accedere a servizi esterni

Strumenti per le modalità

Passa tra diverse modalità di Bob Shell per task specializzati.

Strumento	Scopo	Esempio di utilizzo
`switch_mode`	Cambia a una modalità diversa (Agent, Plan, Ask, e così via)	Passa alla modalità Plan per la progettazione dell'architettura, alla modalità Agent per l'implementazione

Quando Bob Shell usa gli strumenti per le modalità: Quando il task corrente beneficerebbe delle capacità specializzate di una modalità diversa.

Strumenti per le domande

Raccoglie le informazioni aggiuntive necessarie per completare i task.

Strumento	Scopo	Esempio di utilizzo
`ask_followup_question`	Richiede chiarimenti o dettagli aggiuntivi	Chiedere informazioni sull'approccio di implementazione preferito, richiedere informazioni mancanti

I gruppi di strumenti sono raccolte con nome di strumenti correlati che puoi abilitare o disabilitare insieme. Usa i gruppi di strumenti per limitare ciò che Bob Shell può fare in una determinata sessione — per esempio, per impedire la scrittura di file in un audit in sola lettura, o per disabilitare l'esecuzione di comandi in un ambiente controllato.

Gruppi di strumenti disponibili

Gruppo	Strumenti inclusi	Predefinito in Agent	Predefinito in Plan	Predefinito in Ask
`read`	Strumenti di lettura, ricerca e listing dei file	✓	✓	✓
`edit`	Strumenti di scrittura e diff dei file	✓	✓	✓
`execute`	Strumenti di esecuzione dei comandi shell	✓	—	—
`mcp`	Strumenti dei server MCP	✓	✓	✓
`skill`	Strumenti correlati alle skill	✓	✓	✓
`todo`	Strumenti di gestione delle liste to-do	✓	✓	—
`subagent`	Strumenti di creazione dei subagent	✓	—	—
`mode`	Strumenti di cambio modalità	✓	✓	✓

Disabilitare i gruppi di strumenti

Passa --disable-tool-groups a bob run o bob chat con un elenco separato da virgole di nomi di gruppi:

# Disabilita l'esecuzione di comandi e gli strumenti MCP
bob run --disable-tool-groups execute,mcp "Review @src/"

# Esegui in modalità sola lettura
bob run --disable-tool-groups edit,execute,mcp "Summarize the codebase"

Puoi anche disabilitare tutti i server MCP in un solo passaggio con il flag dedicato:

bob run --disable-mcp "Explain @app.js"

Strumenti

In questa pagina