자주 묻는 질문

GitHub를 연결하고 저장소를 고른 다음 검토를 요청하세요.

• GitHub로 로그인하고 저장소가 있는 계정 선택에서 개인 계정이나 조직을 선택합니다. 목록에 없으면 GitHub에서 설치를 선택해 GitHub에서 고릅니다.
• GitHub에서 Only select repositories를 선택하고 검토할 저장소를 고른 뒤 확인합니다. 조직에서는 본인이 소유자가 아니면 GitHub가 소유자에게 승인을 요청합니다.
• HeyDeer가 알아서 검토할지 정합니다. 풀 리퀘스트 자동 검토를 켜 두면 푸시할 때마다 풀 리퀘스트당 최대 5회까지 검토하고, 끄면 요청할 때만 검토합니다.
• 열려 있는 풀 리퀘스트에 @heydeer review 댓글을 남깁니다.

저장소에 대한 쓰기 권한이 필요합니다. 새 워크스페이스는 신용카드 없이 무료 요금제로 시작하며, 발견 사항은 풀 리퀘스트의 검토 댓글로 도착합니다.

연결한 직후 바로 검토를 요청할 수 있습니다. HeyDeer는 풀 리퀘스트의 변경 사항을 저장소 전체의 맥락에서 읽고, PR 제목, 설명, 논의도 함께 살펴봅니다. 모든 검토는 처음부터 버그와 보안 문제를 찾습니다.

첫 검토에서 부족한 부분이 보이면 알맞은 곳에 가이드를 추가하세요.

• AGENTS.md: 코드가 동작하는 방식과 따르는 컨벤션. 코딩 에이전트도 이 파일을 따릅니다.
• REVIEW.md: 검토에서 찾아야 할 것, 건드리지 않을 것, 문제의 심각도.
• 저장소 검사: 특정 파일을 변경하는 모든 풀 리퀘스트에서 HeyDeer가 반드시 확인해야 하는 요구 사항.
• 검토 지침: 풀 리퀘스트로 바뀌면 안 되는 가이드나 모든 저장소에 적용되는 가이드.

누군가 요청하는 즉시 시작합니다. 풀 리퀘스트에 @heydeer review 댓글을 남기거나, 검토 기록 페이지에서 검토 시작을 선택하거나, HeyDeer Review 검사에서 Re-run을 선택하세요. 새 워크스페이스는 수동 검토만으로 시작하며, 설정을 마치면 HeyDeer가 자동으로 검토할지 바로 묻습니다.

워크스페이스 관리자는 워크스페이스 설정 → 검토 규칙 → 검토 시점에서 언제든지 일정을 바꿀 수 있습니다.

• PR당 한 번: 조건에 맞는 풀 리퀘스트를 검토가 한 번 성공할 때까지 검토합니다.
• 푸시할 때마다: 풀 리퀘스트가 처음 필터에 맞을 때 검토하고, 이후 커밋을 추가하는 푸시마다 검토합니다. 기본값은 최대 5회입니다.

자동 검토는 기본적으로 초안, 포크, 종속성 업데이트를 건너뜁니다.

단계적으로 도입하고, 팀이 결과를 신뢰하게 되면 HeyDeer의 결과를 병합 조건으로 삼으세요.

• 몇 개의 풀 리퀘스트로 시험해 보기: 자동 검토를 끈 상태로 성격이 다른 풀 리퀘스트 몇 개에 @heydeer review 댓글을 남기고, 발견 사항을 팀 검토자의 의견과 비교합니다.
• 그 검토에서 드러난 빈틈 메우기: 컨벤션은 AGENTS.md에, 요구 사항은 저장소 검사에, 우선순위는 검토 지침에 적습니다.
• 저장소 한두 개에서 자동 검토를 켜고(저장소에서 선택한 다음 일정 변경), 이어서 워크스페이스 전체로 넓힙니다.
• HeyDeer Review 검사를 필수로 지정하고, 자동 승인 사용 여부를 정하고, 유료 요금제라면 자동 충전과 사용량 한도를 설정합니다.

팀이 대부분의 발견 사항에 대응하고 검토가 검토 안내 없이 끝나면 다음 단계로 넘어가세요. 설정은 워크스페이스 관리자가 바꾸며, 쓰기 권한이 있으면 누구나 검토를 요청할 수 있습니다.

다음 중 어느 방법으로든 풀 리퀘스트의 최신 커밋을 검토할 수 있습니다.

