Cómo pasa desapercibido
Tu agente sigue trabajando. La terminal no para. Pero acaba de pedir lo mismo por quinta vez. La actividad puede parecer tranquilizadora, incluso cuando la sesión está atascada en un bucle.
Imagina una tarea de código donde el agente sigue revisando el estado de Git. Una vez es útil. Cinco llamadas idénticas seguidas pueden indicar que perdió el hilo. En varias sesiones, ese patrón es fácil de ignorar hasta que vuelves a la misma tarea sin terminar.
Qué detecta ClawMetry
ClawMetry busca llamadas repetidas a herramientas con los mismos argumentos y ciclos cortos que se repiten. Cuando la repetición supera el umbral aplicable, genera una advertencia de bucle atascado. El hallazgo indica el patrón, la herramienta y el número de repeticiones.
La diferencia que cambia el hallazgo
Ejemplo que activa el detector
5 llamadas idénticas
Hallazgo de advertencia
Comparación sin hallazgo
8 argumentos distintos
Sin hallazgo para este detector.
En el ejemplo verificado, cinco llamadas idénticas al estado de Git generan una advertencia. Ocho llamadas con distintos argumentos de archivo no activan este detector. La diferencia clave es la acción repetida. Los umbrales pueden reflejar el entorno de ejecución y su línea base aprendida, así que cinco es un ejemplo, no una regla universal.
Inspeccionar el resultado del detector
{
"kind": "stuck_loop",
"severity": "warning",
"evidence": {
"pattern": "identical",
"tool": "Bash",
"repeats": 5,
"total_tool_calls": 5,
"threshold": 3,
"threshold_source": "static"
}
}Cómo se verificó el ejemplo
Estos ejemplos evalúan el detector publicado con datos de eventos creados o archivos de configuración desechables. Los videos ilustran esos comportamientos. No son grabaciones de agentes en uso ni de la interfaz del producto. Ningún comando de los ejemplos fue ejecutado.
El resultado establece el comportamiento para estas entradas. No establece ingesta en tiempo real, prevención ni un compromiso real. Inspeccionar el contrato de código fuente fijado.
Qué revisar a continuación
Inspecciona el paso repetido y sus resultados. ¿El agente está esperando algo que no puede cambiar? ¿Necesita una dependencia faltante o una acción siguiente más clara? Usa el hallazgo para romper el ciclo tú mismo, luego verifica si el trabajo útil se reanuda.
- Inspeccionar el paso repetido
- Verificar qué falta
- Dar una acción concreta a seguir
Qué establece esta señal
La repetición puede ser intencional. Este hallazgo no determina la causa, no detiene la sesión ni limita el gasto.