Fix PR
리뷰 댓글을 읽고, 수정 사항을 구현하며, 푸시하고, 스레드에 답변합니다.
호출
/fix-pr # 현재 브랜치의 PR 수정
/fix-pr 42 # PR #42 수정
흐름
1. PR 식별 및 체크아웃
gk pr view <PR> --json number,title,headRefName,state
PR이 닫혀 있거나 병합된 경우 거절합니다.
현재 브랜치가 PR 브랜치가 아닌 경우 (/developer 파이프라인이 새로운 작업트리에서 실행하는 경우), 먼저 체크아웃합니다:
gk pr checkout <PR>
git checkout main을 절대 실행하지 마세요 — 연결된 작업트리에서는 기본 작업트리에 main이 체크아웃되어 있어 실패합니다.
2. 모든 피드백 읽기
# 최상위 댓글
gk pr view <PR> --comments
# 리뷰 스레드 (인라인)
gk api repos/{owner}/{repo}/pulls/<PR>/comments \
--jq '[.[] | {id, path, line, body, in_reply_to_id}]'
# 리뷰 요약
gk api repos/{owner}/{repo}/pulls/<PR>/reviews \
--jq '[.[] | select(.body != "") | {id, state, body}]'
수집 대상: 해결되지 않은 인라인 스레드, 리뷰 요약 댓글, 최상위 PR 댓글.
처리할 피드백이 없으면 거절합니다.
3. 수정 사항 구현
- 모든 해결되지 않은 댓글 처리
- 변경 사항은 최소한으로 유지 — 요청된 피드백만 반영
- 관련 없는 코드 리팩터링 금지
- 모든 수정 사항 적용 후: 프로젝트의 검사 실행 (
AGENTS.md/CLAUDE.md에서 정확한 명령어 확인), 일반적으로:
pnpm typecheck
pnpm test
커밋 전에 실패를 수정합니다.
4. 커밋 및 푸시
git add <변경한 파일> # 경로별로 스테이징 — `git add -p` (대화형) 또는 `git add -A` 사용 금지
git commit -m "fix(pr): #<PR> 리뷰 댓글 반영"
git push origin <브랜치>
5. 스레드에 답변
처리된 각 스레드에 대해 답변:
gk api repos/{owner}/{repo}/pulls/<PR>/comments/<COMMENT_ID>/replies \
--method POST \
--field body="<커밋 SHA>에서 수정됨: <변경 사항에 대한 한 줄 설명>."
6. 보고
처리된 각 댓글과 수행한 작업을 나열합니다. 건너뛴 댓글이 있으면 그 이유를 표시합니다.
규칙
- 모든 수정 사항은 하나의 커밋으로 (댓글당 하나가 아님)
- 처리한 모든 스레드에 답변
- 댓글이 불명확한 경우: 가장 합리적인 해석으로 구현하고, 스레드 답변에 그 해석을 명시 (무인 — 질문할 사람이 없음). 댓글이 잘못된 경우: 구현 대신 답변에 이유를 설명
- 수정으로 테스트가 깨지는 경우: 보고하고, 깨진 코드를 강제 푸시하지 않음
- 스레드를 해결(resolve)하지 않음 — GitHub에서 푸시 시 자동으로 해결됨