• 풀 리퀘스트에 @heydeer review 댓글을 남깁니다.
• HeyDeer Review 검사에서 Re-run을 선택합니다.
• HeyDeer의 검토 기록 페이지에서 검토 시작을 선택합니다. 여기서는 다른 깊이나 피드백 범위도 고를 수 있습니다.

새 변경 사항만 검토가 켜져 있으면 검토는 지난 검토 이후 바뀐 부분을 다룹니다. 풀 리퀘스트 전체를 다시 검토하려면 @heydeer full review 댓글을 남기세요. 검토를 요청하려면 쓰기 권한이 필요하며, 요청한 검토도 다른 검토와 똑같이 요금이 부과되지만 PR당 최대 자동 검토 횟수에는 포함되지 않습니다.

HeyDeer에서 검토를 시작하면 그 검토에 한해 깊이와 피드백 범위를 고를 수 있습니다.

• 검토 기록을 열고 검토 시작을 선택합니다.
• 저장소와 풀 리퀘스트를 선택합니다. 목록에는 쓰기 권한이 있는 저장소가 표시됩니다.
• 검토 깊이나 피드백 범위를 바꾸려면 검토 옵션을 엽니다. 둘 다 저장소의 기본값이 처음 설정되어 있습니다.
• 검토 실행을 선택합니다.

이후 검토는 GitHub에서 요청한 검토와 똑같이 실행되고 게시됩니다.

첫 검토 이후 HeyDeer는 새로운 부분에 집중합니다. 기본값인 새 변경 사항만 검토가 켜져 있으면, 이후 검토는 마지막으로 성공한 검토 이후 풀 리퀘스트 자체의 커밋이 바꾼 부분에서만 새 발견 사항을 찾고, 이전 발견 사항을 다시 확인합니다. 기준 브랜치에서 병합된 커밋은 제외되지만, 충돌 해결은 검토합니다.

다음 경우에는 HeyDeer가 풀 리퀘스트 전체를 검토합니다.

• 누군가 @heydeer full review 댓글을 남겼거나, 이 설정이 꺼져 있는 경우.
• 지난 검토 이후 기준 브랜치가 바뀐 경우.
• 지난 검토에 검토 안내가 있었거나 추가 설명을 요청한 경우.

검토가 새 변경 사항을 다뤘는지 PR 전체를 다뤘는지는 검사 요약에 표시됩니다.

이후 검토마다 HeyDeer는 아직 열려 있는 이전 문제를 현재 코드와 대조해 다시 확인합니다.

• 여전히 해당하는 문제는 처리해야 할 이전 문제에 표시됩니다.
• HeyDeer가 검증할 수 없는 문제는 필요한 정보와 함께 확인해야 할 이전 문제에 표시됩니다.
• 기본값인 처리된 HeyDeer 대화를 해결됨으로 표시가 켜져 있으면, 코드가 문제를 수정했거나 문제가 잘못 제기되었음을 보여 줄 때, 또는 문제를 처리하지 않기로 했을 때 HeyDeer가 해당 대화를 해결됨으로 표시합니다.

수정은 코드로 드러나야 하며, 고쳤다는 답글만으로는 충분하지 않습니다. 열려 있거나 확인되지 않은 문제는 자동 승인을 막고, 문제가 발견되면 검사를 실패로 표시가 켜져 있으면 검사를 실패시킵니다.

HeyDeer는 피드백 범위 안의 발견 사항을 게시합니다. 이 설정은 심각도(치명적, 높음, 보통, 낮음)별로 HeyDeer가 얼마나 확신해야 발견 사항을 보고할지 정합니다.

• 간결: 치명적 발견 사항은 가능성이 높으면, 높음과 보통은 확신할 때만 보고하고, 낮음은 저장소 검사에서 나온 것만 보고합니다. 모든 댓글을 읽는 팀에 적합합니다.
• 균형(기본값): 치명적 발견 사항은 의심 단계에서, 높음은 가능성이 높으면, 보통과 낮음은 확신할 때 보고합니다.
• 상세: 치명적·높음은 의심 단계에서, 보통·낮음은 가능성이 높으면 보고합니다. 코딩 에이전트가 수정 전에 각 발견 사항을 검증하는 팀에 적합합니다.

범위 밖의 발견 사항은 보고되지 않으며, 검사를 실패시키거나 자동 승인을 막지 않습니다. 범위를 비교하려면 전환하기 전에 HeyDeer에서 완료된 검토로 미리 보세요.

네. ‘HeyDeer로 수정’은 선택한 발견 사항을 확인하고 병합할 수 있는 풀 리퀘스트로 만들어 줍니다.

