자동 검토 필터
자동 검토 필터는 HeyDeer가 스스로 검토할 풀 리퀘스트를 정합니다. 직접 요청한 검토는 제한하지 않습니다. PR 댓글 명령을 참고하세요.
필터 작동 방식
자동 검토 필터는 워크스페이스 설정 → 검토 규칙의 검토 시점 아래 또는 저장소의 검토 규칙 탭에 있습니다. 검토 일정이 수동 검토만이 아니면 편집할 수 있습니다.
각 행에는 필드, 연산자(다음 중 하나, 다음 중 하나가 아님, 라벨 없음), 값이 있습니다. 풀 리퀘스트는 모든 행과 일치해야 대상이 됩니다. 라벨과 사용자 이름은 대소문자를 구분하지 않습니다.
| 필드 | 값 |
|---|---|
| PR 라벨 | 라벨 이름 |
| 작성자 | alex, dependabot[bot] 같은 GitHub 사용자 이름 |
| 작성자의 팀 | 조직의 팀(하위 팀 포함) |
| 작성자 소속 | 조직 멤버, 외부 협력자(저장소 접근 권한은 있지만 조직 멤버가 아님), 기타 외부 작성자 |
| 작성자 계정 | 사람, 봇(GitHub App 및 봇 계정) |
| PR 상태 | 초안임, 초안이 아님 |
| PR 출처 | 동일한 저장소, 포크 |
작성자의 팀과 작성자 소속은 조직 워크스페이스에만 있으며 GitHub App의 조직 Members 권한이 필요합니다. HeyDeer가 멤버십을 확인할 수 없으면 자동 검토가 시작되지 않습니다.
기본 필터
새 워크스페이스는 PR 상태 → 초안이 아님, PR 출처 → 다음 중 하나 → 동일한 저장소, 작성자 → 다음 중 하나가 아님 → dependabot[bot], renovate[bot], pre-commit-ci[bot], snyk-io[bot], snyk-bot의 세 행으로 시작하므로, HeyDeer는 초안, 포크, 종속성 업데이트를 건너뜁니다. 행이 없으면 모든 풀 리퀘스트가 대상입니다.
종속성 업데이트는 대부분 버전과 lock 파일만 바꾸므로, 검토보다 테스트로 확인하는 편이 낫습니다. 그래도 검토하려면 해당 PR에 @heydeer review 댓글을 남기세요. 코딩 에이전트 같은 다른 봇의 풀 리퀘스트는 다른 풀 리퀘스트와 똑같이 검토됩니다.
저장소 필터
| 조건 출처 | 동작 |
|---|---|
| 워크스페이스 필터 따르기 | 워크스페이스의 행이 적용되며, 여기서 추가하는 행으로는 대상 풀 리퀘스트의 범위를 좁히기만 할 수 있습니다. |
| 이 저장소에서 별도로 설정 | 저장소의 행이 워크스페이스의 행을 대체하며, 처음에는 워크스페이스 행의 사본으로 시작합니다. 필터를 완화할 때 사용하세요. |
워크스페이스 필터로 재설정을 선택하면 저장소의 행이 제거됩니다.
활용 예시
각 활용 예시는 기본 행을 그대로 둔다고 가정합니다.
| 목표 | 행 |
|---|---|
| 모든 봇 건너뛰기 | 작성자 계정 → 다음 중 하나가 아님 → 봇 |
| 더 많은 봇 건너뛰기 | “작성자” 행에 이름 추가(예: github-actions[bot]) |
| 종속성 업데이트도 검토하기 | “작성자” 행 제거 |
| 초안도 검토하기 | “PR 상태” 행 제거 |
| 라벨 필수로 지정하기 | PR 라벨 → 다음 중 하나 → ai-review |
| 특정 라벨 건너뛰기 | PR 라벨 → 다음 중 하나가 아님 → skip-review |
| 외부 기여자만 검토하기 | 작성자 소속 → 다음 중 하나 → 외부 협력자, 기타 외부 작성자. “PR 출처” 행 제거 |
| 한 팀만 검토하기 | 작성자의 팀 → 다음 중 하나 → backend |