참조

문제 해결

아래에서 증상을 찾아보세요. 각 표에는 가장 흔한 원인이 먼저, 드문 원인이 나중에 나옵니다.

풀 리퀘스트가 자동으로 검토되지 않음

최신 커밋의 HeyDeer Review 검사에 이유가 표시됩니다. 제목은 “검토 건너뜀”(문제가 발견되면 검사를 실패로 표시가 켜져 있으면 “검토 필요”)로 시작하고 그 뒤에 이유가 붙습니다. 검사가 없나요? HeyDeer Review 검사가 표시되지 않음을 참고하세요.

GitHub 검사 게시가 꺼져 있으면, PR이 PR당 최대 자동 검토 횟수에 도달했을 때 또는 HeyDeer가 검토를 실행할 수 없을 때 HeyDeer가 대신 PR에 댓글을 남깁니다. 댓글은 이유마다 한 번만 남깁니다. 이 댓글은 PR에 검토 댓글 게시가 켜져 있을 때만 게시됩니다.

가능한 원인	조치 방법
검토 일정이 수동 검토만입니다.	PR당 한 번 또는 푸시할 때마다를 선택하세요. 자동 검토를 참고하세요.
풀 리퀘스트가 자동 검토 필터와 일치하지 않습니다. 필터는 기본적으로 초안, 포크, 종속성 업데이트를 건너뜁니다.	검토 준비 완료로 표시하거나, 필터를 변경하거나, `@heydeer review`라고 댓글을 남기세요.
동시 실행 한도에 도달하여 검토가 대기 중입니다(검토 대기 중).	기다리세요.
“PR당 한 번”에서 이미 검토가 성공했거나 PR이 “PR당 최대 자동 검토 횟수”에 도달했습니다.	`@heydeer review`라고 댓글을 남기세요.
워크스페이스의 크레딧이 소진되었거나 사용량 한도에 도달했습니다.	무료 요금제의 다음 달 크레딧 지급을 기다리거나, 유료 요금제를 선택하거나, 크레딧을 추가하거나, 사용량 및 결제 → 개요 → 지출 관리에서 한도를 높인 후 새 검토를 요청하세요. 자동 충전 및 사용량 한도를 참고하세요.
이 풀 리퀘스트의 자동 검토가 일시 중지되었습니다.	`@heydeer resume`라고 댓글을 남기세요.
커밋에 이미 검토가 있습니다. 라벨을 다시 지정하거나 풀 리퀘스트를 다시 열어도 반복되지 않습니다.	새 커밋을 푸시하거나 `@heydeer review`라고 댓글을 남기세요.
HeyDeer의 GitHub 접근 권한에 저장소가 포함되어 있지 않습니다.	워크스페이스 설정 → GitHub 연결을 확인하세요. GitHub App 및 권한을 참고하세요.
이 저장소는 다른 워크스페이스의 무료 크레딧에 연결되어 있습니다.	요금제를 선택한 다음 검토를 요청하세요.

검사가 실패했거나 검토가 완료되지 않음

검사 제목	원인	조치 방법
검토에서 처리해야 할 문제를 발견함	문제가 발견되면 검사를 실패로 표시가 켜진 상태에서 검토가 발견 사항이나 처리되지 않은 이전 문제를 보고했습니다.	수정한 다음 푸시하세요. 발견 사항을 거절하려면 쓰기 권한이 있는 사람이 결정을 설명하거나 대화를 해결됨으로 표시한 다음 `@heydeer review` 댓글을 남기세요.
검토 취소됨	누군가 검토를 취소했거나, 풀 리퀘스트가 닫혔거나, 새 푸시로 대체되었습니다.	검토를 다시 요청하세요.
검토 미완료	저장소 검사가 실행되지 않았거나 이전 문제를 다시 확인하지 못했습니다.	검토를 다시 요청하세요.
검토 실패 / 검토 시간 초과	검토가 완료되지 않았습니다. 커넥터를 호출한 경우가 아니라면 HeyDeer가 크레딧을 반환합니다.	검토를 다시 요청하세요.
검토를 실행할 수 없음	GitHub 또는 HeyDeer를 사용할 수 없었습니다.	검토를 다시 요청하세요.
검토할 파일 없음	생성된 파일처럼 변경된 모든 파일이 범위 밖입니다.	조치할 필요가 없습니다.

