¿Qué hace esta skill?

La Depuración Introspectiva de Agentes Skill proporciona un flujo de trabajo de cuatro fases para que un agente IA diagnostique y recupere sus propios fallos de forma estructurada antes de escalar a un humano. Resuelve el problema de los bucles infinitos, el consumo incontrolado de tokens y la deriva de contexto sin progreso real, devolviendo un informe reutilizable por otro agente o por un humano.

Bucle de llamadas a herramientas
El agente repite el mismo comando en bucle o alcanza el límite máximo de llamadas a herramientas sin avanzar.
Desbordamiento de contexto
Los reintentos no producen avance real y el contexto crece de forma descontrolada, degradando la calidad de salida.
Deriva del prompt o tarea
La calidad de salida se degrada por deriva del prompt, duplicación de notas o desajuste entre el estado esperado y la realidad.
Fallo recuperable de herramienta
Una herramienta falla de forma recuperable y se necesita un diagnóstico y una acción correctiva mínima antes de reintentar.

Ejemplos de uso

🔁 Bucle de reintentos
Llevo 3 reintentos del mismo comando y el contexto crece sin avanzar. Haz una captura del fallo y diagnostica la causa raíz.
🔌 Conexión rechazada
El agente falla con ECONNREFUSED en localhost:5432. Verifica el estado real del servicio antes de reintentar.
🎯 Deriva de contexto
La salida se está degradando y el agente se ha desviado del objetivo original. Recorta el contexto de baja señal y reduce el alcance a un solo comando.
📋 Informe de introspección
Genera un informe de autodepuración reutilizable por otro agente o humano con el patrón de fallo, causa raíz, acción de recuperación y cambio preventivo.

Características

Captura estructurada del fallo Registra error exacto, última secuencia de herramientas, objetivo en curso, presión de contexto y suposiciones del entorno antes de reintentar.
Diagnóstico de causa raíz Clasifica el fallo en patrones conocidos (bucle de llamadas, desbordamiento de contexto, conexión rechazada, cuota agotada, fichero ausente, hipótesis incorrecta) y determina si es de lógica, estado, entorno o política.
Recuperación contenida Aplica la acción más pequeña que cambie la superficie de diagnóstico, detiene los reintentos ciegos, recorta contexto de baja señal y escala a humano si el fallo es de alto riesgo.
Informe de introspección reutilizable Devuelve patrón de fallo, hipótesis de causa raíz, acción de recuperación aplicada y evidencia de mejora, listo para el siguiente agente o humano sin reproducir la sesión.
Cambio preventivo codificable Cada informe incluye un cambio preventivo concreto a codificar para evitar que el mismo patrón de fallo vuelva a ocurrir.

Preguntas frecuentes

Cuando el agente alcanza el límite de llamadas a herramientas, repite el mismo comando en bucle, el contexto crece sin avance real o una herramienta falla de forma recuperable.
No. La skill es un flujo de razonamiento estructurado que el propio agente sigue. No requiere configurar ningún MCP adicional.
Indica explícitamente qué queda pendiente, qué riesgo de consumo de tokens persiste y si es necesario escalar a un humano por fallo de alto riesgo.
Sí. El informe de introspección está diseñado para que otro agente o un humano lo use sin necesidad de reproducir la sesión completa.

Skills relacionadas

Mas skills de la misma categoria:

Depuración Introspectiva de Agentes — Autodiagnóstico de IA con Claude AI

¿Prefieres escuchar el contenido? Genera la narración de audio con un clic.