• 검토 댓글에서 HeyDeer로 수정을 선택하거나, HeyDeer의 검토 페이지에서 발견 사항 수정을 선택합니다.
• 발견 사항을 고르고, 택할 접근 방식이나 유지해야 할 동작처럼 맥락이 필요한 항목에는 지침 추가를 사용합니다.
• 발견 사항 2개 수정처럼 선택한 개수가 표시된 버튼을 선택합니다.

HeyDeer가 변경을 적용하고 샌드박스에서 테스트를 실행한 다음, 여러분의 PR 브랜치를 대상으로 하는 별도의 PR을 엽니다. 이 PR을 병합하면 다음 PR 검토에서 해당 발견 사항을 다시 확인합니다. ‘HeyDeer로 수정’은 모든 요금제에 포함됩니다.

Autopilot은 풀 리퀘스트가 병합할 준비가 되거나 여러분의 확인이 필요해질 때까지 HeyDeer에게 맡기는 기능입니다. HeyDeer는 회차마다 남은 항목을 수정하고, PR 자체의 브랜치에 푸시한 뒤 새 커밋을 검토하며, 이를 회차 상한까지 반복합니다(기본 5회차이며 워크스페이스나 저장소별로 변경할 수 있습니다). 다루는 항목은 다음과 같습니다.

• 피드백 범위 안의 발견 사항과 열려 있는 이전 문제.
• 해결되지 않은 검토 대화와 새 댓글에 남긴, 쓰기 권한이 있는 사람의 요청.
• 실패한 검사: 필수 검사, 또는 HeyDeer Review를 제외한 모든 검사.
• 병합 충돌: 기준 브랜치를 병합해 해결하며, 리베이스나 강제 푸시는 하지 않습니다.

검토 페이지나 HeyDeer의 검토 댓글에 있는 Autopilot 버튼으로 시작하거나 @heydeer autopilot 댓글을 남기세요. 멈추면 HeyDeer가 검토를 게시하고 아직 남은 항목을 정리합니다. Autopilot에는 유료 요금제가 필요하며, 각 회차는 다른 수정과 검토처럼 크레딧을 사용합니다.

HeyDeer의 Autopilot 페이지에서 Autopilot 멈추기를 선택하거나 @heydeer autopilot stop 댓글을 남기세요. 쓰기 권한이 있으면 누구나 멈출 수 있습니다. Autopilot은 다음 경우에도 스스로 멈춥니다.

• 더 수정할 것이 없거나, 질문에 대한 여러분의 답변이 필요할 때.
• 다른 사람이 브랜치에 푸시했을 때(GitHub의 Update branch 버튼을 사용한 경우 포함).
• 회차 상한에 도달했거나, 회차를 거듭해도 진척이 없을 때.
• 1시간이 지나도 검사가 계속 실행 중이거나, PR이 병합 대기열에 있거나, GitHub가 푸시를 거부했을 때.
• PR이 닫히거나 병합되었을 때, 또는 워크스페이스의 크레딧이 소진되었거나 더 이상 유료 요금제가 아닐 때.

PR에 남기는 댓글에서 멈춘 이유와 아직 여러분이 처리해야 할 일을 알려 주며, 필요하면 시작한 사람을 멘션합니다. 다시 시작하면 회차 수가 초기화되고 새 답변과 댓글도 반영됩니다.

풀 리퀘스트나 이슈의 댓글, 인라인 검토 댓글, 새 풀 리퀘스트나 이슈의 설명에서 @heydeer를 멘션해 질문하거나 작업을 맡기세요. 예를 들면 다음과 같습니다.

• @heydeer what does this function do?: 답글로 코드를 설명합니다.
• @heydeer fix the first issue and open an issue for the second: 수정을 담은 풀 리퀘스트와 새 이슈를 엽니다.
• @heydeer do the latest Next.js docs recommend this?: 웹에서 문서를 확인합니다.

HeyDeer는 대화를 읽고, 테스트를 실행할 수 있는 샌드박스에서 작업한 뒤, 요청한 곳에 답합니다. 따로 요청하지 않으면 코드 변경은 새 풀 리퀘스트로 올라갑니다. 쓰기 권한이 있으면 누구나 요청할 수 있으며, 각 요청은 워크스페이스 크레딧을 사용하고 HeyDeer의 작업에 표시됩니다.

‘HeyDeer로 수정’은 무료 요금제를 포함한 모든 요금제에 포함됩니다. 수정에는 다음이 필요합니다.

