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

Editar código con Vibe

Lección 10 de 16 Actualizado el 2 de noviembre de 2026 Desarrollador
En esta página
  1. Describe, no escribas
  2. Revisa antes de aceptar
  3. Cuando los cambios abarcan varios archivos
  4. Haz que revisen tu código
  5. Qué separa un buen prompt de uno malo
  6. Puntos clave

Actualización 2 de noviembre de 2026 — Devstral. Devstral 2 (devstral-2512) llegó al final de su vida útil el 31 de julio de 2026, y Devstral Small 2 el 31 de marzo de 2026: las llamadas a estos modelos ya no están garantizadas. La tabla oficial los redirige ahora a Mistral Medium 3.5, que a su vez está obsoleto en favor de Mistral Large 4. Codestral (codestral-2508) sigue estando disponible generalmente para la finalización de código. Consulta la tabla de modelos para ver a dónde apuntan los alias -latest antes de ejecutar estos ejemplos.

Describe, no escribas

Editar código con Vibe comienza indicando lo que quieres en lenguaje natural, sin intentar redactar una instrucción técnica:

Añadir validación de correo electrónico a la función registerUser
Refactorizar este componente para usar ganchos de React en lugar de clases
Corregir el error en el manejador de login que no gestiona los tiempos de espera

El agente lee el código existente, comprende el contexto y propone un cambio a medida. Se basa principalmente en la herramienta edit (anteriormente search_replace), que actúa de forma quirúrgica: solo reescribe el bloque relevante, dejando el resto del archivo intacto. Esto evita el temido efecto secundario de las reescrituras completas de archivos, donde una corrección de tres líneas viene acompañada de cincuenta líneas de reformateo no deseado.

Revisa antes de aceptar

Vibe nunca modifica un archivo en silencio. Muestra un diff coloreado en la terminal, utilizando exactamente el formato de git diff: las líneas eliminadas aparecen en rojo precedidas por -, las añadidas en verde precedidas por +, y el contexto circundante permanece visible para que puedas ubicar el cambio dentro del archivo. Todo desarrollador lee este formato sin esfuerzo; ese es precisamente el objetivo.

A continuación llega la aprobación. En el modo predeterminado, la secuencia es fija: el agente analiza el código y prepara el cambio, muestra el diff, tú verificas exactamente qué va a cambiar y luego apruebas con y o rechazas con n. Ningún cambio llega a tu base de código sin este paso. Esto hace que la herramienta sea segura para código de producción: mantienes el control final, línea por línea.

Rechazar no es tu única opción cuando una propuesta es solo parcialmente correcta. El enfoque más eficiente es corregir el rumbo en la conversación:

Casi, pero usa una expresión regular en lugar de split para analizar el correo

Vibe ajusta su propuesta basándose en tu retroalimentación y en todo lo dicho anteriormente en la sesión.

Cuando los cambios abarcan varios archivos

Las funcionalidades reales rara vez viven en un solo archivo, y Vibe gestiona esta dispersión sin obligarte a fragmentar tu solicitud:

Añadir un endpoint /api/users/:id/avatar con subida de archivos.
Crear el manejador de ruta, el middleware de validación y la prueba unitaria.

El agente identifica qué archivos modificar y cuáles crear, prepara los cambios para cada uno y luego los envía para su aprobación archivo por archivo. Puedes aceptar el manejador pero rechazar la prueba si su estructura no te conviene.

Haz que revisen tu código

Editar es solo parte del trabajo: Vibe es igual de útil para las revisiones. Pide una revisión de seguridad en un archivo específico con «Revisa los cambios en @src/api/auth.ts y dime si hay problemas de seguridad», un análisis de rendimiento con «Analiza este archivo y sugiere mejoras de rendimiento», o una comprobación de estilo con «Verifica que este código sigue las mejores prácticas de TypeScript». En cada caso, el agente lee, señala posibles problemas y propone correcciones razonadas.

Para una auditoría donde cualquier escritura sería inaceptable, no confíes en tu propia vigilancia en el momento de la aprobación: simplemente elimina las herramientas de escritura de un agente dedicado.

# ~/.vibe/agents/reviewer.toml
system_prompt_id = "code_reviewer"
disabled_tools = ["write_file", "edit", "bash"]   # edit: formerly search_replace

Ejecútalo con:

vibe --agent reviewer

Este agente solo puede leer y analizar. Esta es la configuración preferida para auditorías de seguridad o para revisar el repositorio de un contratista.

Qué separa un buen prompt de uno malo

La calidad de la modificación depende directamente de la precisión de la instrucción. Compara estas dos formulaciones: la primera deja que el agente adivine tu intención; la segunda no deja nada a la invención.

# Demasiado vago
Mejorar este archivo

# Preciso
Añadir registro con el módulo winston para errores en el manejador createOrder,
registrando el código de error HTTP y el mensaje

El segundo reflejo es designar explícitamente el área objetivo con @, como en «En @src/middleware/auth.ts, añade una comprobación de caducidad del token antes de validar la sesión». El tercero es no cerrar nunca una serie de cambios sin verificación: pide «Ejecuta las pruebas para verificar que los cambios no han roto nada», y el agente ejecutará el comando apropiado para tu proyecto —npm test, pytest, cargo test— antes de indicarte si todo ha pasado correctamente.

Finalmente, está el caso de aprobar demasiado rápido. No todo está perdido: puedes pedir al agente que deshaga el último cambio en @src/api/auth.ts, o retomar el control vía Git sin salir del modo interactivo, usando el prefijo ! para ejecutar el comando de shell directamente.

!git checkout -- src/api/auth.ts

Puntos clave

  • Describe tus cambios en lenguaje natural; Vibe genera el código
  • Los diffs coloreados muestran exactamente qué cambia antes de la aprobación
  • El modo predeterminado requiere aprobación explícita para cada cambio
  • Los cambios en varios archivos se gestionan automáticamente
  • Un agente de solo lectura es ideal para la revisión de código
  • Verifica siempre las pruebas después de una serie de cambios