모든 결론은 HeyDeer Review 검사에 나와 있습니다.

HeyDeer가 풀 리퀘스트를 승인하지 않음

자동 승인이 켜져 있으면 HeyDeer의 검토 페이지에 자동 승인되지 않음과 그 이유가 표시됩니다. 모든 요구 사항은 자동 승인에 나와 있습니다.

가능한 원인	조치 방법
자동 승인이 꺼져 있습니다(기본값).	검토 규칙의 결과 게시에서 자동 승인을 켜세요. 자동 승인 켜기를 참고하세요.
발견 사항이나 이전 문제가 남아 있습니다.	수정한 다음 푸시하거나 거절하세요. 심각도가 낮은 발견 사항만 남았을 때 승인하려면 남겨 둘 수 있는 문제를 낮은 심각도의 문제 허용으로 설정하세요.
HeyDeer가 승인할 수 있는 PR: 풀 리퀘스트의 위험 수준이 설정보다 높습니다.	사람이 GitHub에서 승인합니다. 검토에는 위험 수준과 그 이유가 표시됩니다. 이런 풀 리퀘스트도 HeyDeer가 승인하게 하려면 HeyDeer가 승인할 수 있는 PR에서 더 높은 수준을 선택하세요.
추가 설명 필요: HeyDeer에게 코드만으로는 답할 수 없는 질문이 있습니다.	`@heydeer review`를 포함한 새 PR 댓글로 답하세요. 부족한 맥락 추가하기를 참고하세요.
검토에 검토 안내가 있습니다. 예를 들어 저장소 검사가 실행되지 않은 경우입니다.	안내에 설명된 문제를 해결한 다음 검토를 다시 요청하세요.
이전 문제를 모두 확인하지 못했습니다.	검토를 다시 요청하세요.
PR에 검토 댓글 게시가 꺼져 있습니다.	켜세요. HeyDeer는 검토를 게시하는 방식으로 승인합니다.

풀 리퀘스트가 변경되었거나, 초안이거나, HeyDeer가 연 경우

가능한 원인	조치 방법
검토 후에 새 커밋이 푸시되었거나 기준 브랜치가 바뀌었습니다.	최신 커밋에 대한 검토를 요청하거나 기다리세요.
풀 리퀘스트가 초안입니다.	검토 준비 완료로 표시한 다음 검토를 요청하세요.
수정 PR처럼 HeyDeer가 연 풀 리퀘스트입니다.	사람이 승인해야 합니다.

HeyDeer Review 검사가 표시되지 않음

가능한 원인	조치 방법
저장소가 “수동 검토만”으로 설정되어 있고 한 번도 검토된 적이 없습니다.	검토를 요청하세요. 그러면 이후 버전에 검사가 생성됩니다.
저장소에서 GitHub 검사 게시가 꺼져 있습니다.	켜세요. 결과 게시를 참고하세요.
HeyDeer에 GitHub의 Checks 읽기 및 쓰기 권한이 없거나, HeyDeer의 GitHub 접근 권한에 저장소가 포함되어 있지 않습니다.	GitHub 계정 소유자가 워크스페이스 설정 → GitHub 연결에서 권한 요청 확인 또는 저장소 추가를 선택하세요.
풀 리퀘스트가 닫혀 있습니다.	다시 여세요.

명령에 답글이 없거나 오류가 발생함

