모범 사례
노이즈 줄이기
HeyDeer가 팀이 읽고 싶은 것보다 많이 게시한다면, 아래에서 해당하는 노이즈 유형을 찾아 해결 방법을 적용하세요. 위쪽 행일수록 적은 노력으로 큰 효과를 얻을 수 있습니다.
해결 방법
| 노이즈 | 해결 방법 | 세부 정보 |
|---|---|---|
| 조치하지 않을 발견 사항이 너무 많음 | “피드백 범위”를 “간결”로 바꾸세요. 먼저 범위를 비교하려면 HeyDeer에서 최근 검토를 열고 “피드백 범위 미리 보기”를 사용하세요. | 피드백 범위 |
| 생성된 코드에 대한 댓글 | 베이스 브랜치의 .gitattributes에서 해당 파일을 linguist-generated로 표시하세요. | HeyDeer가 읽는 내용 |
| 봇이나 일회성 풀 리퀘스트에 대한 검토 | “작성자 계정 → 다음 중 없음 → 봇” 또는 “PR 라벨 → 다음 중 없음 → skip-review” 같은 자동 검토 필터를 추가하세요. | 검토 필터 |
| 수정하지 않기로 결정한 발견 사항 | 이유를 답글로 남기거나 스레드를 해결하세요. 쓰기 권한이 있는 사람이 결정하면 HeyDeer는 그 문제를 다시 제기하지 않습니다. | 후속 검토 |
| 아무도 조치하지 않는 유형의 댓글 | 검토 지침이나 AGENTS.md에 댓글을 달지 말아야 할 대상을 좁게, 이유와 함께 적으세요. “성능에 대해 댓글을 달지 마세요” 같은 광범위한 규칙은 피하세요. | 검토 가이드 작성 |
| 관련 없는 파일에서 작동하는 검사 | files 패턴을 좁히고 테스트나 픽스처를 제외하세요. | 효과적인 검사 작성 |
| 푸시할 때마다 실행되는 후속 검토 | “새 변경 사항만 리뷰”를 켜 두고, “PR당 최대 자동 리뷰 횟수”를 설정하거나 “PR당 한 번”을 사용하세요. | 자동 리뷰 |
| 길어진 풀 리퀘스트 대화 | “처리된 HeyDeer 스레드를 해결됨으로 표시”를 켜 두거나, “PR에 리뷰 코멘트 게시”를 꺼서 HeyDeer Review 검사에 검토를 담으세요. | 결과 게시 |
예시
.gitattributes의 생성된 파일:
src/generated/** linguist-generated
*.pb.go linguist-generated=true그대로 둘 대상에 대한 좁은 규칙:
## Leave alone
- Files under scripts/one-off/. They run once by hand and are deleted.
- Missing input validation in internal/admin-cli/. It only runs
locally with trusted input.