Cómo pasa desapercibido
Tu agente sigue trabajando. La terminal sigue moviéndose. Pero acaba de pedir lo mismo por quinta vez. La actividad puede parecer tranquilizadora, incluso cuando la sesión está atrapada en un bucle.
Imagina una tarea de código donde el agente sigue verificando el estado de Git. Una vez es útil. Cinco llamadas idénticas seguidas pueden indicar que perdió su siguiente paso. 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 de herramienta repetidas con los mismos argumentos y ciclos cortos que se repiten con los mismos nombres de herramienta. Cuando la repetición supera el umbral aplicable, genera una advertencia de bucle bloqueado. El hallazgo indica el patrón, la herramienta y el conteo 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 diferentes
Sin hallazgo para este detector.
En el ejemplo verificado, cinco llamadas idénticas al estado de Git generan una advertencia. Ocho llamadas con diferentes argumentos de archivo no activan este detector. La diferencia importante es la acción repetida. Los umbrales pueden reflejar el entorno de ejecución y su línea base aprendida, por lo 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 elaborados o archivos de configuración desechables. Los videos ilustran esos comportamientos. No son grabaciones de agentes en vivo ni de la interfaz del producto. Ningún comando de los ejemplos fue ejecutado.
El resultado establece el comportamiento para estas entradas. No establece la ingesta en tiempo de ejecución, la prevención ni un compromiso real. Inspeccionar el contrato de 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 más clara? Usa el hallazgo para romper el ciclo tú mismo y comprueba 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, detiene la sesión ni limita el gasto.