가능한 원인	조치 방법
답글이나 👀 리액션이 없음: 명령이 코드, 인용 블록 또는 HTML 주석에 있거나, 수정으로 추가되었거나, 봇이 게시했습니다.	개인 계정으로 새 PR 댓글이나 인라인 검토 댓글의 어느 위치에나 명령을 일반 텍스트로 작성하세요.
쓰기 권한이 없거나 수동 검토 권한에 포함되어 있지 않습니다.	관리자나 권한이 있는 사람에게 요청하세요.
크레딧이 부족하거나 사용량 한도에 도달했습니다.	요금제를 선택하거나 크레딧을 추가하거나 한도를 높인 다음 명령을 다시 게시하세요.
요청이 너무 많거나 검토 대기열이 가득 찼습니다.	잠시 기다린 다음 명령을 다시 게시하세요.
👀 리액션이 없음: HeyDeer에 PR 대화 댓글에 필요한 Issues 읽기 및 쓰기 권한이나 인라인 검토 댓글에 필요한 Pull requests 읽기 및 쓰기 권한이 없을 수 있습니다.	GitHub 계정 소유자가 워크스페이스 설정 → GitHub 연결에서 권한 요청 확인을 선택하고 GitHub에서 승인하세요.
닫힌 풀 리퀘스트에서 `pause` 또는 `resume`을 사용했습니다.	이 명령은 열린 풀 리퀘스트에서만 작동합니다.
GitHub를 사용할 수 없었습니다.	새 댓글로 명령을 다시 게시하세요.

모든 명령은 PR 댓글 명령에 나와 있습니다.

컨벤션이나 검사가 무시되는 것 같음

가능한 원인	조치 방법
검사의 패턴이 변경된 파일과 일치하지 않거나, 프런트매터에 `files`가 없거나, 파일이 `.agents/checks/` 바로 아래의 .md 파일이 아닙니다.	프런트매터나 패턴을 수정하거나 파일을 옮기세요. 저장소 검사를 참고하세요.
발견 사항이 피드백 범위 밖에 있었습니다.	“균형” 또는 “상세”를 사용해 보세요. 피드백 범위를 참고하세요.
AGENTS.md 컨벤션이 변경된 파일을 포함하지 않는 디렉터리에 있습니다.	컨벤션을 옮기세요. AGENTS.md를 참고하세요.
REVIEW.md가 변경된 파일을 포함하지 않는 디렉터리에 있습니다.	파일을 옮기세요. REVIEW.md를 참고하세요.
검토가 요청된 후에 지침이 저장되었거나, 저장소 지침이 이를 재정의합니다.	검토를 다시 요청하거나 충돌을 해결하세요. 검토 지침을 참고하세요.
검사에서 HeyDeer가 코드를 읽어서는 확인할 수 없는 내용을 요구합니다.	HeyDeer가 코드를 읽어 확인할 수 있는 조건으로 다시 작성하세요. 효과적인 검사 작성하기를 참고하세요.
파일이 `.gitattributes`에서 linguist-generated로 표시되어 있거나, 기준 브랜치에 이미 있는 lock 파일입니다.	속성을 제거하거나, lock 파일을 `-linguist-generated`로 표시하세요. HeyDeer가 읽는 내용을 참고하세요.

검토에 검토 안내가 있음

HeyDeer는 검토에 제약이 된 사항을 검토 안내 아래에 나열합니다. 검토 안내가 하나라도 있으면 해당 검토는 자동 승인되지 않습니다. 검토 안내를 참고하세요.

검토 안내	조치 방법
일부 발견 사항이 생략되었습니다	표시된 발견 사항을 수정하거나 거절한 다음 검토를 다시 요청하세요.
일치하는 저장소 검사가 너무 많습니다	검사의 파일 패턴을 좁힌 다음 검토를 다시 요청하세요. 저장소 검사를 참고하세요.
일부 저장소 검사가 유효하지 않습니다	검토 안내에 표시된 검사를 수정한 다음 검토를 다시 요청하세요. 저장소 검사를 참고하세요.
일부 저장소 검사를 완료하지 못했습니다	검토를 다시 요청하세요.
일부 발견 사항 또는 이전 문제를 충분히 평가하지 못했습니다	검토를 다시 요청하세요.

로그인 및 GitHub 접근

