처음 다섯 개의 표는 워크스페이스 설정 → 검토 규칙의 섹션 순서를 따릅니다. 기본값은 새 워크스페이스가 시작할 때의 값이며, 각 설정은 해당 설정을 설명하는 페이지로 연결됩니다. 저장소는 사용자 지정하기 전까지 워크스페이스 값을 따릅니다. 설정 작동 방식을 참고하세요.
검토 시점
| 설정 | 기본값 | 동작 |
|---|
| 검토 일정 | 수동 검토만 | HeyDeer가 풀 리퀘스트를 자동으로 검토할지 정합니다. PR당 한 번, 푸시할 때마다, 수동 검토만 중에서 선택합니다. |
| PR당 최대 자동 검토 횟수 | 5 | 푸시할 때마다를 사용할 때, 자동 검토가 이 횟수만큼 성공하면 해당 풀 리퀘스트의 자동 검토를 중지합니다. 1, 2, 3, 5, 10, 20 또는 제한 없음을 선택할 수 있습니다. |
| PR이 닫히면 자동 검토 중지 | 켜짐 | 풀 리퀘스트가 닫히거나 병합되면 대기 중이거나 실행 중인 자동 검토를 중지합니다. |
| 자동 검토 필터 | PR 상태 → 초안이 아님, PR 출처 → 다음 중 하나 → 동일한 저장소, 작성자 → 다음 중 하나가 아님 → dependabot[bot], renovate[bot], pre-commit-ci[bot], snyk-io[bot], snyk-bot | 라벨, 작성자, 팀, 계정 유형, 초안 상태, 출처를 기준으로 자동 검토 대상 풀 리퀘스트를 정합니다. 풀 리퀘스트는 모든 행과 일치해야 합니다. |
검토 방식
| 설정 | 기본값 | 동작 |
|---|
| 기본 검토 깊이 | 표준 | 표준 또는 심층. 심층은 각 단계에 더 많은 시간을 들이고 크레딧을 더 많이 사용하며 유료 요금제가 필요합니다. |
| 새 변경 사항만 검토 | 켜짐 | 이후 검토는 마지막 검토 이후 변경된 부분만 다루고 이전 문제를 다시 확인합니다. |
| 피드백 범위 | 균형 | 확신도와 심각도에 따라 HeyDeer가 보고할 발견 사항을 정합니다. 간결, 균형, 상세 중에서 선택합니다. |
| 검토 언어 | English | 발견 사항, HeyDeer Review 검사, 명령에 대한 답글 등 HeyDeer가 GitHub에 게시하는 모든 내용의 언어입니다: English, 简体中文, 日本語, Español, 한국어, Português (Brasil), Deutsch. 코드와 파일 경로는 그대로 유지됩니다. |
| 관련 이슈 및 PR 읽기 | 켜짐 | HeyDeer가 같은 저장소에서 변경 사항을 설명하는 이슈와 풀 리퀘스트를 읽을 수 있게 합니다. |
| 워크스루 | 켜짐 | 변경 사항 안내를 추가합니다. 관련 편집을 묶고 중요한 것을 강조합니다. |
| 저장소 스냅샷 유지 | 켜짐 | 대규모 저장소는 기본 브랜치 스냅샷에서 검토를 더 빨리 시작합니다. 스냅샷은 마지막으로 사용된 지 하루가 지나거나 이 설정을 끄면 삭제됩니다. |
결과 게시
| 설정 | 기본값 | 동작 |
|---|
| 자동 승인 | 꺼짐 | 아래 두 조건을 충족하는 풀 리퀘스트를 HeyDeer가 승인할 수 있게 합니다. PR에 검토 댓글 게시가 켜져 있을 때만 작동합니다. |
| HeyDeer가 승인할 수 있는 PR | 위험이 낮거나 중간인 PR | HeyDeer가 승인하는 가장 높은 위험 수준: 위험이 낮은 PR, 위험이 낮거나 중간인 PR 또는 모든 위험 수준의 PR. |
| 남겨 둘 수 있는 문제 | 미해결 문제 없음 | 심각도가 낮은 발견 사항이나 이전 문제가 남아 있을 때도 HeyDeer가 승인할 수 있는지 정합니다. 미해결 문제 없음 또는 낮은 심각도의 문제 허용 중에서 선택합니다. |
| GitHub 검사 게시 | 켜짐 | HeyDeer Review 검사에 검토 진행 상황과 결과를 표시합니다. |
| 문제가 발견되면 검사를 실패로 표시 | 꺼짐 | 발견 사항, 처리되지 않았거나 확인되지 않은 이전 문제, 완료되지 않은 검토가 있으면 검사를 실패로 표시합니다. GitHub 검사 게시가 켜져 있을 때만 적용됩니다. |
| PR에 검토 댓글 게시 | 켜짐 | 각 검토를 풀 리퀘스트에 게시합니다. 끄면 자동 승인과 대화 해결도 꺼집니다. |
| 처리된 HeyDeer 대화를 해결됨으로 표시 | 켜짐 | 이후 검토에서 우려가 해결된 것을 확인하거나 처리하지 않기로 한 결정을 받아들이면 HeyDeer의 대화를 해결합니다. |
Autopilot
| 설정 | 기본값 | 동작 |
|---|
| 실행당 최대 회차 | 5 | Autopilot 실행이 이 회차 수에 도달하면 멈춥니다. 3, 5, 8, 10, 12 또는 15를 선택할 수 있습니다. |
수동 검토 권한
| 설정 | 기본값 | 동작 |
|---|
| 검토를 요청할 수 있는 사람 | 저장소 쓰기 권한이 있는 모든 사용자 | PR 댓글이나 검사에서 HeyDeer에 검토를 요청할 수 있는 사람을 정합니다. 다른 옵션인 쓰기 권한이 있는 선택한 사용자 또는 팀에는 사용자 이름을 최대 100개, 조직에서는 팀을 최대 30개까지 지정할 수 있습니다. |
HeyDeer에서 구성
검토는 HeyDeer가 검토를 대기열에 넣을 때 저장되어 있던 검토 규칙, 지침, 커넥터를 사용합니다. 풀 리퀘스트는 이를 바꿀 수 없습니다.
| 구성 | 위치 | 변경할 수 있는 사람 | 규칙 및 제한 |
|---|
| 검토 규칙 | 워크스페이스 설정 → 검토 규칙, 또는 저장소 → (저장소) → 검토 규칙 | 워크스페이스 관리자 | 저장소는 사용자 지정하기 전까지 각 워크스페이스 기본값을 따릅니다. |
| 검토 지침 | 워크스페이스 설정 → 검토 지침, 또는 저장소 → (저장소) → 검토 지침 | 워크스페이스 관리자 | 일반 텍스트 또는 Markdown으로, 워크스페이스와 저장소에 각각 최대 12,000자까지 작성할 수 있습니다. 충돌하는 경우 저장소 지침이 우선합니다. |
| 커넥터 | 워크스페이스 설정 → 커넥터 | GitHub 조직 또는 계정의 소유자이기도 한 워크스페이스 관리자 | 커넥터는 유료 요금제에 포함됩니다. 워크스페이스마다 최대 50개까지 둘 수 있으며, 각 커넥터는 공개 HTTPS 엔드포인트의 Streamable HTTP 서버여야 합니다. |
관리자는 GitHub에서 접근할 수 있는 저장소의 설정만 변경할 수 있습니다. 워크스페이스 멤버를 참고하세요.
저장소 파일
HeyDeer는 검토 중인 저장소에서 다음 파일도 읽습니다. 풀 리퀘스트의 브랜치에 푸시할 수 있는 사람은 누구나 그 브랜치에서 읽는 파일을 바꿀 수 있습니다. 풀 리퀘스트가 바꿀 수 있는 것을 참고하세요.
| 파일 | 읽는 위치 | 규칙 및 제한 |
|---|
AGENTS.md, CLAUDE.md | 풀 리퀘스트 자체의 버전 | 모든 디렉터리에 둘 수 있습니다. 해당 디렉터리와 그 하위에 적용되며, 더 깊은 위치의 파일이 우선합니다. AGENTS.md가 없는 디렉터리에서는 CLAUDE.md를 읽습니다. 루트부터 한 디렉터리까지 합계 최대 32KiB까지 읽으며, 나머지는 제외됩니다. |
REVIEW.md | 풀 리퀘스트 자체의 버전 | 모든 디렉터리에 둘 수 있습니다. 해당 디렉터리와 그 하위의 변경 사항에 적용되며, 더 깊은 위치의 파일이 우선합니다. 심볼릭 링크는 읽지 않습니다. |
.agents/checks/*.md | 풀 리퀘스트 자체의 버전 | 검사마다 프런트매터에 files가 있는 Markdown 파일 하나를 .agents/checks 바로 아래에 둡니다. 이름은 문자나 숫자로 시작해야 하며 문자, 숫자, ., _, -를 사용할 수 있습니다. 파일당 최대 16,000바이트입니다. 한 번의 검토에서는 일치하는 검사를 파일 이름 순서로 최대 10개까지 실행합니다. |
.agents/skills/ | 풀 리퀘스트 자체의 버전 | 검사에서 지정한 경우에 사용됩니다. 각 스킬은 SKILL.md가 있는 폴더이며, 이름에는 소문자, 숫자, 단일 하이픈을 사용해 최대 64자까지 지정할 수 있습니다. |
.gitattributes | 기준 브랜치 | linguist-generated로 표시된 파일과, -linguist-generated로 표시되지 않은 기존 lock 파일은 검토에서 제외됩니다. 기준 브랜치에 병합할 수 있는 사람은 누구나 이 설정을 바꿀 수 있습니다. |
검사 프런트매터
모든 검사는 두 --- 줄 사이의 YAML 프런트매터로 시작합니다. HeyDeer는 다른 키를 무시합니다.
| 키 | 값 | 효과 |
|---|
files | 패턴 하나 또는 패턴 목록 | 필수. 없으면 HeyDeer가 파일을 무시합니다. 검사 대상이 되는 변경된 파일입니다. 파일을 제외하려면 패턴 앞에 !를 붙이세요. 제외 패턴을 쓰려면 포함 패턴이 하나 이상 있어야 합니다. |
skills | 스킬 이름 하나 또는 이름 목록 | 선택. 검사에서 사용하는 스킬로, 풀 리퀘스트에서 불러옵니다. 스킬이 없어도 검토는 중단되지 않습니다. |
