القائمة
PR에 달린 리뷰 코멘트를 읽고, 코드 수정 후 커밋 SHA를 포함한 답글을 달아야 할 때 사용
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
코드의 불필요한 주석을 식별하고 정리한다. "/clean-comments", "주석 정리해줘", "자명한 주석 빼줘", "이 파일 주석 검토" 같은 발화에 트리거. 주석 정책의 SSOT.
apps/server (NestJS) 의 jest spec(unit / integration) 을 작성·수정한다. 한국어 행위 제목, given/when/then 주석, when 1번 호출, 구현 의존 단어 금지 규칙을 적용한다. "서버 테스트 작성", "server spec 추가", "이 spec 정리", "/write-server-spec" 같은 발화에 트리거.
GitHub PR을 생성한다. "/create-pr", "PR 만들어줘", "PR 올려줘" 같은 발화에 트리거. 현재 브랜치의 변경 사항을 기반으로 PR을 생성한다.
변경 사항을 커밋한다. "/commit", "커밋해줘", "커밋" 같은 발화에 트리거. staged 파일이 없으면 전체 add 후 커밋. 메시지는 Conventional Commits 컨벤션을 따른다.
استنادا إلى تصنيف SOC المهني
| name | respond-review |
| description | PR에 달린 리뷰 코멘트를 읽고, 코드 수정 후 커밋 SHA를 포함한 답글을 달아야 할 때 사용 |
PR에 달린 리뷰 코멘트를 분석하여 코드를 수정하고, 커밋 SHA가 포함된 답글을 남깁니다.
$ARGUMENTS가 있으면 해당 PR, 없으면 현재 브랜치의 PR 사용 → cheatsheet §1 참조isResolved: false인 스레드만 수집 → cheatsheet §2 참조isResolved: false인 스레드만 대상. isOutdated: true도 포함 (코드가 변경되어 outdated 되었을 수 있음)리뷰 코멘트를 다음 카테고리로 분류합니다:
| 카테고리 | 설명 | 대응 방식 |
|---|---|---|
| 코드 수정 | 버그, 개선, 리팩토링 요청 | 코드 변경 + 커밋 |
| 질문/설명 요청 | 코드 의도, 설계 이유 질문 | 답글만 (코드 변경 없음) |
| 논의 필요 | 트레이드오프, 설계 결정 관련 | AskUserQuestion으로 방향 확인 |
분류 후 AskUserQuestion (필수):
모든 리뷰 코멘트에 대해 에이전트의 검토 의견과 대응 계획을 사용자에게 반드시 AskUserQuestion으로 확인합니다. 항목 수나 명확성에 관계없이 생략 불가합니다.
리뷰 코멘트를 검토했습니다:
1. ✏️ [path:line] 리뷰 요약
→ 에이전트 검토: {타당/부정확/판단 어려움} — {근거}
→ 제안: {수정 계획 또는 현행 유지 사유}
2. 💬 [path:line] 질문 내용
→ 제안: {답변 초안}
3. ⚠️ [path:line] 논의 필요
→ 에이전트 검토: {선택지와 트레이드오프}
어떻게 대응할까요?
리뷰 코멘트별로 개별 커밋합니다 (반영률 추적을 위해):
fix: 리뷰 반영 — {변경 요약} (타입은 변경 성격에 따라 fix, refactor, enhance 등 적절히 선택)주의: 여러 리뷰가 같은 파일의 밀접한 영역을 다루면 하나의 커밋으로 합칠 수 있음
코드 수정 커밋을 모두 마친 뒤 git push합니다. 답글에 커밋 SHA 링크가 걸리려면 remote에 push가 선행되어야 합니다.
각 리뷰 스레드에 커밋 SHA가 포함된 답글을 남깁니다.
답글 형식 (코드 수정):
반영 완료 (`{SHORT_SHA}`):
- {변경 내용 1}
- {변경 내용 2}
답글 형식 (현행 유지):
{유지 사유 설명}
답글 형식 (질문/설명):
{답변 내용}
답글 작성 API: cheatsheet §3 참조 (comment_id는 스레드 첫 번째 코멘트의 databaseId)
스레드 resolve는 하지 않는다. 리뷰어가 직접 확인 후 resolve하는 것이 원칙이므로, 에이전트는 답글만 남기고 resolve API를 호출하지 않는다.
%h)를 백틱으로 감싸서 포함. 이것이 리뷰 반영률 측정의 핵심 지표gh-auto 사용: GitHub API 호출 시 반드시 gh-auto를 사용하여 계정 자동 전환