모범 사례
팀에 도입하기
HeyDeer를 단계적으로 도입하고, 팀이 결과를 신뢰하게 된 후에만 병합을 막도록 하세요.
단계
- 몇 개의 풀 리퀘스트에서 시험해 보세요. 새 워크스페이스는 “수동만”으로 시작합니다. 최근의 다양한 풀 리퀘스트 몇 개에 @heydeer review라고 댓글을 남기고, 발견 사항을 검토자의 의견과 비교하세요.
- 발견한 빈틈을 채우세요. 그 검토에서 필요하다고 드러난 것만 추가하세요. 컨벤션, 항상 지켜야 하는 규칙, 우선순위가 여기에 해당합니다. 규칙을 둘 위치를 참고하세요.
- 자동 검토를 켜세요. 한두 개 저장소에서 “PR당 한 번”으로 시작한 다음, “PR당 최대 자동 리뷰 횟수”를 정해 “푸시할 때마다”로 전환하고 조직 일정을 설정하세요. 자동 리뷰를 참고하세요.
- 병합을 막지 않고 검사를 게시하세요. 기본적으로 HeyDeer Review 검사는 검토에서 문제가 발견되어도 통과합니다. 팀이 발견 사항에 익숙해지는 동안 그대로 두세요.
- 팀이 신뢰하게 되면 검사를 필수로 지정하세요. GitHub 브랜치 규칙에서 HeyDeer Review를 필수 검사로 지정한 다음 “문제가 발견되면 검사를 실패로 표시”를 켜세요. 그러면 자동으로 검토되지 않은 리비전은 @heydeer review를 기다리게 됩니다. HeyDeer Review 검사를 참고하세요.
- 자동 승인 여부를 결정하세요. 기본적으로 꺼져 있습니다. 켠다면 “단순한 변경만”으로 시작하고, 브랜치 규칙에서 오래된 승인을 철회하도록 설정하세요. 자동 승인을 참고하세요.
- 알림과 지출 관리를 설정하세요. 크레딧 및 체험 알림을 받을 워크스페이스 이메일을 추가하고, 사용량 한도와 함께 자동 충전을 켜세요. 알림 및 자동 충전 및 사용량 한도를 참고하세요.
- HeyDeer와 함께 일하는 방법을 팀에 알리세요. PR 댓글 명령, 답글로 발견 사항을 거절하는 방법, 검토하기 좋은 풀 리퀘스트를 작성하는 방법을 공유하세요.
체크리스트
- “수동만”으로 실제 풀 리퀘스트 몇 개를 검토함
- 그 검토에서 놓친 부분에 대해 AGENTS.md, 검사 또는 지침을 추가함
- 생성된 파일을 표시하고 봇 풀 리퀘스트를 필터링함
- “PR당 한 번”을 켠 다음, 검토 한도와 함께 “푸시할 때마다”로 전환함
- 문제가 있어도 실패하지 않도록 HeyDeer Review 검사를 게시함
- 검사를 필수로 지정하고 문제가 있으면 실패시킬지 결정함
- 자동 승인 여부를 결정함
- 알림 이메일, 자동 충전, 사용량 한도를 설정함
- 명령과 발견 사항을 거절하는 방법을 공유함
몇 주 후에 최근 검토를 다시 읽고, 잘못 배치된 규칙을 옮기고, 아무 효과가 없는 규칙을 제거하세요.