Herramientas
Aprende cómo Bob Shell usa herramientas especializadas para leer archivos, editar código, ejecutar comandos e interactuar con tu entorno de desarrollo desde la línea de comandos.
Flujo de trabajo de las herramientas
Cuando describes lo que quieres lograr en lenguaje natural, Bob Shell:
- Selecciona la herramienta apropiada según tu solicitud.
- Presenta la herramienta con sus parámetros para tu revisión.
- Ejecuta la herramienta aprobada y te muestra los resultados.
- Continúa este proceso hasta que tu tarea esté completa.
Categorías de herramientas
Las herramientas de Bob Shell están organizadas en categorías según su función principal. Comprender estas categorías te ayuda a saber qué puede hacer Bob Shell y cómo lleva a cabo las tareas.
Herramientas de lectura
Acceden al contenido de los archivos y comprenden la estructura del código sin hacer cambios.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
read_file | Leer el contenido de uno o más archivos | Ver archivos de configuración, examinar código fuente |
search_files | Buscar patrones en múltiples archivos usando regex | Encontrar todos los comentarios TODO, localizar definiciones de funciones |
list_files | Listar archivos y directorios en una ruta especificada | Explorar la estructura del proyecto, encontrar tipos de archivos específicos |
list_code_definition_names | Extraer nombres de clases, funciones y métodos de los archivos fuente | Obtener una visión general de la organización del código |
Cuándo Bob Shell usa herramientas de lectura: Cuando le pides que revise código, encuentre patrones específicos o comprenda la estructura del proyecto.
Herramientas de escritura
Crean nuevos archivos o modifican el código existente con precisión.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
write_to_file | Crear un nuevo archivo o reescribir completamente uno existente | Generar nuevos componentes, crear archivos de configuración |
apply_diff | Realizar cambios específicos en secciones concretas de un archivo | Actualizar la lógica de una función, corregir errores, refactorizar código |
insert_content | Agregar nuevas líneas en una ubicación específica de un archivo | Agregar imports, insertar nuevas funciones |
Cuándo Bob Shell usa herramientas de escritura: Cuando le pides que cree archivos, implemente funcionalidades, corrija errores o refactorice código.
Herramientas de comandos
Ejecutan comandos y realizan operaciones del sistema en tu terminal.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
execute_command | Ejecutar comandos CLI en tu workspace | Instalar dependencias, ejecutar pruebas, compilar proyectos |
Cuándo Bob Shell usa herramientas de comandos: Cuando le pides que ejecute comandos, instale paquetes, ejecute scripts o complete operaciones del sistema.
Herramientas MCP
Extienden las capacidades de Bob Shell a través de servidores Model Context Protocol.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
use_mcp_tool | Acceder a herramientas proporcionadas por servidores MCP conectados | Consultar bases de datos, interactuar con APIs, acceder a servicios externos |
Herramientas de modo
Cambian entre diferentes modos de Bob Shell para tareas especializadas.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
switch_mode | Cambiar a un modo diferente (Agent, Plan, Ask, etc.) | Cambiar al modo Plan para diseño de arquitectura, modo Agent para implementación |
Cuándo Bob Shell usa herramientas de modo: Cuando la tarea actual se beneficiaría de las capacidades especializadas de un modo diferente.
Herramientas de pregunta
Recopilan información adicional necesaria para completar las tareas.
| Herramienta | Propósito | Ejemplo de uso |
|---|---|---|
ask_followup_question | Solicitar aclaraciones o detalles adicionales | Preguntar sobre el enfoque de implementación preferido, solicitar información faltante |
Grupos de herramientas
Los grupos de herramientas son colecciones con nombre de herramientas relacionadas que puedes activar o desactivar juntas. Usa los grupos de herramientas para restringir lo que Bob Shell puede hacer en una sesión determinada; por ejemplo, para evitar escrituras de archivos en una auditoría de solo lectura, o para desactivar la ejecución de comandos en un entorno controlado.
Grupos de herramientas disponibles
| Grupo | Herramientas incluidas | Predeterminado en Agent | Predeterminado en Plan | Predeterminado en Ask |
|---|---|---|---|---|
read | Herramientas de lectura, búsqueda y listado de archivos | ✓ | ✓ | ✓ |
edit | Herramientas de escritura y diff de archivos | ✓ | ✓ | ✓ |
execute | Herramientas de ejecución de comandos de shell | ✓ | — | — |
mcp | Herramientas de servidor MCP | ✓ | ✓ | ✓ |
skill | Herramientas relacionadas con skills | ✓ | ✓ | ✓ |
todo | Herramientas de gestión de listas de tareas | ✓ | ✓ | — |
subagent | Herramientas de creación de subagentes | ✓ | — | — |
mode | Herramientas de cambio de modo | ✓ | ✓ | ✓ |
Desactivar grupos de herramientas
Pasa --disable-tool-groups a bob run o bob chat con una lista separada por comas de nombres de grupos:
# Desactivar la ejecución de comandos y las herramientas MCP
bob run --disable-tool-groups execute,mcp "Review @src/"
# Ejecutar en modo de solo lectura
bob run --disable-tool-groups edit,execute,mcp "Summarize the codebase"También puedes desactivar todos los servidores MCP de una vez con el indicador dedicado:
bob run --disable-mcp "Explain @app.js"