L18 · Construcción y vista previa · 6 min
Depurar con tu agente: reproducir, encontrar, arreglar, comprobar
En una frase
La depuración es el método paso a paso que usa tu agente cuando algo se rompe: primero reproducir el fallo de forma fiable, después localizar la causa de fondo en los logs y el código, arreglarla con un solo cambio cada vez y añadir un test para que no vuelva.
Piénsalo así
Cuando una lámpara deja de encender, no cambias los cables de toda la casa al azar. Pulsas el interruptor para ver el fallo, compruebas la bombilla y el enchufe uno por uno, cambias la bombilla fundida y vuelves a pulsar para comprobar que da luz.
Cómo funciona
Un Definiciónerror (bug)Un fallo en el código que hace que la app se comporte mal.Abrir en el glosario → es simplemente un fallo en el código que hace que tu app no se comporte como esperabas. La DefinicióndepuraciónEncontrar y arreglar la causa de fondo de un error: reproducir, encontrar, arreglar, comprobar.Abrir en el glosario → es la forma de resolverlo con tu Definiciónagente de programaciónUna IA que trabaja en la carpeta de tu proyecto: lee archivos, escribe código y ejecuta comandos, con tu permiso.Abrir en el glosario →: no adivinando ni cambiando cinco archivos a la vez, sino siguiendo cuatro pasos ordenados: reproducir, encontrar, arreglar y comprobar.
Primero, reproducir y encontrar: le dices a tu agente los pasos exactos que provocan el fallo, y el agente lee el Definiciónmensaje de errorLo que dice un programa cuando algo falla. La primera línea suele decir qué; el resto dice dónde.Abrir en el glosario → y las líneas de Definiciónlog (registro)El diario de tu app: una línea por evento. Cuando algo se rompe, los logs cuentan qué pasó.Abrir en el glosario → para localizar el archivo y la línea donde empieza el problema. Aísla la causa de fondo antes de tocar nada.
Después, arreglar y comprobar: el agente hace un solo cambio cada vez para corregir la causa de fondo (sin probar a ciegas), añade un DefinicióntestUn pequeño programa que comprueba que tu app hace lo que debe, para que un arreglo no se rompa sin avisar más adelante.Abrir en el glosario → automático que habría detectado ese fallo y verifica el flujo de principio a fin para que el error no pueda volver en el futuro.
¿Y si el primer intento no funciona? La guía de Agentic Makers marca una regla estricta: tras dos intentos fallidos, el agente debe detenerse, devolver tu proyecto al último DefinicióncommitUn punto de guardado: una foto de lo que cambió, con una nota corta. Puedes volver a cualquier commit.Abrir en el glosario → que funcionaba (git revert o una rama limpia, sin borrar nunca el historial) y explicarte las opciones con claridad para no acumular parches.
Cómo se ve en tu proyecto
Cuando algo se rompe, tu agente activa su DefiniciónskillUna guía experta que sigue tu agente para un tipo de tarea, como escribir una especificación o depurar.Abrir en el glosario → debugging-and-error-recovery. Te explica en dos frases sencillas qué causó el fallo y cómo lo resuelve el arreglo, añade un test y te pide que compruebes que el problema ha desaparecido.
Copia para tu agente
Algo se ha roto: cuando [pasos que diste], esperaba [resultado esperado] pero ocurrió [resultado real]. Sigue el ciclo de depuración: reprodúcelo, busca la causa de fondo en los logs, explícamela en dos frases sencillas, haz un cambio cada vez y añade un test.
Comprobación rápida · 1 pregunta