가능한 원인	조치 방법
GitHub 로그인이 만료되어 HeyDeer에 GitHub로 로그인이 표시됩니다.	이를 선택하면 다시 로그인한 뒤 같은 페이지로 돌아옵니다.
검토나 조직을 볼 수 없는 GitHub 계정으로 로그인되어 있습니다.	GitHub로 계속 또는 GitHub에 다시 로그인을 선택한 다음 GitHub에서 올바른 계정을 선택하세요.
연결할 때 조직이나 저장소가 보이지 않습니다.	조직은 HeyDeer가 설치된 뒤에 표시되므로 GitHub에서 설치 또는 다른 계정에 설치를 선택하고 GitHub에서 조직을 고르세요. HeyDeer가 설치된 조직이 여전히 없으면 필요에 따라 GitHub에서 SSO로 로그인한 뒤 계정이 보이지 않나요?를 열고 GitHub에 다시 로그인을 선택하세요. GitHub App 및 권한을 참고하세요.

결제 문제

가능한 원인	조치 방법
카드가 거절되었거나 은행에서 결제 인증을 요청했습니다.	구독 결제라면 사용량 및 결제 → 개요에서 결제 완료를 선택하세요. 다른 구매라면 다른 카드를 사용하세요.
크레딧 추가에서 요금제가 필요하다고 표시됩니다.	먼저 요금제를 선택하거나, 개요에 결제 완료가 표시되면 이를 선택하세요. 요금제 및 추가 크레딧을 참고하세요.
자동 충전이 꺼짐으로 표시되고 그 아래에 이유가 나옵니다.	원인을 해결한 다음 다시 켜세요. 자동 충전에 실패한 경우를 참고하세요.
갱신 결제 대기 중.	그동안 요금제는 활성 상태로 유지됩니다. 결제가 실패했거나 은행 확인이 필요하면 HeyDeer가 워크스페이스에 이메일을 보냅니다. 결제 완료를 선택하세요.
결제가 아직 처리 중이거나, 크레딧 추가에서 이전 구매를 확인하라고 요청합니다.	결과가 표시될 때까지 구매 확인을 선택하세요. 다른 구매를 시작하지 마세요.
“크레딧 추가” 또는 자동 충전에서 구매 한도에 도달했다고 표시됩니다.	나중에 다시 시도하거나 HeyDeer에 문의하세요.
결제와 새로운 유료 검토가 일시 중지되었습니다.	HeyDeer가 워크스페이스의 결제 문제를 해결하는 중입니다. HeyDeer에 문의하세요.

커넥터 문제

GitHub 조직 소유자 또는 계정 소유자로 표시된 관리자만 커넥터를 관리할 수 있습니다. 커넥터를 참고하세요.

가능한 원인	조치 방법
HeyDeer가 도구를 불러오지 못합니다.	엔드포인트가 서버의 공개 Streamable HTTP 주소인지, 헤더에 유효한 자격 증명이 들어 있는지 확인하세요.
활성 유료 요금제가 없으면 검토와 작업에서 커넥터를 사용하지 않습니다.	커넥터는 유료 요금제에 포함됩니다. 요금제를 선택하면 저장된 커넥터가 새 검토와 작업에 적용됩니다.
커넥터를 저장하기 전에 검토나 작업이 시작되었습니다.	설정은 저장한 후에 시작된 검토와 작업에 적용됩니다. 새 검토나 작업을 시작하세요.
검토나 작업 페이지에 커넥터가 사용 불가로 표시됩니다.	저장소가 공개되어 있거나, 포크 또는 쓰기 권한이 없는 사람에게서 온 변경입니다. 공개 저장소와 포크 포함은 공개 데이터에만 선택하세요.
검토에서 커넥터의 도구를 하나도 사용하지 않았습니다.	검토는 허용된 읽기 전용 도구만 호출합니다. 읽기 전용 도구에서 도구를 허용하거나, 서버 제공업체에 읽기 전용 도구를 표시해 달라고 요청하세요.
커넥터를 호출한 후 검토가 실패했습니다.	크레딧은 반환되지 않습니다. 새 검토를 요청하세요.