• 브랜치가 포크가 아닌 같은 저장소에 있는 열린 풀 리퀘스트.
• 저장소에 대한 쓰기 권한.
• Contents, Pull requests, Workflows에 대한 HeyDeer의 읽기 및 쓰기 권한. HeyDeer가 Workflows 권한을 요청하기 전에 설치되었다면, 먼저 설치 관리자가 GitHub에서 업데이트된 권한을 승인해야 합니다.

풀 리퀘스트마다 한 번에 하나의 수정만 실행되며, 수정 하나로 발견 사항을 최대 100개까지 처리할 수 있습니다.

네. 저장소 루트의 AGENTS.md에 적어 두면 HeyDeer가 모든 풀 리퀘스트를 그 컨벤션에 비추어 검토합니다. AGENTS.md를 지원하는 코딩 에이전트도 코드를 작성할 때 같은 파일을 따릅니다. 코드 구성 방식, 이름 짓기, 사용할 헬퍼와 라이브러리, 오류와 테스트를 다루는 방식처럼 새로 합류한 팀원이 알아야 할 내용을 항목 하나에 컨벤션 하나씩, 이유가 분명하지 않으면 이유와 함께 적으세요.

별도의 컨벤션이 필요한 디렉터리에는 src/payments/AGENTS.md처럼 자체 파일을 둘 수 있습니다. 이 파일은 상위 파일의 컨벤션에 더해지며, 서로 충돌하면 우선 적용됩니다. AGENTS.md가 없는 디렉터리에서는 HeyDeer가 CLAUDE.md를 읽습니다. HeyDeer는 import를 따라가지 않으므로 컨벤션은 파일 안에 직접 적으세요.

REVIEW.md에 적으세요. 저장소 루트나 별도의 가이드가 필요한 디렉터리 어디에든 둘 수 있습니다. 다음과 같은 용도로 씁니다.

• 어떤 로그 필드가 개인 정보에 해당하는지처럼, HeyDeer가 코드만으로는 알 수 없는 확인 사항.
• 건드리지 않을 것. 범위를 좁게 잡고 적용되는 경로를 명시합니다.
• 특정 종류의 문제가 얼마나 심각한지. 치명적, 높음, 보통, 낮음으로 표현합니다.
• 특정 종류의 발견 사항이 계속 틀린 것으로 드러날 때, 그 종류에 필요한 근거.

Claude Code Review용으로 작성한 REVIEW.md는 그대로 사용할 수 있습니다. 풀 리퀘스트로 REVIEW.md를 수정할 수 있으므로, 바뀌면 안 되는 가이드는 검토 지침에 두세요.

저장소의 .agents/checks/에 Markdown 파일로 보관하는 요구 사항으로, 적용 대상 파일은 프런트매터의 files에 나열합니다. HeyDeer는 해당 파일을 변경하는 모든 풀 리퀘스트에서 그 요구 사항만 전담하는 검토자를 두고 확인합니다. 그래서 검사는 일반 가이드보다 철저하고 크레딧도 더 많이 사용합니다.

놓치면 대가가 크고 간과하기 쉬운 요구 사항, 예를 들어 API 라우트의 접근 제어에 검사를 쓰세요. 검사에서 나온 발견 사항에는 해당 파일 이름이 표시되며, HeyDeer Review 검사와 자동 승인에 반영됩니다. 검사 작성을 맡기려면 대시보드에서 저장소 검사 설정을 선택하세요. HeyDeer가 저장소와 과거 풀 리퀘스트를 읽은 뒤 검사를 추가하는 풀 리퀘스트를 열며, 크레딧은 사용하지 않습니다.

대개 가이드가 변경된 파일을 포함하지 않는 경우입니다. 해당하는 원인을 확인하세요.

• 저장소 검사는 .agents/checks/ 바로 아래의 .md 파일이어야 하며, files 패턴이 변경된 파일과 일치해야 합니다.
• AGENTS.md나 REVIEW.md는 변경된 파일을 포함하는 디렉터리에 있어야 합니다.
• 검토 지침은 저장한 뒤 요청한 검토부터 적용되며, 저장소 지침과 워크스페이스 지침이 충돌하면 저장소 지침이 우선합니다.
• 발견 사항이 피드백 범위 밖에 있을 수 있습니다. 균형이나 상세를 사용해 보세요.
• HeyDeer가 코드를 읽는 것만으로 검증할 수 없는 요구 사항은 코드에 대한 조건으로 다시 써야 합니다.
• 생성된 파일과 기준 브랜치에 이미 있는 lock 파일은 건너뜁니다.

