같은 도구. 또 다른 실패.

놓치기 쉬운 이유

빌드가 실패합니다. 에이전트가 다시 시도합니다. 또 실패합니다. 재시도마다 출력이 늘어나지만 근본적인 문제는 여전히 남아 있습니다. 세션이 활성 상태인지만 확인하면 계속 반복되는 실패를 놓칠 수 있습니다.

셸 도구가 반복적으로 오류를 반환하는 동안 에이전트가 변경을 준비하는 상황을 생각해 보세요. 원인은 누락된 의존성, 잘못된 명령, 또는 접근 불가일 수 있습니다. 중요한 질문은 어떤 도구가 계속 실패하고 있으며 얼마나 자주인지입니다.

ClawMetry가 감지하는 내용

ClawMetry는 이벤트 윈도우에서 동일한 도구에 귀속된 오류를 계산합니다. 횟수가 임계값을 넘으면 도구 반복 실패 경고를 발생시킵니다. 발견 내용에는 도구 이름, 실패 횟수, 사용된 임계값이 포함됩니다.

발견 결과를 바꾸는 차이

확인된 예시에서 셸 결과 4회 실패는 경고를 생성합니다. 단일 실패는 임계값 아래에 머뭅니다. 이는 동일한 호출 루프와 다릅니다. 명령이 바뀌어도 같은 도구가 계속 오류를 반환할 수 있습니다.

{
  "kind": "repeated_tool_failure",
  "severity": "warning",
  "evidence": {
    "tool": "Bash",
    "failures": 4,
    "threshold": 3,
    "threshold_source": "static"
  }
}

다음으로 확인할 사항

실패한 결과를 열고 공통 원인을 찾으세요. 환경이나 접근 문제를 수정하거나, 재시도가 누적되기 전에 에이전트 작업을 좁히세요. 그런 다음 다음 도구 결과가 실제로 성공하는지 확인하세요.

1. 오류 결과 읽기
2. 공통 원인 수정
3. 다음 결과 확인