풀 리퀘스트가 자동으로 검토되지 않음 최신 커밋의 HeyDeer Review 검사에 이유가 표시되며, 제목은 Review skipped이거나 “문제가 발견되면 검사를 실패로 표시”가 켜져 있으면 Review required입니다. 검사가 없나요? HeyDeer Review 검사가 표시되지 않음 을 참고하세요.
가능한 원인 조치 방법 “리뷰 시점”이 새 워크스페이스의 기본값인 “수동만”입니다. “PR당 한 번” 또는 “푸시할 때마다”를 선택하세요. 자동 리뷰 를 참고하세요. 풀 리퀘스트가 “자동 리뷰 필터”와 일치하지 않습니다. 필터는 기본적으로 초안과 포크를 건너뜁니다. 검토 준비 완료로 표시하거나, 필터 를 변경하거나, @heydeer review라고 댓글을 남기세요. 이 풀 리퀘스트의 자동 검토가 일시 중지되었습니다. @heydeer resume라고 댓글을 남기세요.“PR당 한 번”에 따라 이미 검토가 시작되었거나, 검토가 아직 대기 중이거나 실행 중입니다. 또는 풀 리퀘스트가 “PR당 최대 자동 리뷰 횟수”에 도달했습니다. @heydeer review라고 댓글을 남기세요.워크스페이스의 크레딧이 소진되었거나 사용량 한도에 도달했습니다. 크레딧을 추가하거나 지출 관리에서 한도를 높인 다음 새 검토를 요청하세요. 자동 충전 및 사용량 한도 를 참고하세요. 체험 중인데, 저장소가 이미 다른 워크스페이스에서 체험을 사용했습니다. 요금제 를 선택한 다음 검토를 요청하세요.GitHub App이 저장소에 접근할 수 없습니다. 조직 설정 → GitHub 연결을 확인하세요. GitHub App 및 권한 을 참고하세요. HeyDeer가 푸시 후 약 30초간 기다리는 중이거나, 검토가 대기열에 있습니다(Review queued). 기다리세요. 커밋에 이미 검토가 있습니다. 라벨을 다시 지정하거나 풀 리퀘스트를 다시 열어도 반복되지 않습니다. 새 커밋을 푸시하거나 @heydeer review라고 댓글을 남기세요.
검사가 실패했거나 검토가 완료되지 않음 검사 제목 원인 조치 방법 Review found issues that need attention “문제가 발견되면 검사를 실패로 표시”가 켜진 상태에서 문제가 발견되었습니다. 문제를 수정하고 푸시하거나, 발견 사항을 해결하세요. Review incomplete 저장소 검사나 이전 발견 사항이 평가되지 않았습니다. 검토를 다시 요청하세요. Review could not run 베이스 브랜치의 .agents/checks 구성이 유효하지 않습니다. 수정한 다음 검토를 요청하세요. Review could not run PR 논의가 너무 큽니다. 검토 스레드가 200개를 넘거나, 한 스레드의 댓글이 1,000개를 넘거나, 약 180KB를 넘습니다. 새 풀 리퀘스트에서 계속하세요. Review could not run GitHub 또는 HeyDeer를 사용할 수 없었습니다. 검토를 다시 요청하세요. Review failed, Review timed out 검토가 완료되지 않았습니다. HeyDeer 측 문제로 인한 실패는 환불됩니다. 검토를 다시 요청하세요. Review cancelled 누군가 검토를 취소했거나, 풀 리퀘스트가 닫혔거나, 새 푸시로 대체되었습니다(“푸시할 때마다”). 검토를 다시 요청하세요. No reviewable files 생성된 파일처럼 변경된 모든 파일이 범위 밖입니다. 조치할 필요가 없습니다.
모든 결론은 HeyDeer Review 검사 에 나와 있습니다.
HeyDeer Review 검사가 표시되지 않음 가능한 원인 조치 방법 저장소에서 “GitHub 검사 게시”가 꺼져 있습니다. 켜세요. 결과 게시 를 참고하세요. 저장소가 “수동만”이고 한 번도 검토된 적이 없습니다. 검토를 요청하세요. 그러면 이후 리비전에 검사가 생성됩니다. GitHub App에 Checks: 읽기 및 쓰기 권한이 없거나, 저장소가 설치에 포함되어 있지 않습니다. GitHub에서 권한을 승인하거나 저장소를 추가하세요. 풀 리퀘스트가 닫혀 있습니다. 다시 여세요.
명령에 답글이 없거나 오류가 발생함 가능한 원인 조치 방법 답글 없음: 댓글에 명령 외의 내용이 있거나, 수정으로 명령을 추가했거나, 봇이 게시했습니다. 개인 계정으로 명령만 담은 새 댓글을 게시하세요. 답글 없음: GitHub App에 Issues 읽기 권한이 없습니다. GitHub에서 승인하세요. 쓰기 권한이 없거나 “수동 리뷰를 실행할 수 있는 사용자”에 포함되어 있지 않습니다. 관리자나 권한이 있는 사람에게 요청하세요. 요청이 너무 많거나 검토 대기열이 가득 찼습니다. 잠시 기다린 다음 명령을 다시 게시하세요. 닫힌 풀 리퀘스트에서 pause 또는 resume을 사용했습니다. 이 명령은 열린 풀 리퀘스트에서만 작동합니다. 크레딧이 부족하거나 사용량 한도에 도달했습니다. 크레딧을 추가하거나 한도를 높인 다음 명령을 다시 게시하세요. GitHub를 사용할 수 없었습니다. 새 댓글로 명령을 다시 게시하세요.
HeyDeer는 질문에 답하지 않습니다. PR 댓글 명령 을 참고하세요.
검토에 경고가 표시됨 경고가 있으면 해당 검토의 자동 승인이 꺼집니다.
경고 조치 방법 10개가 넘는 검사가 일치해 파일 이름 순서로 처음 10개만 실행되었습니다. 패턴을 좁히거나 파일 이름을 변경하세요. 저장소 검사 를 참고하세요. 풀 리퀘스트가 .agents/를 변경하지만 새 검사 구성이 유효하지 않습니다. 병합하기 전에 수정하세요. 그렇지 않으면 그 브랜치의 검토가 중단됩니다. 확신도가 낮은 발견 사항이 제외되었습니다. 검토는 최대 30개까지 유지합니다. 표시된 발견 사항을 처리한 다음 검토를 다시 요청하세요. 일부 발견 사항 또는 스레드 평가가 불완전했습니다. 검토를 다시 요청하세요.
규칙이나 검사가 무시되는 것 같음 가능한 원인 조치 방법 이 풀 리퀘스트에서 검사를 변경했습니다. HeyDeer는 베이스 브랜치의 버전을 읽습니다. 변경 사항을 먼저 병합하세요. 검사의 패턴이 변경된 파일과 일치하지 않거나, 파일이 .agents/checks/ 바로 아래의 .md 파일이 아닙니다. 패턴을 수정하거나 파일을 옮기세요. 저장소 검사 를 참고하세요. AGENTS.md 규칙이 변경된 파일을 포함하지 않는 디렉터리에 있습니다. 규칙을 옮기세요. AGENTS.md 를 참고하세요. 검토가 요청된 후에 지침이 저장되었거나, 저장소 지침이 이를 재정의합니다. 검토를 다시 요청하거나 충돌을 해결하세요. 검토 지침 을 참고하세요. 발견 사항이 “피드백 범위”에 미치지 못했습니다. “균형” 또는 “상세”를 사용해 보세요. 피드백 범위 를 참고하세요. 파일이 .gitattributes에서 linguist-generated로 표시되어 있습니다. 속성을 제거하세요. HeyDeer가 읽는 내용 을 참고하세요. 코드를 읽는 것만으로는 규칙을 판단할 수 없습니다. diff에서 확인할 수 있는 형태로 다시 작성하세요. 효과적인 검사 작성 을 참고하세요.
MCP 서버 오류 양식에서 거부된 각 값의 이유를 설명합니다. MCP 서버 를 참고하세요. 엔드포인트를 변경한 후에는 새 토큰을 입력하거나 저장된 토큰을 제거하세요. GitHub 조직 또는 계정의 소유자인 워크스페이스 관리자만 서버를 관리할 수 있습니다.
로그인 및 GitHub 접근 가능한 원인 조치 방법 GitHub 로그인이 만료되어 HeyDeer에 “GitHub로 로그인”이 표시됩니다. 이를 선택하면 다시 로그인한 뒤 같은 페이지로 돌아옵니다. 검토나 조직을 볼 수 없는 GitHub 계정으로 로그인되어 있습니다. “GitHub로 계속” 또는 “GitHub 다시 승인”을 선택한 다음 GitHub에서 올바른 계정을 선택하세요. 연결할 때 조직이나 저장소가 보이지 않습니다. “조직이나 저장소가 보이지 않나요?” 아래에서 설치를 확인하고, 필요하면 GitHub에서 SSO로 로그인한 다음 “GitHub 다시 승인”을 선택하세요. GitHub App 및 권한 을 참고하세요.
결제 문제 가능한 원인 조치 방법 카드가 거절되었거나 은행에서 결제 인증을 요청했습니다. 구독 결제라면 사용량 및 결제 → 개요에서 “결제 완료”를 선택하세요. 다른 구매라면 다른 카드를 사용하세요. “크레딧 추가”에서 요금제가 필요하다고 표시됩니다. 먼저 요금제를 선택하거나, 개요에 “결제 완료”가 표시되면 이를 선택하세요. 요금제 및 추가 크레딧 을 참고하세요. 자동 충전이 꺼짐으로 표시되고 그 아래에 이유가 나옵니다. 원인을 해결한 다음 다시 켜세요. 충전에 실패한 경우 를 참고하세요. 갱신 결제 대기 중. 그동안 요금제는 활성 상태로 유지됩니다. 결제가 실패했거나 은행 확인이 필요하면 HeyDeer가 워크스페이스에 이메일을 보냅니다. “결제 완료”를 선택하세요. “크레딧 추가”나 자동 충전에 24시간 한도에 도달했다고 표시됩니다. 최근 24시간 구매 한도에 여유가 생길 때까지 기다리거나 지원팀에 문의하세요. 결제와 새로운 유료 검토가 일시 중지되었습니다. HeyDeer가 워크스페이스의 결제 문제를 해결하는 중입니다. 지원팀에 문의하세요. 결제가 아직 처리 중이거나, “크레딧 추가”에서 이전 구매를 확인하라고 요청합니다. 결과가 표시될 때까지 “구매 확인”을 선택하세요. 다른 구매를 시작하지 마세요.
그래도 해결되지 않나요? 풀 리퀘스트나 검토 링크를 적어 hey@heydeer.ai 주소로 이메일을 보내 주세요. 토큰이나 카드 번호는 절대 포함하지 마세요.
