Tools
Erfahre, wie Bob Shell spezialisierte Tools verwendet, um Dateien zu lesen, Code zu bearbeiten, Befehle auszuführen und von der Befehlszeile aus mit deiner Entwicklungsumgebung zu interagieren.
Tool-Workflow
Wenn du beschreibst, was du erreichen möchtest, wird Bob Shell:
- Das passende Tool basierend auf deiner Anfrage auswählen.
- Das Tool mit seinen Parametern zur Überprüfung präsentieren.
- Das genehmigte Tool ausführen und dir die Ergebnisse zeigen.
- Diesen Prozess fortsetzen, bis deine Aufgabe abgeschlossen ist.
Tool-Kategorien
Bobs Tools sind nach ihrer primären Funktion in Kategorien eingeteilt. Das Verständnis dieser Kategorien hilft dir zu wissen, was Bob Shell kann und wie es Aufgaben erledigt.
Lese-Tools
Zugriff auf Dateiinhalt und Verständnis der Code-Struktur ohne Änderungen vorzunehmen.
| Tool | Zweck | Beispielanwendung |
|---|---|---|
read_file | Inhalt einer oder mehrerer Dateien lesen | Konfigurationsdateien ansehen, Quellcode untersuchen |
search_files | Muster in mehreren Dateien mit Regex suchen | Alle TODO-Kommentare finden, Funktionsdefinitionen lokalisieren |
list_files | Dateien und Verzeichnisse in einem angegebenen Pfad auflisten | Projektstruktur erkunden, bestimmte Dateitypen finden |
list_code_definition_names | Klassen-, Funktions- und Methodennamen aus Quelldateien extrahieren | Überblick über die Code-Organisation erhalten |
Wann Bob Shell Lese-Tools verwendet: Wenn du Bob Shell bittest, Code zu überprüfen, bestimmte Muster zu finden oder die Projektstruktur zu verstehen.
Schreib-Tools
Neue Dateien erstellen oder bestehenden Code präzise ändern.
| Tool | Zweck | Beispielanwendung |
|---|---|---|
write_to_file | Eine neue Datei erstellen oder eine bestehende Datei vollständig neu schreiben | Neue Komponenten generieren, Konfigurationsdateien erstellen |
apply_diff | Gezielte Änderungen an bestimmten Abschnitten einer Datei vornehmen | Funktionslogik aktualisieren, Fehler beheben, Code refaktorieren |
insert_content | Neue Zeilen an einer bestimmten Position in einer Datei hinzufügen | Importe hinzufügen, neue Funktionen einfügen |
Wann Bob Shell Schreib-Tools verwendet: Wenn du Bob Shell bittest, Dateien zu erstellen, Funktionen zu implementieren, Fehler zu beheben oder Code zu refaktorieren.
Befehls-Tools
Befehle ausführen und Systemoperationen in deinem Terminal durchführen.
| Tool | Zweck | Beispielanwendung |
|---|---|---|
execute_command | CLI-Befehle in deinem Workspace ausführen | Abhängigkeiten installieren, Tests ausführen, Projekte bauen |
Wann Bob Shell Befehls-Tools verwendet: Wenn du Bob Shell bittest, Befehle auszuführen, Pakete zu installieren, Skripte auszuführen oder Systemoperationen durchzuführen.
MCP-Tools
Bobs Fähigkeiten durch Model Context Protocol-Server erweitern.
| Tool | Zweck | Beispielanwendung |
|---|---|---|
use_mcp_tool | Tools von verbundenen MCP-Servern verwenden | Datenbanken abfragen, mit APIs interagieren, auf externe Dienste zugreifen |
Modus-Tools
Zwischen verschiedenen Bob Shell-Modi für spezialisierte Aufgaben wechseln.
| Tool | Zweck | Beispielanwendung |
|---|---|---|
switch_mode | Zu einem anderen Modus wechseln (Agent, Plan, Ask usw.) | Zu Plan-Modus für Architekturdesign wechseln, zu Agent-Modus für Implementierung |
Wann Bob Shell Modus-Tools verwendet: Wenn die aktuelle Aufgabe von den spezialisierten Fähigkeiten eines anderen Modus profitieren würde.
Frage-Tools
Zusätzliche Informationen sammeln, die zur Aufgabenerfüllung benötigt werden.
| Tool | Zweck | Beispielanwendung |
|---|---|---|
ask_followup_question | Klärung oder zusätzliche Details von dir anfordern | Nach bevorzugtem Implementierungsansatz fragen, fehlende Informationen anfordern |
Tool-Gruppen
Tool-Gruppen sind benannte Sammlungen verwandter Tools, die du gemeinsam aktivieren oder deaktivieren kannst. Verwende Tool-Gruppen, um einzuschränken, was Bob Shell in einer bestimmten Sitzung tun kann — zum Beispiel um Datei-Schreibzugriff in einem reinen Lese-Audit zu verhindern oder die Befehlsausführung in einer kontrollierten Umgebung zu deaktivieren.
Verfügbare Tool-Gruppen
| Gruppe | Enthaltene Tools | Standard in Agent | Standard in Plan | Standard in Ask |
|---|---|---|---|---|
read | Datei-Lese-, Such- und Auflistungs-Tools | ✓ | ✓ | ✓ |
edit | Datei-Schreib- und Diff-Tools | ✓ | ✓ | ✓ |
execute | Shell-Befehlsausführungs-Tools | ✓ | — | — |
mcp | MCP-Server-Tools | ✓ | ✓ | ✓ |
skill | Skill-bezogene Tools | ✓ | ✓ | ✓ |
todo | To-do-Listen-Verwaltungs-Tools | ✓ | ✓ | — |
subagent | Subagenten-Erzeugungstools | ✓ | — | — |
mode | Moduswechsel-Tools | ✓ | ✓ | ✓ |
Tool-Gruppen deaktivieren
Übergib --disable-tool-groups an bob run oder bob chat mit einer kommaseparierten Liste von Gruppennamen:
# Befehlsausführung und MCP-Tools deaktivieren
bob run --disable-tool-groups execute,mcp "Review @src/"
# Im reinen Lese-Modus ausführen
bob run --disable-tool-groups edit,execute,mcp "Summarize the codebase"Du kannst alle MCP-Server auch in einem Schritt mit dem dedizierten Flag deaktivieren:
bob run --disable-mcp "Explain @app.js"