원인을 고친 뒤 @heydeer review 댓글을 남기세요.

적은 노력으로 가장 큰 효과를 내는 변경부터 정리했으니, 위에서부터 차례로 시도해 보세요.

• HeyDeer에서 최근 검토로 미리 본 뒤 피드백 범위를 간결로 바꿉니다.
• 생성된 코드를 .gitattributes에서 linguist-generated로 표시합니다.
• skip-review 라벨 같은 자동 검토 필터로 봇이나 일회성 풀 리퀘스트를 건너뜁니다.
• 수정하지 않기로 한 발견 사항은 처리하지 않기로 결정해 두어, 다시 제기되지 않게 합니다.
• 아무도 대응하지 않는 종류의 댓글에는 이유를 담은 좁은 범위의 검토 지침을 추가합니다.
• 저장소 검사가 관련 없는 파일에 대해 보고하면 그 검사의 files 패턴을 좁힙니다.

코드만으로는 알 수 없는 것, 즉 기능이 어떻게 쓰이는지, 로그에 무엇이 남았는지, 테이블에 어떤 데이터가 있는지, 라이브러리 문서에 무엇이 적혀 있는지를 검토와 작업에서 확인할 수 있게 해 주는 원격 MCP 서버입니다. 유료 요금제에 포함되며, GitHub 조직이나 개인 계정의 소유자가 관리합니다.

추가하려면 워크스페이스 설정 → 커넥터를 열고 커넥터 추가를 선택한 뒤, 서버의 HTTPS 엔드포인트와 필요한 헤더를 입력하고 도구 불러오기를 선택하세요. 허용할 도구와 저장소를 고른 다음 커넥터 저장을 선택합니다. 처음에는 읽기 전용 도구만 허용되고, 커넥터는 기본적으로 비공개 저장소에서만 사용되며, 도구 호출은 해당 작업의 크레딧에 더해집니다.

워크스페이스 설정 → 검토 규칙의 검토 시점 아래에 있는 자동 검토 필터나 저장소의 검토 규칙 탭을 사용하세요. 각 행은 라벨, 작성자, 작성자의 팀, 관계나 계정 유형, 초안 상태, 출처로 필터링하며, 풀 리퀘스트는 모든 행에 일치할 때만 대상이 됩니다. 자주 쓰는 행은 다음과 같습니다.

• 모든 봇 건너뛰기: 작성자 계정 → 다음 중 하나가 아님 → 봇.
• 라벨이 붙은 풀 리퀘스트만 검토: PR 라벨 → 다음 중 하나 → ai-review.
• 작성자가 검토를 사양할 수 있게 하기: PR 라벨 → 다음 중 하나가 아님 → skip-review.

기본적으로 필터는 초안, 포크, 종속성 업데이트를 건너뜁니다. 필터는 자동 검토에만 적용되므로, 어떤 풀 리퀘스트든 여전히 검토를 요청할 수 있습니다.

각 검토나 수정이 수행한 작업만큼 크레딧으로 냅니다. 그래서 큰 변경이나 심층 검토는 작은 표준 검토보다 크레딧을 더 많이 사용합니다. 워크스페이스 전체가 요금제 하나와 크레딧 잔액을 공유하며, 개발자와 저장소 수에 제한이 없고 사용자별 요금도 없으므로 팀원을 추가해도 가격은 바뀌지 않습니다.

• 모든 요금제에 월간 크레딧이 포함됩니다. 무료 요금제는 첫 달에 1,000크레딧, 그 후에는 매월 300크레딧을 제공합니다.
• 무료 요금제를 포함한 모든 요금제에서 1,000크레딧당 $10의 기본 요율로 크레딧을 추가할 수 있으며, 많이 구매할수록 할인됩니다.
• 공개 저장소의 검토는 공정 사용 한도까지 무료입니다.

유료 요금제는 월간 크레딧과 병렬 검토 수가 늘어나며, 심층 검토, Autopilot, 커넥터도 사용할 수 있습니다.

워크스페이스에 크레딧이 다시 생길 때까지 HeyDeer는 새 검토를 시작하지 않습니다. 이미 실행 중인 검토는 끝까지 진행되고 미결제 사용량은 HeyDeer가 부담하지만, 실행 중인 수정은 멈춥니다. 자동 검토를 시작할 수 없으면 HeyDeer Review 검사에 이유가 표시되고, HeyDeer는 각 저장소에서 처음 해당하는 풀 리퀘스트에 하루 한 번 요금제와 크레딧 옵션 링크를 담은 댓글을 남깁니다.

