Библиотека детекторовЗависший цикл

Зависший цикл

Работает. Не продвигается.

Обнаружьте повторяющееся действие, скрытое в активной сессии.

Увидеть проблему. Понять находку.

Повествование на английском с субтитрами.

Как это остаётся незамеченным

Агент всё ещё работает. Терминал продолжает обновляться. Но агент уже запросил одно и то же в пятый раз. Активность может выглядеть обнадёживающе, даже если сессия застряла в цикле.

Представьте задачу по кодированию, где агент постоянно проверяет статус Git. Один раз полезно. Пять одинаковых вызовов подряд может означать, что агент потерял следующий шаг. В нескольких сессиях такой паттерн легко пропустить, пока вы не вернётесь к незавершённой задаче.

Что обнаруживает ClawMetry

ClawMetry отслеживает повторяющиеся вызовы инструментов с одинаковыми аргументами и короткие повторяющиеся циклы имён инструментов. Когда повторение превышает применимый порог, поднимается предупреждение о зависшем цикле. Находка сообщает паттерн, инструмент и количество повторений.

Различие, меняющее результат

Пример срабатывания

5 одинаковых вызовов

Предупреждение

Тихое сравнение

8 разных аргументов

Для этого детектора нет находки.

В проверенном примере пять одинаковых вызовов Git status вызывают предупреждение. Восемь вызовов с разными аргументами файлов остаются тихими для этого детектора. Важное различие в повторяющемся действии. Пороги могут отражать среду выполнения и её усвоенный базовый уровень, поэтому пять, это пример, а не универсальное правило.

Изучить результат детектора
{
  "kind": "stuck_loop",
  "severity": "warning",
  "evidence": {
    "pattern": "identical",
    "tool": "Bash",
    "repeats": 5,
    "total_tool_calls": 5,
    "threshold": 3,
    "threshold_source": "static"
  }
}
Скачать входные данные и полные результаты (JSON)
Как проверялся пример

Эти примеры оценивают опубликованный детектор с авторскими данными событий или одноразовыми файлами конфигурации. Видео иллюстрируют это поведение. Они не являются записями живых агентов или интерфейса продукта. Ни одна команда в примерах не была выполнена.

Результат устанавливает поведение для этих входных данных. Он не устанавливает приём в реальном времени, предотвращение или реальную компрометацию. Изучить закреплённый исходный контракт.

Что проверить дальше

Изучите повторяющийся шаг и его результаты. Агент ожидает чего-то, что не может измениться? Ему нужна недостающая зависимость или более чёткое следующее действие? Используйте находку, чтобы самостоятельно разорвать цикл, затем проверьте, возобновляется ли полезная работа.

  1. Изучить повторяющийся шаг
  2. Проверить, чего не хватает
  3. Определить конкретное следующее действие

Что устанавливает этот сигнал

Повторение может быть намеренным. Эта находка не определяет причину, не останавливает сессию и не ограничивает расходы.

Держите важные моменты на виду.

Следите за активностью агента, изучайте находки и решайте, что требует вашего внимания.