heydeer
검토 설정

자동 승인

완료된 검토에서 사람이 결정할 사항이 남지 않으면 HeyDeer가 풀 리퀘스트를 승인하도록 할 수 있습니다. 기본적으로 꺼져 있으며, PR에 검토 댓글 게시가 켜져 있을 때만 작동합니다.

자동 승인 켜기

  1. 워크스페이스 설정 → 검토 규칙 또는 저장소의 검토 규칙을 여세요.
  2. 결과 게시에서 자동 승인을 켜고, PR에 검토 댓글 게시가 켜져 있는지 확인하세요.
  3. 아래에서 HeyDeer가 승인할 수 있는 PR과 남겨 둘 수 있는 문제 조건을 선택합니다.
  4. 워크스페이스 검토 규칙 저장 또는 저장소 검토 규칙 저장을 선택하세요.
HeyDeer가 이 변경 사항을 승인함
모든 검사를 통과함
HeyDeer Review — 검토 완료 — 문제가 발견되지 않음
CI / test — 성공
자동 병합 켜짐: 모든 요구 사항이 충족되면 GitHub가 이 풀 리퀘스트를 병합합니다.
HeyDeer Review 검사가 필수이고 자동 병합이 켜진 풀 리퀘스트에 HeyDeer가 남긴 승인.

승인 조건

HeyDeer가 PR을 승인하려면 두 조건을 모두 충족해야 합니다.

설정값기본값
HeyDeer가 승인할 수 있는 PR

위험이 낮은 PR

위험이 낮거나 중간인 PR

모든 위험 수준의 PR

위험이 낮거나 중간인 PR
남겨 둘 수 있는 문제

미해결 문제 없음

낮은 심각도의 문제 허용

미해결 문제 없음

HeyDeer는 검토에서 놓친 실수의 피해를 얼마나 막기 어려운지에 따라 모든 PR의 위험 수준을 낮음, 중간, 높음으로 평가합니다. 위험이 높은 PR에는 데이터 마이그레이션, 기존 보장의 제거, 결제·권한·보안·핵심 인프라·외부 계약의 변경, 그리고 PR 자체 기능을 넘어 팀이 앞으로 따라야 하는 결정이 포함됩니다. 모든 검토에는 위험 수준과 그 이유가 표시됩니다.

모든 위험 수준의 PR을 선택하면 이 조건이 없어집니다. 다음 섹션의 요건은 모두 그대로 적용됩니다.

낮은 심각도의 문제 허용을 선택하면 심각도가 낮은 발견 사항이나 이전 문제가 남아 있어도 HeyDeer가 승인할 수 있습니다. 승인에는 이 문제들이 남아 있다고 표시되며, 수정된 것으로 표시하거나 해당 대화를 해결됨으로 표시하지 않습니다. 상태나 현재 심각도가 불분명한 이전 문제는 여전히 승인을 막습니다.

승인 요건

  • 피드백 범위 안의 발견 사항과 이전 문제가 남겨 둘 수 있는 문제 조건을 충족해야 합니다. 피드백 범위 밖의 발견 사항과, 처리하지 않기로 한 결정이 받아들여진 문제는 승인을 막지 않습니다.
  • 검토가 완료되어야 합니다. 즉, 해당하는 저장소 검사가 모두 실행되었고 검토 안내가 없어야 합니다.
  • 추가 설명 필요에 답변을 기다리는 질문이 없어야 합니다. 피드백 범위 밖의 발견 사항에 대한 질문은 포함되지 않습니다. 질문에 답하는 방법은 부족한 맥락 추가하기를 참고하세요.
  • HeyDeer가 PR의 위험 수준을 평가했고, 그 수준이 HeyDeer가 승인할 수 있는 PR 조건에 해당해야 합니다.
  • 풀 리퀘스트가 HeyDeer가 풀 리퀘스트에서 읽는 가이드(AGENTS.md, CLAUDE.md, 저장소 검사, 스킬 등)를 변경하지 않아야 합니다. 이런 변경은 사람이 승인합니다. 풀 리퀘스트가 바꿀 수 있는 것을 참고하세요.
  • 풀 리퀘스트가 검토한 리비전 그대로이고 기준 브랜치도 바뀌지 않아야 합니다. 초안도 승인할 수 있지만, GitHub는 검토 준비가 된 뒤에만 병합합니다.

HeyDeer의 승인 댓글은 짧습니다. 접힌 이 검토 정보 섹션에는 검토 요약, 위험 수준과 그 이유, 이 설정으로 가는 설정 링크가 들어 있습니다. 설정 때문에 PR이 승인되지 않으면 댓글에 그 사실과 설정 링크가 표시됩니다. HeyDeer Review 검사와 HeyDeer의 검토 페이지에는 같은 내용이 펼쳐진 상태로 표시됩니다.

승인과 GitHub 브랜치 규칙

승인과 검사 상태는 별개입니다. 낮은 심각도의 문제 허용을 선택한 경우, 문제가 발견되면 검사를 실패로 표시가 켜져 있으면 승인된 PR이라도 검사가 실패할 수 있습니다.

HeyDeer는 HeyDeer GitHub App으로 승인합니다. 이후 검토에서 PR을 승인하지 않으면 HeyDeer는 이전 승인을 취소하고 새 검토 링크를 남깁니다. 그 전까지는 HeyDeer가 새 커밋을 검토하는 동안을 포함해 이전 승인이 계속 유효합니다.

푸시할 때마다 새로 승인을 받도록 하려면 브랜치 규칙에서 Dismiss stale pull request approvals when new commits are pushed를 켜세요. 브랜치 규칙에서 풀 리퀘스트 검토를 취소할 수 있는 대상을 제한한다면 HeyDeer GitHub App을 포함하세요.

HeyDeer의 승인이 필수 승인 수에 포함되는지는 브랜치 규칙이 결정합니다. 모든 병합을 사람이 승인해야 한다면 코드 소유자 검토를 필수로 지정하거나 승인을 두 개 이상 요구하세요.

HeyDeer가 승인하면 풀 리퀘스트를 자동으로 병합하려면 코드 검토가 없는 팀의 브랜치 규칙 설정을 참고하세요.