검토 결과 읽기
HeyDeer는 발견 사항을 GitHub 풀 리퀘스트 검토로 게시하며, 각 발견 사항이 가리키는 줄에 인라인 댓글을 답니다.
HeyDeer가 게시하는 내용
GitHub의 검토에는 요약이 없습니다. 요약과 전체 발견 사항 목록은 HeyDeer Review 검사와 HeyDeer에서 볼 수 있습니다.
검토 댓글에는 검토 경고, 추가 발견 사항, 승인 사유만 담깁니다. 게시할 내용이 없는 검토는 댓글을 추가하지 않습니다. 검토가 GitHub에 담기에 너무 길면 HeyDeer는 일부 발견 사항을 생략하고 “HeyDeer에서 모든 지적 사항 보기” 링크를 추가합니다.
HeyDeer는 자동 승인이 켜져 있을 때만 풀 리퀘스트를 승인하며, 논의에서 이미 제기된 문제는 반복하지 않습니다. 후속 검토를 참고하세요.
“PR에 리뷰 코멘트 게시”가 꺼져 있으면 검사에만 검토가 담깁니다. 결과 게시를 참고하세요.
발견 사항의 구성
| 부분 | 표시 내용 |
|---|---|
| 제목 | 심각도와 제목. 예: HIGH: 404 응답에서 재시도 루프가 멈추지 않음. |
| 설명 | 무엇이 문제이고 어떤 결과를 낳는지. |
| 수정 제안 | 말로 설명한 수정 방법. |
| 변경 제안 | GitHub 제안(suggestion) 또는 읽기 전용 diff 형태의 정확한 수정. |
| 검사 | 해당 발견 사항을 제기한 저장소 검사. |
| 관련 코드 | 댓글이 해당 줄에 달리지 않은 경우, 그 줄로 가는 링크. |
심각도는 Critical, High, Medium, Low 중 하나로 영향도를 나타내며, HeyDeer의 확신도와는 별개입니다. 게시되는 발견 사항을 줄이거나 늘리려면 확신도로 거르는 피드백 범위를 변경하세요.
커밋할 수 있는 제안은 댓글이 대체할 줄에 정확히 달려 있을 때만 표시되며, 그 외에는 변경 내용이 읽기 전용 diff로 표시됩니다. HeyDeer는 포매터나 테스트를 실행하지 않으므로, 제안을 커밋하기 전에 읽어 보세요.
GitHub는 diff에 포함된 줄에만 인라인 댓글을 허용합니다. 변경으로 인해 깨지는 변경되지 않은 호출부처럼 다른 코드에 대한 발견 사항은 검토 댓글의 “추가 지적 사항” 아래에 들어갑니다.
검토 경고
검토에 제약이 있었던 경우, 검토 댓글, 검사, HeyDeer에 “검토 경고”가 표시됩니다.
| 경고 | 조치 방법 |
|---|---|
| 확신도가 낮은 발견 사항이 생략됨 | 검토는 확신도가 가장 높은 발견 사항 30개를 유지합니다. 이를 처리한 다음 검토를 다시 요청하세요. |
| 처음 10개 검사만 선택됨 | 저장소 검사는 파일 이름 순서로 최대 10개까지 적용됩니다. 파일 패턴을 좁히세요. |
이 풀 리퀘스트는 .agents/를 변경하지만 새 검사 구성이 유효하지 않음 | 병합하기 전에 구성을 수정하세요. 그렇지 않으면 HeyDeer가 그 브랜치의 풀 리퀘스트를 검토할 수 없습니다. |
| 일부 발견 사항 또는 스레드 평가가 유효하지 않거나 불완전함 | 완전한 결과를 받으려면 검토를 다시 요청하세요. |
경고가 있는 검토는 불완전합니다. HeyDeer는 이를 승인하지 않고, 검사는 성공을 보고하지 않으며, 다음 검토는 풀 리퀘스트 전체를 다룹니다.
검토 언어
“검토 언어”는 발견 사항, 요약, 경고, 그리고 스레드에서 HeyDeer가 다는 답글의 언어를 정합니다. 영어(기본값), 중국어 간체, 일본어, 스페인어, 한국어, 포르투갈어(브라질), 독일어 중에서 선택하세요. 코드와 파일 경로는 그대로 유지됩니다.
조직 설정 → 검토 규칙의 “리뷰 방식” 아래에서, 또는 저장소의 검토 규칙에서 설정합니다.
HeyDeer의 검토 페이지
모든 검토에는 HeyDeer 페이지가 있습니다. “검토” 목록, 검사의 Details 링크, 또는 “HeyDeer에서 모든 지적 사항 보기”에서 열 수 있습니다. 검토를 시작한 계기, 검토가 “새 변경 사항”을 다뤘는지 “PR 전체”를 다뤘는지, “사용한 크레딧”, 피드백 범위 안의 모든 발견 사항, “논의에서 처리하지 않기로 한 우려 사항” 아래에 표시된 우려 사항을 보여 줍니다.
“피드백 범위 미리 보기”는 아무것도 변경하지 않고 각 피드백 범위에서 유지될 발견 사항을 보여 줍니다. 쓰기 권한이 있는 사람은 “검토 취소”로 검토를 중지할 수 있으며, 이미 사용한 크레딧은 반환되지 않습니다.