metyatech/skill-pr-review-workflow

PR 리뷰 피드백 워크플로우

리뷰 피드백 해결

• PR 리뷰 피드백을 처리한 후, 에이전트는 마무리하기 전에 해당 리뷰 스레드를 반드시 해결해야 합니다. 권한이 없는 경우 에이전트는 이를 명시적으로 밝혀야 합니다.
• 재검토를 요청하기 전에, 에이전트는 관련 검증 스위트를 실행하고 그 결과(명령어와 결과)를 PR 코멘트나 설명에 요약해야 합니다.
• 피드백이 에이전트의 실수 또는 재사용 가능한 추론 간극으로 인해 발생한 경우, 에이전트는 재발 방지가 테스트, 검사, 스킬 또는 규칙 중 어디에 포함되어야 하는지 평가해야 합니다. 규칙이나 스킬 업데이트가 필요하면 에이전트는 동일한 변경 세트의 일부로 업데이트를 수행해야 합니다. 필요하지 않은 경우, 에이전트는 가장 빠른 재사용 가능한 게이트가 다른 곳에 있는 이유를 간략히 설명해야 합니다.

재검토 요청

• 수정 사항을 푸시한 후, 에이전트는 현재 라운드에서 해결된 피드백을 남긴 검토자에게만 재검토를 요청해야 합니다.
• 에이전트는 해결된 피드백을 남기지 않았거나 이미 조치 가능한 문제가 없다고 표시한 검토자(AI 검토자 포함)에게 재검토를 요청해서는 안 됩니다.
• 적용 가능한 검토자가 더 이상 없는 경우, 에이전트는 누가 다음에 검토해야 하는지 물어봐야 합니다.

AI 리뷰 봇 재검토

리포지토리에 Codex 또는 Copilot 리뷰 봇이 구성된 경우, 에이전트는 해결된 피드백을 남긴 봇에 대해서만 재검토를 트리거해야 합니다.

• Codex 재검토: PR에 @codex review 코멘트를 남깁니다.
• Copilot 재검토: GitHub API를 사용하여 봇 검토자 copilot-pull-request-reviewer[bot]을 제거하고 다시 요청합니다. 에이전트는 UI 기반 검토자 할당에 의존해서는 안 됩니다.
  • 제거: DELETE /repos/{owner}/{repo}/pulls/{pr}/requested_reviewers 본문 {"reviewers":["copilot-pull-request-reviewer[bot]"]}
  • 추가: POST /repos/{owner}/{repo}/pulls/{pr}/requested_reviewers 본문 {"reviewers":["copilot-pull-request-reviewer[bot]"]}

GitHub 알림 관리

• 에이전트는 DELETE /notifications/threads/{id} (HTTP 204)를 사용하여 알림을 완료로 표시해야 합니다(받은 편지함에서 알림을 제거하고 완료 탭으로 이동).
• 에이전트는 PATCH /notifications/threads/{id}를 사용해서는 안 됩니다. 이는 읽음으로 표시하지만 알림을 받은 편지함에 남겨둡니다.
• 알림을 처리한 후, 에이전트는 동일한 DELETE API를 사용하여 읽었지만 완료되지 않은 나머지 알림을 일괄 삭제해야 합니다.

병합 후 정리

• PR을 완료한 후, 에이전트는 PR을 병합하고, 대상 브랜치를 동기화한 다음, 로컬 및 원격에서 PR 브랜치를 삭제해야 합니다.