PR 댓글 명령
풀 리퀘스트에 댓글을 남겨 HeyDeer 검토를 요청하거나, 자동 검토를 일시 중지하거나, Autopilot을 시작합니다. 명령은 검토 일정과 관계없이 연결된 모든 저장소에서 작동합니다.
명령
| 명령 | 동작 |
|---|---|
@heydeer review | 저장소의 기본 깊이와 피드백 범위로 현재 커밋을 검토합니다. 새 변경 사항만 검토가 켜져 있으면 마지막 검토 이후 변경된 부분을 다룹니다. 후속 검토를 참고하세요. |
@heydeer full review | 풀 리퀘스트 전체를 다시 검토합니다. |
@heydeer pause | 이 풀 리퀘스트의 자동 검토를 중지합니다. 대기 중인 검토는 계속 진행되며, 검토를 직접 요청할 수도 있습니다. |
@heydeer resume | 이 풀 리퀘스트의 자동 검토를 재개합니다. 검토를 바로 시작하지는 않습니다. |
@heydeer autopilot | Autopilot을 시작합니다. HeyDeer가 이 풀 리퀘스트의 남은 항목을 수정하고 브랜치에 푸시한 뒤 병합할 수 있을 때까지 변경 사항마다 검토합니다. |
@heydeer autopilot stop | 이 풀 리퀘스트에서 Autopilot을 멈춥니다. |
결과는 게시 설정을 따릅니다. HeyDeer가 검토를 실행할 수 없거나 검토가 실패하거나 취소되면 HeyDeer가 댓글에 답합니다. 일시 중지와 재개에는 바로 답합니다. Autopilot 명령에는 반응이 달리고, Autopilot 자체 댓글에서 진행 상황을 확인할 수 있습니다.
요청한 검토도 다른 검토와 똑같이 크레딧이 차감됩니다. 크레딧 사용 방식을 참고하세요. 요청한 검토는 PR당 최대 자동 검토 횟수에 포함되지 않습니다.
같은 커밋의 검토가 대기 중이거나 진행 중이면 @heydeer review만 포함한 댓글은 새 검토를 시작하지 않고 기존 검토에 합류하며, 추가 크레딧을 사용하지 않습니다. 댓글에는 평소처럼 👀 반응이 추가되고 검토 결과도 평소처럼 보고됩니다. 해당 검토는 요청된 후에 게시된 댓글을 읽지 않습니다. 새 댓글을 포함하려면 검토가 끝난 뒤 다시 요청하세요.
HeyDeer가 댓글을 읽는 방식
- 새 PR 대화 댓글이나 인라인 검토 댓글의 아무 곳에나 명령을 포함하세요. 인라인 댓글의 명령도 해당 줄만이 아니라 평소처럼 풀 리퀘스트를 검토합니다.
- 명령은 코드, 인용문, HTML 주석 안이 아닌 일반 텍스트로 작성하세요. HeyDeer는 수정된 댓글과 봇이 작성한 댓글을 무시합니다.
- 댓글에 여러 명령이 있으면 HeyDeer는 첫 번째 명령만 실행합니다.
- 검토 깊이나 피드백 범위를 선택하려면 HeyDeer에서 검토를 시작하세요.
그 밖에 @heydeer를 멘션하면 HeyDeer에 질문하거나 작업을 맡길 수 있습니다. @heydeer 멘션을 참고하세요.
명령에 👀나 답글이 달리지 않으면 문제 해결을 참고하세요.
부족한 맥락 추가하기
검토가 추가 설명 필요에서 질문하거나 발견 사항이 알고 있는 사실을 놓쳤다면 새 댓글로 설명하세요. 같은 댓글에 @heydeer review를 포함하면 설명을 반영한 검토를 요청할 수 있습니다.
설명을 포함한 요청마다 코드가 바뀌지 않았더라도 최신 논의를 읽는 새 검토가 실행됩니다. 명령이 없는 답글로는 검토가 시작되지 않습니다.
발견 사항을 처리하지 않기로 결정하려면 발견 사항 거절하기를 참고하세요.
명령을 실행할 수 있는 사람
명령을 실행할 수 있는 사람은 검토를 요청할 수 있는 사람 설정으로 정해집니다. 워크스페이스 설정 → 검토 규칙 → 수동 검토 권한 또는 저장소의 검토 규칙에서 설정하세요.
| 옵션 | 검토를 요청할 수 있는 사람 |
|---|---|
| 저장소 쓰기 권한이 있는 모든 사용자 | 기본값. 쓰기, 유지 관리(maintain) 또는 관리자(admin) 권한이 있는 모든 사람. |
| 쓰기 권한이 있는 선택한 사용자 또는 팀 | “GitHub 사용자 이름” 또는 “팀”에 포함되어 있고 쓰기 권한도 있는 사람. |
HeyDeer에서 시작한 검토와 검사 버튼으로 시작한 검토에도 같은 규칙이 적용됩니다. 자동 검토 필터는 요청한 검토를 제한하지 않습니다.