코드 검토가 없는 팀
에이전트가 main에 직접 커밋하거나 CI만 통과하면 풀 리퀘스트가 병합되는 등, 아무도 읽지 않은 변경이 main에 들어간다면 이 구성을 사용하세요. HeyDeer가 푸시마다 검토하고, HeyDeer가 승인하면 GitHub가 풀 리퀘스트를 병합합니다.
권장 구성
- 에이전트가 main에 커밋하는 대신, 모든 변경을 브랜치에 푸시하고 풀 리퀘스트를 열도록 하세요.
- 워크스페이스 설정 → 검토 규칙 → 검토 시점에서 푸시할 때마다를 선택하세요. 자동 검토를 참고하세요.
- 결과 게시에서 문제가 발견되면 검사를 실패로 표시를 켜세요. HeyDeer Review 검사를 참고하세요.
- 결과 게시에서 자동 승인을 켜세요. 그러면 완료된 검토에서 발견 사항이 남지 않을 때 HeyDeer가 풀 리퀘스트를 승인합니다. 자동 승인을 참고하세요.
- 위험이 높은 변경을 누가 승인할지 정하세요. 기본적으로 위험이 높은 풀 리퀘스트는 사람의 승인을 기다립니다. HeyDeer가 이런 풀 리퀘스트도 승인하게 하려면 HeyDeer가 승인할 수 있는 PR을 모든 위험 수준의 PR로 설정하세요.
- GitHub의 main 브랜치 규칙에서 Require a pull request before merging를 켜고 필수 승인 수를 1로 설정하세요. Dismiss stale pull request approvals when new commits are pushed도 켜세요.
- 같은 규칙에서 CI 검사와 함께 HeyDeer Review 검사를 필수로 지정하세요.
- 저장소의 GitHub 설정에서 Allow auto-merge를 켜세요. 그런 다음 각 풀 리퀘스트에서 자동 병합을 활성화하거나, 에이전트가 풀 리퀘스트를 연 뒤
gh pr merge --auto --squash를 실행하도록 하세요.
에이전트가 발견 사항을 처리하게 하기
HeyDeer는 발견 사항을 풀 리퀘스트에 검토로 게시하며, HeyDeer Review 검사에 전체 보고서가 담깁니다. 에이전트가 푸시할 때마다 검토를 읽고, 발견 사항을 수정하고, 다시 푸시하도록 하세요. 그러면 HeyDeer가 새 커밋을 검토합니다.
발견 사항을 처리하지 않기로 했다면, 쓰기 권한이 있는 사람이 해당 대화에서 결정을 설명하거나 대화를 해결됨으로 표시한 다음 @heydeer review 댓글을 남기세요. 발견 사항 거절하기를 참고하세요.
대신 선택한 발견 사항을 HeyDeer가 별도 PR에서 수정하도록 하려면 검토에서 HeyDeer로 수정을 선택하세요. HeyDeer로 수정을 참고하세요.
팀의 기준을 검사로 작성하기
에이전트는 검토에서 강제하는 요구 사항을 더 확실하게 지킵니다. 요구 사항마다 .agents/checks/에 Markdown 파일을 추가하면, HeyDeer가 일치하는 파일을 변경하는 모든 풀 리퀘스트에 그 요구 사항을 적용합니다. 저장소 검사를 참고하세요.
.agents/checks/tenant-scope.md
---
files:
- "src/db/**/*.ts"
- "!**/*.test.ts"
---
Every query that reads or writes customer data must be
scoped to one tenant, taken from the request context and
never from request parameters.별도의 검토가 도움이 되는 이유
CI는 테스트가 다루는 부분만 잡아냅니다. 검토가 없으면 다음 두 가지 문제를 놓치게 됩니다:
- 코드를 작성한 모델은 작업을 확인하라고 요청해도 자신의 추론을 그대로 받아들이고 자신의 실수를 놓치기 쉽습니다.
- 에이전트가 같은 코드를 거듭 수정하면, 매번의 변경이 이전에 제대로 되어 있던 부분을 모르는 사이에 깨뜨릴 수 있습니다.
HeyDeer는 코드를 작성한 에이전트와 별개로 각 풀 리퀘스트를 검토하며, 각 발견 사항을 게시하기 전에 코드와 대조해 확인합니다. 이후 푸시에서는 후속 검토가 이전 문제를 다시 확인합니다.