| name | create-pr |
| description | 사용자가 PR(풀 리퀘스트) 생성을 요청했을 때 이 스킬을 실행한다. .github/pull_request_template.md 구조에 맞춰 본문을 작성하고 gh pr create --body로 전달한다. PR 리뷰나 PR 목록 조회 등 생성이 아닌 요청에는 사용하지 않는다. |
create-pr
.github/pull_request_template.md 구조(관련 이슈 / 작업 내용 / 참고 사항 / 체크리스트)를 그대로 따라 PR 본문을 작성하고 gh pr create --body로 전달한다.
절차
.github/pull_request_template.md를 읽어 최신 템플릿 구조를 확인한다.- 대상 브랜치의 커밋 히스토리와 diff(
git log, git diff <base>...HEAD)를 확인한다 — 마지막 커밋만이 아니라 브랜치에 포함된 모든 커밋을 근거로 삼는다.
- 제목은
브랜치명의 앞 키워드: 간단한 요약 형식으로 짓는다. 예를 들어 브랜치가 feat/dashboard면 feat: 대시보드 응답 시간 차트 기간별 필터링 추가처럼 / 앞부분을 그대로 키워드로 쓰고, 콜론 뒤에 브랜치 전체 작업을 온전한 문장 대신 간단한 명사구로 요약한다.
- 템플릿 섹션별로 본문을 작성한다:
- 관련 이슈: 사용자가 이슈 번호를 알려준 경우에만 채운다. 모르면 템플릿 형식만 남기고 비워둔다 (번호를 추측해서 채우지 않는다).
- 작업 내용: 커밋 히스토리와 diff를 근거로 실제 변경된 내용을 온전한 문장으로 요약한다.
- 참고 사항: 리뷰어가 알아야 할 맥락(브레이킹 체인지, 후속 작업 필요 여부, 임시 조치 등)이 있으면 적고 없으면 생략한다.
- 체크리스트: 템플릿 항목을 그대로 유지한다 (실제 확인 여부는 사람이 체크).
- 작성한 제목/본문을 사용자에게 보여주고 확인을 받은 뒤
gh pr create --title --body로 실행한다. gh pr create 실행 자체는 원격 저장소에 영향을 주는 작업이므로 사용자 확인 없이 먼저 실행하지 않는다.
- PR이 생성되면 곧바로 라벨을 부여한다. 아래 "라벨 부여" 절을 따른다.
라벨 부여
PR 생성 직후 gh pr edit <번호> --add-label <라벨>로 변경 내용에 맞는 라벨을 붙인다. 이 단계는 사용자에게 다시 확인받지 않고 진행한다 (PR 생성 자체를 이미 승인받았고, 라벨은 되돌리기 쉬운 메타데이터다).
- 라벨은 2번에서 확인한 브랜치의 커밋 type을 기준으로 정한다. 성격이 다른 커밋이 섞여 있으면 해당하는 라벨을 모두 붙인다.
- 커밋 type과 라벨의 매핑, 그리고 커밋 type으로 결정되지 않는 라벨(
performance, UI/UX, design QA, main)의 사용 기준은 루트 CLAUDE.md의 "PR 생성 > 라벨 부여" 절을 그대로 따른다. 이 스킬에 표를 중복해서 두지 않는다.
D-0, D-1, D-3, D-5는 처리 기한 라벨이므로 부여하지 않는다.- 저장소에 없는 라벨을 새로 만들지 않는다.
gh label list로 현재 목록을 확인할 수 있다.
- 부여한 라벨을 마지막 보고에 PR 링크와 함께 밝힌다. 마땅한 라벨이 없어 붙이지 않았다면 그 사실도 밝힌다.
주의
- 이모티콘을 사용하지 않고 온전한 문장으로 작성한다 (루트 CLAUDE.md 텍스트 작성 원칙).
- push가 안 된 상태라면 먼저 push가 필요하다는 점을 사용자에게 알린다 (push도 사용자 확인이 필요한 작업).