계속하려면 사용량 및 결제 → 개요에서 크레딧을 추가하거나, 다음 달 크레딧이 새로 지급될 때까지 기다리거나, 유료 요금제를 선택한 뒤 검토를 다시 요청하세요. 이후 자동 검토는 평소처럼 시작됩니다. 유료 요금제에서는 크레딧이 부족해질 때와 소진될 때 HeyDeer가 워크스페이스로 이메일을 보내며, 자동 충전을 사용하면 그 전에 크레딧을 추가할 수 있습니다.

워크스페이스가 요금제를 선택한 뒤, 워크스페이스 관리자가 사용량 및 결제 → 개요 → 지출 관리에서 둘 다 설정합니다.

• 자동 충전은 기본적으로 꺼져 있으며, 잔액이 설정한 기준 아래로 떨어질 때마다 정해진 양의 추가 크레딧을 대량 구매 할인가로 구매해 검토가 계속 실행되게 합니다. 활성 유료 요금제가 필요하며, 구독 카드로 결제됩니다.
• 사용량 한도는 달력 기준 한 주 또는 한 달 동안 검토와 수정이 함께 사용하는 크레딧의 상한을 정합니다. 한도에 도달하면 한도가 초기화되거나 한도를 올릴 때까지 새 검토와 수정이 시작되지 않으며, 실행 중인 작업은 끝까지 진행됩니다.

주간 한도는 매주 월요일, 월간 한도는 매월 1일에 초기화되며, 둘 다 00:00 UTC 기준입니다. 크레딧을 추가해도 사용량 한도는 풀리지 않습니다.

워크스페이스 관리자가 사용량 및 결제 → 개요에서 요금제를 관리합니다.

• 업그레이드하려면 요금제 변경을 사용하세요. 결제하는 시점에 적용되며, 남은 기간의 차액을 결제하고 늘어난 월간 크레딧 중 그에 해당하는 몫을 받으며, 갱신일은 그대로 유지됩니다.
• 다운그레이드도 요금제 변경을 사용합니다. 다음 갱신 때 적용되며, 현재 요금제 유지로 취소할 수 있습니다.
• 해지하려면 청구 포털을 여세요. 결제한 기간이 끝날 때까지 요금제가 유지되고, 그 후 워크스페이스는 무료 요금제로 돌아갑니다. 유지하려면 그 전에 구독 재개를 선택하세요.

실행되는 검토의 수와 깊이를 조절하세요.

• 기본 검토 깊이를 표준으로 두고, 심층은 코드에 꼭 필요한 곳에서만 사용합니다.
• 검토 일정을 PR당 한 번으로 설정하거나 PR당 최대 자동 검토 횟수를 낮춥니다.
• 새 변경 사항만 검토를 켜 둡니다.
• 검토가 필요 없는 풀 리퀘스트는 자동 검토 필터로 건너뛰고, 생성된 파일을 표시합니다.

유료 요금제에서는 주간 또는 월간 사용량 한도로 지출 상한을 정할 수 있습니다. 사용량 및 결제 → 사용량에서 저장소, 풀 리퀘스트, 검토, 작업별로 사용한 크레딧을 확인할 수 있습니다.

모든 멤버는 GitHub에서 접근할 수 있는 저장소의 검토를 볼 수 있고, 쓰기 권한이 있는 저장소에서는 검토를 시작하고 취소할 수 있습니다. 관리자는 여기에 더해 다음을 할 수 있습니다.

• 검토 규칙과 일정 변경(멤버는 보기만 가능).
• 워크스페이스 설정과 사용량 및 결제 관리.
• 멤버의 역할 변경.

커넥터는 GitHub 조직 소유자 또는 계정 소유자로 표시된 관리자만 관리할 수 있으며, 수동 검토 권한으로 검토를 요청할 수 있는 사람을 좁힐 수 있습니다.

인사이트는 선택한 기간과 저장소에서 검토가 무엇을 찾았고 팀이 그것에 어떻게 대응했는지 요약합니다.

• 검토한 PR 수, 발견 사항 수, PR당 발견 사항 수, 처리하지 않기로 한 비율.
• 시간에 따른 심각도별 발견 사항, 그리고 각 발견 사항이 이후 검토에서 수정됨, 코드에 남아 있음, 처리하지 않기로 함 중 무엇으로 확인되었는지.
• 저장소별, 그리고 워크스페이스 관리자에게는 풀 리퀘스트 작성자별 같은 집계.

