Configuración de RooCode VS Code para Desarrollo de Agentes

Optimización de RooCode en VS Code: Guía Completa para la Configuración de Desarrollo de Agentes

RooCode amplía VS Code con capacidades de desarrollo multiagente. Tras la instalación y autorización, se abre una interfaz de chat con una cola de mensajes, selección de módulos, opciones de modelos de IA y ajustes de aprobación automática. La indexación de proyectos conecta la base de datos vectorial Qdrant para el análisis de archivos, mejorando la precisión de las ediciones generadas por LLM.

La configuración sigue un orden lógico: desde la indexación hasta los permisos, el marketplace, las notificaciones y los prompts. Esto minimiza las iteraciones y acelera el flujo de trabajo.

Indexación y Procesamiento Vectorial

Conecta un proveedor para la vectorización y gráficos. Especifica el endpoint de Qdrant—los resultados de la indexación se almacenan allí. El LLM recibe el contexto del proyecto, generando cambios relevantes sin alucinaciones.

En la ventana principal, activa Indexación. El escaneo de directorios permite que los modelos hagan referencia a la base de código durante la edición.

Aprobación Automática: Control de Operaciones del LLM

Permite que el LLM ejecute funciones con límites en solicitudes o coste. Para comandos de consola (Execute), configura listas blancas/negras.

• Comandos Permitidos: Añade según avances; RooCode solicita confirmación para los nuevos.
• Límites: Previene el uso excesivo de tokens en modo automático.
• Acciones Peligrosas: Confirmación manual para sudo o llamadas al sistema.

Esto equilibra autonomía y seguridad.

Marketplace para Servidores MCP y Módulos

Instala servidores MCP (Protocolo de Control de Modelos) preconfigurados para git, sistema de archivos, qdrant. Los globales provienen del marketplace; los específicos del proyecto se almacenan localmente en .roo.

Ejemplos de MCP:

• mcp-git: Operaciones de repositorio sin CLI.
• mcp-filesystem: Lectura/escritura de archivos.
• mcp-qdrant: Búsqueda vectorial.

Los módulos son agentes preconfigurados para tareas. Descárgalos y personalízalos.

Notificaciones y Ajustes de Interfaz

Activa notificaciones para confirmaciones, interrupciones de bucle y finalizaciones. Ajusta el volumen.

Opciones de interfaz:

• Expande el razonamiento del modelo para depurar lógica.
• Ctrl+Enter para enviar (evita Shift+Enter accidental).
• Edición en segundo plano—ediciones sin parpadeo de ventana.

Prompts y Funciones Experimentales

Edita prompts integrados. Enhance reescribe consultas, aplicando Documentación-Primero y TDD.

Genera una versión mejorada del siguiente prompt (responde solo con el prompt mejorado — sin conversación, explicaciones, texto introductorio, viñetas, marcadores de posición o comillas circundantes).

Tu mejora debe:
- Preservar la intención y restricciones originales del usuario; no añadas nuevos requisitos que cambien el significado.
- Mejorar claridad, estructura, especificidad y capacidad de prueba; elimina ambigüedad y lenguaje débil.
- Aplicar explícitamente **Documentación-Primero** y **TDD** como flujo de trabajo de ejecución por defecto:
  1) Comienza leyendo y basándote en la documentación del proyecto y `memory-bank/` como única fuente de verdad (ej., productContext, activeContext, systemPatterns).
  2) Si la solicitud implica cambios en lógica/arquitectura/comportamiento, actualiza la documentación/especificaciones relevante (o redacta un RFC) ANTES de escribir código de producción.
  3) Sigue TDD estricto (Rojo → Verde → Refactor): escribe primero pruebas fallidas, implementa el código mínimo para pasar, luego refactoriza a SOLID/DRY.
- Requerir actualizar el `memory-bank/` (al menos activeContext/progress y cualquier documento de contexto afectado) para reflejar el nuevo comportamiento y decisiones.
- Incluir una Definición de Hecho clara alineada con la solicitud (pruebas pasando, documentación actualizada, comportamiento verificado), sin añadir alcance innecesario.

Aquí está el prompt a mejorar:

${userInput}

Experimental: comandos de barra para módulos/habilidades.

Habilidades: Estructura y Categorías

Las habilidades son instrucciones de agente en formato Markdown. Colócalas globalmente (~/.roo/skills) o en el proyecto (.roo/skills).

Estructura de habilidad:

---
name: mcp-time
description:
context:
compatibility:
---

# <Título>

## Herramientas
| Herramienta | Uso Para |
|------|---------|
| | |

## Cuándo Usar

## Efectividad de Uso y Mejores Prácticas

#### ❌ Mala Práctica (Alucinando tiempo)

#### ✅ Buena Práctica (Verificando tiempo)

### Estrategia de Depuración

## Por Qué Usar Esto

## Alternativa CLI
| Acción MCP | Equivalente CLI |
|------------|----------------|
| | |
| | |
| | |
| | |

Categorías:

• mcp-*: Servidores MCP (git, sistema de archivos, qdrant, redis).
• cli-*: Comandos de consola (docker, systemd, sudo).
• usr-*: Personalizadas para tareas.

Conjunto de ejemplo:

• cli-database, cli-docker, mcp-git, mcp-memory, mcp-playwright.

Conclusiones Clave

• La indexación con Qdrant permite ediciones conscientes del contexto sin copiar y pegar manualmente.
• Aprobación Automática + límites previene el abuso del LLM en modo autónomo.
• Las habilidades aumentan la tasa de éxito, minimizando llamadas CLI.
• TDD en prompts asegura cambios comprobables.
• La edición en segundo plano mantiene el enfoque durante las ediciones del agente.

— Editorial Team