Outils
Découvre comment Bob Shell utilise des outils spécialisés pour lire des fichiers, modifier du code, exécuter des commandes et interagir avec ton environnement de développement depuis la ligne de commande.
Workflow des outils
Quand tu décris ce que tu veux accomplir en langage naturel, Bob Shell va :
- Sélectionner l'outil approprié en fonction de ta demande.
- Présenter l'outil avec ses paramètres pour ta révision.
- Exécuter l'outil approuvé et t'afficher les résultats.
- Continuer ce processus jusqu'à ce que ta tâche soit terminée.
Catégories d'outils
Les outils de Bob Shell sont organisés en catégories selon leur fonction principale. Comprendre ces catégories t'aide à savoir ce que Bob Shell peut faire et comment il accomplit les tâches.
Outils de lecture
Accède au contenu des fichiers et comprends la structure du code sans effectuer de modifications.
| Outil | Objectif | Exemple d'utilisation |
|---|---|---|
read_file | Lire le contenu d'un ou plusieurs fichiers | Voir les fichiers de configuration, examiner le code source |
search_files | Rechercher des modèles dans plusieurs fichiers avec des expressions régulières | Trouver tous les commentaires TODO, localiser les définitions de fonctions |
list_files | Lister les fichiers et répertoires dans un chemin spécifié | Explorer la structure du projet, trouver des types de fichiers spécifiques |
list_code_definition_names | Extraire les noms de classes, fonctions et méthodes des fichiers source | Obtenir une vue d'ensemble de l'organisation du code |
Quand Bob Shell utilise les outils de lecture : Quand tu demandes à Bob Shell de réviser du code, trouver des modèles spécifiques ou comprendre la structure du projet.
Outils d'écriture
Crée de nouveaux fichiers ou modifie du code existant avec précision.
| Outil | Objectif | Exemple d'utilisation |
|---|---|---|
write_to_file | Créer un nouveau fichier ou réécrire complètement un fichier existant | Générer de nouveaux composants, créer des fichiers de configuration |
apply_diff | Effectuer des changements ciblés sur des sections spécifiques d'un fichier | Mettre à jour la logique d'une fonction, corriger des bugs, refactoriser du code |
insert_content | Ajouter de nouvelles lignes à un emplacement spécifique dans un fichier | Ajouter des imports, insérer de nouvelles fonctions |
Quand Bob Shell utilise les outils d'écriture : Quand tu demandes à Bob Shell de créer des fichiers, implémenter des fonctionnalités, corriger des bugs ou refactoriser du code.
Outils de commandes
Exécute des commandes et effectue des opérations système dans ton terminal.
| Outil | Objectif | Exemple d'utilisation |
|---|---|---|
execute_command | Exécuter des commandes CLI dans ton espace de travail | Installer des dépendances, exécuter des tests, construire des projets |
Quand Bob Shell utilise les outils de commandes : Quand tu demandes à Bob Shell d'exécuter des commandes, installer des packages, exécuter des scripts ou effectuer des opérations système.
Outils MCP
Étend les capacités de Bob Shell via des serveurs Model Context Protocol.
| Outil | Objectif | Exemple d'utilisation |
|---|---|---|
use_mcp_tool | Accéder aux outils fournis par les serveurs MCP connectés | Interroger des bases de données, interagir avec des API, accéder à des services externes |
Outils de mode
Bascule entre différents modes de Bob Shell pour des tâches spécialisées.
| Outil | Objectif | Exemple d'utilisation |
|---|---|---|
switch_mode | Changer vers un mode différent (Agent, Plan, Ask, etc.) | Passer en mode Plan pour la conception d'architecture, mode Agent pour l'implémentation |
Quand Bob Shell utilise les outils de mode : Quand la tâche actuelle bénéficierait des capacités spécialisées d'un autre mode.
Outils de questions
Collecte des informations supplémentaires nécessaires pour accomplir les tâches.
| Outil | Objectif | Exemple d'utilisation |
|---|---|---|
ask_followup_question | Demander des clarifications ou des détails supplémentaires | Demander l'approche d'implémentation préférée, demander des informations manquantes |
Groupes d'outils
Les groupes d'outils sont des collections nommées d'outils connexes que tu peux activer ou désactiver ensemble. Utilise les groupes d'outils pour restreindre ce que Bob Shell peut faire dans une session donnée — par exemple, pour empêcher les écritures de fichiers dans un audit en lecture seule, ou pour désactiver l'exécution de commandes dans un environnement contrôlé.
Groupes d'outils disponibles
| Groupe | Outils inclus | Par défaut en Agent | Par défaut en Plan | Par défaut en Ask |
|---|---|---|---|---|
read | Outils de lecture, recherche et liste de fichiers | ✓ | ✓ | ✓ |
edit | Outils d'écriture et de diff de fichiers | ✓ | ✓ | ✓ |
execute | Outils d'exécution de commandes shell | ✓ | — | — |
mcp | Outils de serveurs MCP | ✓ | ✓ | ✓ |
skill | Outils liés aux skills | ✓ | ✓ | ✓ |
todo | Outils de gestion de liste de tâches | ✓ | ✓ | — |
subagent | Outils de création de sous-agents | ✓ | — | — |
mode | Outils de changement de mode | ✓ | ✓ | ✓ |
Désactiver des groupes d'outils
Passe --disable-tool-groups à bob run ou bob chat avec une liste de noms de groupes séparés par des virgules :
# Désactiver l'exécution de commandes et les outils MCP
bob run --disable-tool-groups execute,mcp "Review @src/"
# Exécuter en mode lecture seule
bob run --disable-tool-groups edit,execute,mcp "Summarize the codebase"Tu peux aussi désactiver tous les serveurs MCP en une seule étape avec le flag dédié :
bob run --disable-mcp "Explain @app.js"