이후 검토에서 다시 보고되더라도 각 발견 사항은 한 번만 집계됩니다. 한 저장소에서 처리하지 않기로 한 비율이 높다면 대개 HeyDeer가 그 저장소의 맥락을 놓치고 있다는 뜻이며, 검토 지침, REVIEW.md, 저장소 검사로 맥락을 보완할 수 있습니다.

워크스페이스의 크레딧, 결제, GitHub 접근에 관한 이메일이며, 마케팅 이메일은 보내지 않습니다.

• 크레딧 부족(자동 충전이 꺼진 유료 요금제에서 요금제 월간 크레딧의 20%에 이르렀을 때)과 크레딧 소진.
• 구독 결제 실패, 은행이 확인을 요청한 결제, 유예 기간이 지나도 결제되지 않은 갱신.
• 자동 충전 실패 또는 구매 한도로 인한 일시 중지, 결제 문제를 해결하는 동안의 결제 일시 중지.
• GitHub 조직 소유자의 HeyDeer 연결 요청 승인.

HeyDeer는 GitHub App으로 설치되며, Only select repositories를 선택하면 검토받을 저장소로만 접근을 제한할 수 있습니다. 주요 권한은 다음과 같습니다.

• Contents 읽기 및 쓰기: 코드와 기록을 읽고, 수정과 @heydeer 요청을 위해 커밋을 푸시합니다. 브랜치의 커밋을 덮어쓰지는 않습니다.
• Pull requests 읽기 및 쓰기: 검토와 댓글을 게시하고, 요청에 따라 풀 리퀘스트를 열고 업데이트하거나 병합합니다.
• Checks 읽기 및 쓰기: HeyDeer Review 검사를 표시합니다.
• Workflows: 수정이 GitHub Actions 워크플로 파일을 바꿀 때 이를 업데이트합니다.

그 밖의 작은 권한은 명령, Autopilot용 Actions 로그, 필터용 조직 멤버, 결제 알림용 이메일에 사용됩니다. HeyDeer는 Administration 권한을 요청하지 않으며, 각 토큰은 하나의 저장소와 해당 단계에 필요한 권한으로만 범위가 제한됩니다.

검토 기록을 유지하고 워크스페이스를 운영하는 데 필요한 것을 저장합니다.

• 검토 및 수정 결과, 선택한 발견 사항과 지침. 댓글을 단 코드 줄이 인용될 수 있습니다.
• 저장소와 PR 식별자.
• 계정 및 워크스페이스 정보와 설정.
• 결제 기록.

저장소 자체는 작업이 끝나면 폐기되는 임시 클론에서 처리됩니다. 커넥터 호출의 경우 도구, 시각, 소요 시간, 결과는 기록하지만 주고받은 내용은 보관하지 않습니다.

최신 커밋의 HeyDeer Review 검사 제목에 이유가 표시됩니다. 흔한 원인을 자주 발생하는 순서대로 정리했습니다.

• 일정이 새 워크스페이스의 기본값인 수동 검토만입니다: PR당 한 번 또는 푸시할 때마다를 선택하세요.
• 필터가 건너뛰었습니다(기본적으로 초안, 포크, 종속성 업데이트를 건너뜁니다): 검토 준비 완료로 표시하거나, 필터를 바꾸거나, @heydeer review 댓글을 남기세요.
• 처리 용량이 모두 사용 중이라 검토가 대기열에 있습니다: 자리가 나면 시작됩니다.
• PR당 한 번으로 이미 검토가 성공했거나, PR이 PR당 최대 자동 검토 횟수에 도달했습니다: @heydeer review 댓글을 남기세요.
• 워크스페이스의 크레딧이 소진되었거나 사용량 한도에 도달했습니다: 크레딧을 추가하거나 한도를 올린 뒤 검토를 요청하세요.
• 해당 PR에서 자동 검토가 중지되어 있습니다: @heydeer resume 댓글을 남기세요.

대개 저장소가 아직 검토된 적이 없거나 검사 게시가 꺼져 있는 경우입니다. 다음 순서로 확인하세요.

