참조
설정 참조
모든 검토 설정과 그 값 및 기본값입니다. 조직 기본값은 조직 설정 → 검토 규칙에서 설정하며, 저장소는 저장소 → (저장소) → 검토 규칙에서 어떤 설정이든 재정의할 수 있습니다. 설정 작동 방식을 참고하세요.
리뷰 시점
| 설정 | 값 | 기본값 |
|---|---|---|
| 리뷰 시점 | PR당 한 번, 푸시할 때마다, 수동만 | 새 워크스페이스에서는 수동만 |
| PR당 최대 자동 리뷰 횟수 | 1, 2, 3, 5, 10, 20, 제한 없음. “푸시할 때마다”에서만 적용됩니다. | 5 |
| PR이 닫히면 자동 리뷰 중지 | 켜짐, 꺼짐 | 켜짐 |
| 자동 리뷰 필터 | PR 라벨, 작성자, 작성자의 팀, 작성자 소속, 작성자 계정, PR 상태, PR 출처에 대한 조건. 풀 리퀘스트는 모든 조건과 일치해야 합니다. | PR 상태가 초안이 아니고, PR 출처가 동일한 저장소 |
리뷰 방식
| 설정 | 값 | 기본값 |
|---|---|---|
| 기본 검토 깊이 | 표준, 심층 | 표준 |
| 새 변경 사항만 리뷰 | 켜짐, 꺼짐 | 켜짐 |
| 피드백 범위 | 간결, 균형, 상세 | 균형 |
| 검토 언어 | English, 简体中文, 日本語, Español, 한국어, Português (Brasil), Deutsch | English |
| 연결된 이슈 읽기 | 켜짐, 꺼짐 | 켜짐 |
결과 게시
| 설정 | 값 | 기본값 |
|---|---|---|
| 자동 승인 | 자동 승인 안 함, 단순한 변경만, 문제가 발견되지 않은 경우 | 자동 승인 안 함 |
| GitHub 검사 게시 | 켜짐, 꺼짐 | 켜짐 |
| 문제가 발견되면 검사를 실패로 표시 | 켜짐, 꺼짐. “GitHub 검사 게시”가 켜져 있을 때만 적용됩니다. | 꺼짐 |
| PR에 리뷰 코멘트 게시 | 켜짐, 꺼짐. 끄면 자동 승인과 스레드 해결도 꺼집니다. | 켜짐 |
| 처리된 HeyDeer 스레드를 해결됨으로 표시 | 켜짐, 꺼짐 | 켜짐 |
수동 리뷰 권한
| 설정 | 값 | 기본값 |
|---|---|---|
| 수동 리뷰를 실행할 수 있는 사용자 | 저장소 쓰기 권한이 있는 모든 사용자, 또는 쓰기 권한이 있는 선택한 사용자 또는 팀: GitHub 사용자 이름 최대 100개와, 조직의 경우 팀 슬러그 최대 30개. | 저장소 쓰기 권한이 있는 모든 사용자 |
변경 사항은 저장한 후에 요청된 검토부터 적용됩니다. 대기 중이거나 실행 중인 검토는 기존 설정을 유지합니다.
저장소 파일
HeyDeer는 검토 대상 저장소에서 다음 파일도 읽습니다.
| 파일 | 읽는 위치 | 규칙 및 제한 |
|---|---|---|
AGENTS.md, CLAUDE.md | 풀 리퀘스트 자체의 버전 | 모든 디렉터리. 해당 디렉터리와 그 하위에 적용되며, 더 깊은 위치의 파일이 우선합니다. 디렉터리에 AGENTS.md가 없으면 CLAUDE.md를 사용합니다. |
.agents/checks/*.md | 베이스 브랜치 | 검사마다 Markdown 파일 하나를 .agents/checks 바로 아래에 두며, 이름에는 문자, 숫자, 점, 밑줄, 하이픈을 사용합니다. 파일당 최대 16,000바이트이며, 검토마다 파일 이름 순서로 일치하는 검사를 최대 10개까지 적용합니다. |
.agents/skills/ | 풀 리퀘스트 자체의 버전 | 검사에서 지정한 경우에 사용됩니다. 폴더 이름이 스킬 이름이며, 소문자, 숫자, 단일 하이픈을 사용해 최대 64자입니다. |
.gitattributes | 베이스 브랜치 | linguist-generated로 표시된 파일은 검토에서 제외됩니다. |
검사 프런트매터
검사 맨 위에 둘 수 있는 선택적 YAML 프런트매터 키:
| 키 | 값 | 효과 |
|---|---|---|
files, globs, paths | 글롭 패턴 하나 또는 패턴 목록 | 검사가 적용되는 변경 파일입니다. 파일을 제외하려면 패턴 앞에 !를 붙이세요. 패턴이 없으면 변경된 모든 파일에 검사가 적용됩니다. |
skills, skill | 스킬 이름 하나 또는 이름 목록 | 검사에서 사용하는 스킬로, 풀 리퀘스트에서 불러옵니다. 스킬이 없어도 검토는 중단되지 않습니다. |
skip_extra_reviewers | true 또는 false | 심층 검토는 일치하는 각 검사에 추가로 공을 들입니다. 단순한 검사는 true로 설정하면 표준처럼 검토합니다. |
HeyDeer에서 구성
| 구성 | 위치 | 규칙 및 제한 |
|---|---|---|
| 검토 지침 | 조직 설정 → 검토 지침, 또는 저장소 → (저장소) → 검토 지침 | 일반 텍스트 또는 Markdown, 범위당 최대 12,000자. 충돌하는 경우 저장소 지침이 우선합니다. 워크스페이스 관리자가 관리합니다. |
| MCP 서버 | 조직 설정 → MCP 서버, 또는 저장소 → (저장소) → MCP 서버 | 범위당 최대 20개 서버. 각 서버는 443 포트의 공개 HTTPS 엔드포인트에 있는 Streamable HTTP 서버여야 합니다. 이름에는 소문자, 숫자, 하이픈, 밑줄을 사용하며 최대 64자입니다. GitHub 조직 또는 계정의 소유자이기도 한 워크스페이스 관리자가 관리합니다. |