Ir al contenido principal
Español— Elegir un idioma
Menú

Modos personalizados: revisión de código, despliegue, lint

Lección 9 de 14 Actualizado el 2 de noviembre de 2026 Avanzado
En esta página
  1. Crea modos adaptados a tu flujo de trabajo
  2. Un revisor que no puede romper nada
  3. Un despliegue que se niega a improvisar
  4. Limpieza automática pero disciplinada
  5. Dos modos más y una regla de organización
  6. Puntos clave

Lección actualizada el 2 de noviembre de 2026. Los archivos de agente de ejemplo usan ahora las claves documentadas por Vibe: instructions (en lugar de system_prompt), active_model (en lugar de model), bloques [tools.<tool>] para aprobaciones (la clave auto_approve no existe en un archivo de agente) y nombres reales de herramientas (edit, no edit_file; sin herramienta list_dir). Recordatorio de la lección 3: safety es un indicador visual, no un permiso. Fuente: Referencia de configuración.

Crea modos adaptados a tu flujo de trabajo

La lección sobre modos unificados introdujo el concepto; ahora es momento de ponerlo a prueba. Vamos a construir tres modos personalizados que cubren necesidades recurrentes para cualquier desarrollador: revisión de código, despliegue y linting. Cada uno es un archivo .toml situado en ~/.vibe/agents/, con instrucciones específicas. Lo que distingue a estos tres modos no son tanto sus instrucciones como el par enabled_tools / [tools.<tool>]: esto decide qué puede tocar Vibe y, por tanto, qué riesgo asumes; safety es meramente la etiqueta visual.

Un revisor que no puede romper nada

El modo de revisión de código convierte a Vibe en un revisor exigente que analiza la calidad, la seguridad y la mantenibilidad de tu código. Dado que solo lee, se marca como safe, y sus herramientas de lectura se configuran con permission = "always": funciona sin interrumpirte y sin riesgo, ya que no se modificará ningún archivo. La lista de herramientas mantiene esta promesa: ni write_file, ni edit, ni bash.

# ~/.vibe/agents/review.toml
display_name = "Code Review"
description = "Revisión exhaustiva de código: seguridad, rendimiento, mantenibilidad."

safety = "safe"
active_model = "mistral-medium-3.5"  # modelo integrado en Vibe

instructions = """
Eres un desarrollador senior en modo de revisión de código.

Proceso:
1. Lee los archivos modificados (git diff o archivos especificados)
2. Analiza cada cambio en 4 ejes:
   - Seguridad (inyección, XSS, CSRF, secretos expuestos)
   - Rendimiento (N+1, bucles anidados, memoria)
   - Mantenibilidad (nomenclatura, complejidad, duplicación)
   - Corrección (lógica, casos límite, tipos)

Formato de salida:
## 🔴 Críticas (corregir antes del merge)
## 🟡 Advertencias (corregir pronto)
## 🟢 Sugerencias (mejoras opcionales)

Para cada punto: archivo, línea, problema, solución propuesta.
"""

enabled_tools = [
  "read_file",
  "grep",
]

[tools.read_file]
permission = "always"

[tools.grep]
permission = "always"

El formato de salida impuesto en el prompt no es cosmético: te permite clasificar de un vistazo qué bloquea una pull request y qué puede esperar. Lanzas el modo y luego le das una instrucción de forma libre o un ámbito específico.

vibe --agent review
# > Analiza los archivos modificados en la rama actual
# > /review src/api/

Un despliegue que se niega a improvisar

El modo de despliegue es exactamente lo opuesto. Toca producción, por lo que se marca como destructive, y sus herramientas de escritura y bash permanecen en permission = "ask": cada acción requiere tu validación. Todo el valor del modo reside en la secuencia fija de su prompt y, especialmente, en sus condiciones de parada. Un despliegue improvisado un viernes por la noche siempre empieza con un paso saltado; aquí, un test en rojo lo detiene todo.

# ~/.vibe/agents/deploy.toml
display_name = "Deploy"
description = "Despliegue controlado con tests, compilación y verificación."

safety = "destructive"
active_model = "codestral"  # alias declarado en config.toml (Lección 2)

instructions = """
Estás en modo de despliegue. Sigue esta secuencia SIN EXCEPCIÓN:

1. VERIFICAR — estado de git limpio, sin archivos sin confirmar
2. TEST — ejecutar la suite completa de tests
3. BUILD — compilación de producción
4. VALIDAR — comprobar la compilación (tamaño, errores, advertencias)
5. CONFIRMAR — preguntar al usuario antes de continuar
6. DEPLOY — ejecutar el comando de despliegue
7. VERIFICAR — confirmar que el servicio responde correctamente

Si un paso falla: DETENTE. Explica el problema y propone una solución.
Nunca despliegues si los tests fallan.
Nunca despliegues si la compilación contiene advertencias críticas.
"""

