sentry-pr-code-review

sentry-pr-code-review 소개

Sentry의 Bug Prediction 기능을 통해 GitHub 풀 리퀘스트에서 코드 리뷰 코멘트로 플래그된 문제를 검토하고 수정하기 위한 워크플로우입니다. 누군가가 풀 리퀘스트에서 Sentry 또는 Seer 코멘트를 검토하거나 처리하라고 요청할 때, 해당 피드백을 해결하거나 아직 해결되지 않은 Sentry 피드백이 남아 있는 최근 풀 리퀘스트를 찾아야 할 때 이 도구가 적합합니다. 이 스킬은 더 넓은 Sentry 워크플로우 트리의 일부이며, 자체적으로 모델을 호출할 수 없습니다.

이 워크플로우는 gh CLI가 설치되고 인증되었으며, 저장소에 Seer by Sentry GitHub 앱이 설치되어 있어야 합니다. 이 프로세스는 네 단계로 구성됩니다. 1단계에서는 gh api를 사용하여 풀 리퀘스트 코멘트 엔드포인트에서 리뷰 코멘트를 가져오며, 봇 로그인 이름이 seer-by-sentry[bot]인 경우에만 필터링합니다. sentry[bot]이나 sentry-io[bot]은 명시적으로 제외됩니다. 또한 PR 번호가 제공되지 않은 경우 최근 열린 풀 리퀘스트를 스캔하여 Seer 코멘트의 수를 셉니다. 2단계에서는 각 마크다운 코멘트에서 버그 설명, 심각도 및 신뢰도 라인, 그리고 접을 수 있는 상세 분석, 제안된 수정, AI 에이전트용 프롬프트 섹션을 구문 분석합니다. 3단계에서는 인용된 줄의 파일을 읽어서 각 문제를 확인하고, 문제가 현재에도 존재하는지 확인하며, 실제 문제인지 오탐(False Positive)인지 판단하고, 경계 사례와 회귀 위험을 고려하여 수정을 구현합니다. 4단계에서는 해결된 항목과 건너뛴 항목의 표로 결과를 요약합니다.

문서에 따르면 구문 분석된 코멘트 형식은 안정적인 API 계약이 아니라 Seer의 현재 출력을 반영하므로, 실제 구조는 항상 확인해야 합니다. 또한 Seer 리뷰가 트리거되는 시기에 대해 다루는데, 여기에는 풀 리퀘스트가 '리뷰 준비 완료' 상태로 변경될 때, 준비된 풀 리퀘스트에 새 커밋이 푸시될 때, 그리고 수동 Sentry 리뷰 코멘트가 생성될 때 포함됩니다. 초안 풀 리퀘스트는 건너뜁니다. 문제 해결 가이드에서는 코멘트가 누락된 경우, 봇 이름 불일치, 그리고 부분적인 gh api 결과에 대한 대응 방법을 다루며, 참조 표에는 타입 안전성, 오류 처리, 유효성 검사, 구성 등 일반적인 문제 범주가 나열되어 있습니다.

자주 묻는 질문

이 스킬을 사용하기 위한 전제 조건은 무엇입니까?

gh CLI가 설치되고 인증되어야 하며, 저장소에 Seer by Sentry GitHub 앱이 설치되어 있어야 합니다.

수정할 코멘트를 식별하는 봇 로그인 이름은 무엇입니까?

코멘트는 seer-by-sentry[bot]에서 생성됩니다. 이 스킬은 이것이 sentry[bot]이나 sentry-io[bot]이 아님을 강조합니다.

PR 번호를 제공하지 않으면 어떻게 됩니까?

최근 열린 풀 리퀘스트를 나열하고 각 풀 리퀘스트의 Seer 코멘트 수를 세어, 해결되지 않은 Seer 피드백이 있는 풀 리퀘스트를 보고합니다.

실제로 수정을 적용할지 어떻게 결정합니까?

각 문제에 대해 인용된 줄의 파일을 읽고, 현재 코드에서 문제가 여전히 존재하는지 확인하며, 실제 문제인지 오탐(False Positive)인지 평가한 후, 경계 사례와 회귀 위험을 고려하여 수정을 구현합니다.

Seer은 언제 풀 리퀘스트에 대한 리뷰를 실행합니까?

Seer은 풀 리퀘스트가 '리뷰 준비 완료' 상태로 설정되거나 준비된 상태에서 커밋이 푸시될 때, 그리고 수동 Sentry 리뷰 코멘트가 생성될 때 자동으로 실행합니다. 초안 풀 리퀘스트는 건너뜁니다.