에이전트 자기성찰 디버깅은(는) 무엇을 하나요?
에이전트 실행이 반복적으로 실패하거나, 진전 없이 토큰을 소모하거나, 동일한 도구에서 루프에 갇히거나, 원래 작업에서 벗어날 때 이 스킬을 사용하세요.
이 스킬은 워크플로 스킬이지 숨겨진 런타임이 아닙니다. 에이전트가 인간에게 에스컬레이션하기 전에 체계적으로 스스로를 디버깅하도록 가르칩니다.
활성화 시점
- 최대 도구 호출 / 루프 제한 실패
- 진전 없이 반복적인 재시도
- 출력 품질을 저하시키기 시작하는 컨텍스트 증가 또는 프롬프트 드리프트
- 기대와 현실 간의 파일 시스템 또는 환경 상태 불일치
- 진단과 소규모 시정 조치로 복구 가능할 것으로 보이는 도구 실패
범위 경계
이 스킬을 다음에 활성화하세요:
- 재시도 전에 실패 상태 캡처
- 일반적인 에이전트별 실패 패턴 진단
- 제한된 복구 조치 적용
- 구조화된 사람이 읽을 수 있는 디버그 보고서 생성
이 스킬을 다음의 주요 소스로 사용하지 마세요:
- 코드 변경 후 기능 검증:
verification-loop사용 - 더 좁은 ECC 스킬이 이미 존재하는 프레임워크별 디버깅
- 현재 환경이 자동으로 강제할 수 없는 런타임 약속
4단계 루프
1단계: 실패 캡처
복구를 시도하기 전에 실패를 정확하게 기록하세요.
캡처할 내용:
- 오류 유형, 메시지 및 가능한 경우 스택 추적
- 마지막 의미 있는 도구 호출 시퀀스
- 에이전트가 수행하려던 작업
- 현재 컨텍스트 압력: 반복되는 프롬프트, 지나치게 큰 붙여넣은 로그, 중복된 계획, 통제 불능의 메모
- 현재 환경 가정: cwd, 브랜치, 관련 서비스 상태, 예상 파일
최소 캡처 템플릿:
## 실패 캡처
- 세션 / 작업:
- 진행 중인 목표:
- 오류:
- 마지막 성공 단계:
- 마지막 실패 도구 / 명령어:
- 관찰된 반복 패턴:
- 확인할 환경 가정:
2단계: 근본 원인 진단
무엇이든 변경하기 전에 실패를 알려진 패턴과 일치시키세요.
| 패턴 | 가능한 원인 | 확인 방법 |
|---|---|---|
| 최대 도구 호출 / 동일 명령어 반복 | 루프 또는 종료되지 않는 관찰자 경로 | 마지막 N개 도구 호출에서 반복 여부 검사 |
| 컨텍스트 오버플로 / 저하된 추론 | 제한 없는 메모, 반복된 계획, 지나치게 큰 로그 | 최근 컨텍스트에서 중복 및 신호가 낮은 대량 데이터 검사 |
ECONNREFUSED / 시간 초과 | 서비스 사용 불가 또는 잘못된 포트 | 서비스 상태, URL 및 포트 가정 확인 |
429 / 할당량 소진 | 재시도 폭주 또는 백오프 누락 | 반복 호출 횟수 계산 및 재시도 간격 검사 |
| 쓰기 후 파일 누락 / 오래된 diff | 경쟁 조건, 잘못된 cwd 또는 브랜치 드리프트 | 경로, cwd, git 상태 및 실제 파일 존재 여부 재확인 |