• 저장소가 수동 검토만이고 한 번도 검토되지 않았습니다: 검토를 요청하면 이후 변경분부터 검사가 생깁니다.
• GitHub 검사 게시가 꺼져 있습니다: 검토 규칙의 결과 게시에서 켜세요.
• HeyDeer에 Checks 권한이나 저장소 접근 권한이 없습니다: GitHub 소유자가 워크스페이스 설정 → GitHub 연결에서 권한 요청 확인 또는 저장소 추가를 선택합니다.
• 풀 리퀘스트가 닫혀 있습니다: 다시 여세요.

HeyDeer가 저장소에서 검사를 게시하기 시작하면 풀 리퀘스트가 업데이트될 때마다 검사 결과가 생기므로, 필수 검사가 끝없이 기다리는 일은 없습니다.

HeyDeer는 받아들인 모든 명령에 👀를 답니다. 👀가 없다면 다음을 확인하세요.

• 명령은 코드, 인용, HTML 주석, 수정이 아닌 새 PR 댓글이나 인라인 검토 댓글에 일반 텍스트로, 봇이 아닌 개인 계정에서 작성해야 합니다.
• 쓰기 권한이 필요하며, 수동 검토 권한이 제한되어 있다면 그 목록에 포함되어 있어야 합니다.
• 워크스페이스의 크레딧이 소진되었거나 사용량 한도에 도달했을 수 있습니다.
• HeyDeer에 Issues 또는 Pull requests 권한이 필요할 수 있습니다: GitHub 소유자가 워크스페이스 설정 → GitHub 연결에서 권한 요청 확인을 선택합니다.
• pause와 resume은 열려 있는 풀 리퀘스트에서만 작동합니다.

원인을 고친 뒤 새 댓글로 명령을 다시 작성하세요.

HeyDeer Review 검사를 필수로 지정하고, 발견 사항이 있으면 검사가 실패하도록 하세요.

• 검사가 생기도록 HeyDeer가 저장소에서 풀 리퀘스트를 하나 이상 검토하게 합니다.
• 기준 브랜치에 대한 GitHub 브랜치 보호 규칙이나 ruleset에서 필수 상태 검사를 켜고, HeyDeer Review를 추가한 뒤 소스로 HeyDeer를 선택합니다.
• HeyDeer의 워크스페이스 설정 → 검토 규칙 → 결과 게시에서 문제가 발견되면 검사를 실패로 표시를 켭니다.

이제 풀 리퀘스트는 발견 사항과 이전 문제가 수정되거나 처리하지 않기로 결정된 뒤에만 병합됩니다. HeyDeer가 자동으로 검토하지 않는 커밋, 예를 들어 PR당 최대 자동 검토 횟수에 도달한 뒤의 커밋도 누군가 검토를 요청할 때까지 병합을 막습니다.

검사 요약에는 결과의 근거가 된 발견 사항, 열려 있는 이전 문제, 실패한 저장소 검사의 수가 표시됩니다. 검사는 다음 경우에 실패합니다.

• 문제가 발견되면 검사를 실패로 표시가 켜져 있고, 검토에 피드백 범위 안의 발견 사항, 열려 있거나 확인되지 않은 이전 문제, 또는 검토 안내가 있는 경우.
• 설정과 관계없이 저장소 검사가 실행되지 않았거나, 이전 문제를 다시 확인하지 못했거나, HeyDeer가 검토를 시작하거나 끝내지 못한 경우.

발견 사항을 수정해 푸시하거나, 각 대화에서 처리하지 않기로 결정한 뒤 @heydeer review 댓글을 남기세요. 검토가 불완전하다면 다시 요청하세요. 커넥터를 호출하지 않았다면 HeyDeer가 실패한 검토의 크레딧을 반환합니다.

자동 승인은 기본적으로 꺼져 있으며, 검토 규칙의 결과 게시에서 켤 수 있습니다. 켜져 있으면 HeyDeer의 검토 페이지에 자동 승인되지 않음과 그 이유가 표시됩니다. 예를 들면 다음과 같습니다.

• 발견 사항이나 이전 문제가 남아 있습니다: 수정하거나 처리하지 않기로 결정하세요. 또는 낮은 심각도의 문제 허용을 선택하면 낮음만 남은 상태로 승인됩니다.
• PR의 위험 수준이 HeyDeer가 승인할 수 있는 PR 설정보다 높아 사람이 승인합니다.
• 추가 설명 필요에 질문이 남아 있거나, 검토에 검토 안내가 있습니다.
• PR이 AGENTS.md나 저장소 검사처럼 HeyDeer가 PR에서 읽는 가이드를 변경했거나, HeyDeer가 연 PR입니다.
• 검토 후 새 커밋이 추가되었거나 기준 브랜치가 이동했습니다.