enabled_tools = [
  "read_file",
  "write_file",
  "bash",
  "grep",
  "ask_user_question"
]

[tools.write_file]
permission = "ask"

[tools.bash]
permission = "ask"

La presencia de ask_user_question en las herramientas es esencial: sin ella, el paso 5 sería un deseo, ya que el agente no tendría forma técnica de preguntarte.

vibe --agent deploy
# > Sigue la secuencia test → build → deploy → verificación

Limpieza automática pero disciplinada

Entre los dos se sitúa el modo lint, que automatiza el formato, las convenciones y la ordenación de imports. Modifica archivos, por lo que es neutral, pero sus correcciones son mecánicas y reversibles mediante Git: aprobar sus herramientas de entrada (permission = "always") te ahorra hacer clic cincuenta veces. Si su lista incluye bash, hazlo solo en un entorno aislado o limita bash a una allowlist de comandos de lint únicamente. Las tres reglas al final del prompt son las que evitan que se desmadre: un agente ejecutándose libremente instalará rápidamente Biome en un proyecto que vive perfectamente con ESLint.

# ~/.vibe/agents/lint.toml
display_name = "Lint & Fix"
description = "Limpieza automática: lint, formato, imports, convenciones."

safety = "neutral"
active_model = "codestral"  # alias declarado en config.toml (Lección 2)

instructions = """
Estás en modo de limpieza de código.

Tareas:
1. Detectar herramientas del proyecto (ESLint, Biome, Prettier, oxlint)
2. Ejecutar lint con auto-fix
3. Ejecutar formateo
4. Ordenar y limpiar imports
5. Eliminar código muerto detectable
6. Informar de errores que no se puedan corregir automáticamente

Reglas:
- Usar herramientas ya configuradas en el proyecto
- No modificar la configuración de las herramientas
- No añadir nuevas herramientas sin preguntar
"""

enabled_tools = [
  "read_file",
  "edit",
  "bash",
  "grep",
]

[tools.read_file]
permission = "always"

[tools.edit]
permission = "always"

[tools.bash]
permission = "always"  # reservar solo para entornos aislados

[tools.grep]
permission = "always"

Dos modos más y una regla de organización

El mismo razonamiento se aplica a otras necesidades. Un modo de documentación permanece neutral pero mantiene write_file y edit en "ask", porque generar archivos en un repositorio merece una mirada antes de escribir.

# ~/.vibe/agents/docs.toml
display_name = "Documentation"
description = "Genera y actualiza documentación técnica."
safety = "neutral"
active_model = "mistral-medium-3.5"  # modelo integrado en Vibe

instructions = """
Genera documentación técnica. Para cada archivo:
- JSDoc/TSDoc para funciones públicas
- README con ejemplos de uso
- Variables de entorno documentadas
- Esquemas de API si corresponde
"""

enabled_tools = ["read_file", "write_file", "edit", "grep",]

[tools.write_file]
permission = "ask"

[tools.edit]
permission = "ask"

Un modo de migración, por su parte, se une a despliegue en la categoría destructive: una migración de esquema fallida no se puede deshacer con un git revert, de ahí la necesidad de un script de rollback sistemático.

# ~/.vibe/agents/migrate.toml
display_name = "Migration"
description = "Gestiona migraciones de bases de datos y dependencias."
safety = "destructive"
active_model = "mistral-medium-3.5"  # modelo integrado en Vibe

instructions = """
Gestionas migraciones. Reglas absolutas:
- Generar siempre un script de rollback
- Probar la migración en una copia antes de producción
- Documentar cada cambio de esquema
"""

enabled_tools = ["read_file", "write_file", "bash", "grep", "ask_user_question"]

[tools.write_file]
permission = "ask"

[tools.bash]
permission = "ask"

Finalmente, organiza tu directorio de agentes para que la criticidad sea legible en la propia estructura del árbol. Cuando cambias de modo mediante el teclado a mitad de una sesión, necesitas saber sin pensar si el modo que acabas de activar puede escribir en tu disco.

~/.vibe/agents/
├── review.toml          # safe — solo lectura
├── lint.toml            # neutral — modificaciones controladas
├── docs.toml            # neutral — generación de archivos
├── deploy.toml          # destructive — con confirmación
└── migrate.toml         # destructive — con confirmación

Puntos clave

  • Cada modo es un archivo .toml en ~/.vibe/agents/ diseñado para un flujo de trabajo específico
  • El modo review solo tiene herramientas de lectura, aprobadas de entrada: solo puede leer
  • El modo deploy mantiene bash y la escritura en "ask": pide confirmación
  • El modo lint aprueba sus herramientas de edición de entrada: corrige automáticamente
  • Ajusta active_model según la complejidad de la tarea
  • Las instructions son clave: sé preciso con la secuencia y las reglas