heydeer
모범 사례

사람 검토자가 있는 팀

모든 풀 리퀘스트를 병합 전에 사람이 검토한다면 이 구성을 사용하세요. HeyDeer가 먼저 세부 사항을 확인하므로 검토자는 설계와 제품 결정에 집중할 수 있습니다.

권장 구성

풀 리퀘스트 생성
HeyDeer가 세부 사항 검토
작성자가 발견 사항 수정
검토자가 설계 확인 후 병합
  1. 워크스페이스 설정 → 검토 규칙 → 검토 시점에서 푸시할 때마다를 선택하세요. 자동 검토를 참고하세요.
  2. 결과 게시에서 문제가 발견되면 검사를 실패로 표시를 켜세요. HeyDeer Review 검사를 참고하세요.
  3. GitHub의 main 브랜치 규칙에서 HeyDeer Review 검사를 필수로 지정하세요. 그러면 HeyDeer가 최신 커밋을 검토하고 발견 사항과 이전 문제가 수정되거나 거절된 후에만 풀 리퀘스트를 병합할 수 있습니다.
  4. 검토자에게 HeyDeer Review 검사를 통과한 후에 풀 리퀘스트를 읽기 시작하도록 요청하세요. 그러면 검토자는 설계, 제품 동작, 그리고 HeyDeer가 추가 설명 필요 아래에 나열한 질문에 집중할 수 있습니다.
일부 검사가 성공하지 못함
HeyDeer Review — 검토에서 처리해야 할 문제를 발견함
CI / test — 성공
병합이 차단됨
검사를 필수로 지정하면, 발견 사항을 수정하거나 처리하지 않기로 결정하기 전까지 풀 리퀘스트를 병합할 수 없습니다.

풀 리퀘스트가 PR당 최대 자동 검토 횟수에 도달한 경우처럼 HeyDeer가 자동으로 검토하지 않는 커밋도 누군가 검토를 요청할 때까지 병합을 막습니다. 문제 해결을 참고하세요.

선택 사항: 일상적인 변경 자동 승인하기

자동 승인을 켜고 HeyDeer가 승인할 수 있는 PR을 위험이 낮거나 중간인 PR로 유지하세요. 그러면 발견 사항이 남지 않은 일상적인 풀 리퀘스트는 HeyDeer가 승인하고, 위험이 높은 풀 리퀘스트는 사람의 승인을 기다립니다. 그 이유는 검토에 표시됩니다.

브랜치 규칙에서 필수 승인 수가 1이면, 일상적인 풀 리퀘스트는 검토자를 기다리지 않고 병합할 수 있습니다. 모든 승인이 최신 코드를 기준으로 하도록 Dismiss stale pull request approvals when new commits are pushed를 켜세요.

팀의 기준을 검사로 작성하기

검토자가 댓글에서 반복해서 지적하는 요구 사항은 검사로 만드세요. 요구 사항마다 .agents/checks/에 Markdown 파일을 추가하면, HeyDeer가 일치하는 파일을 변경하는 모든 풀 리퀘스트에 그 요구 사항을 적용합니다. 저장소 검사를 참고하세요.

.agents/checks/migrations.md

---
files: "migrations/**/*.sql"
---
The previous release keeps running while a migration
deploys. Report a migration that:

- drops or renames a table or column that code on the
  base branch still uses;
- adds a NOT NULL column without a default;
- creates an index on an existing table without
  CONCURRENTLY.

HeyDeer가 맡는 일

  • 세부 사항과 엣지 케이스. HeyDeer는 모든 풀 리퀘스트에서 오류 처리, 경계값, 동시성, 그리고 변경으로 인해 깨지는 호출부를 확인합니다.
  • 세부 사항까지 정확하게. 내부 풀 리퀘스트 1,000개에서 HeyDeer는 세부적인 코드의 올바름을 사람 검토자보다 더 정확하게 검토했습니다.