description: "PR 생성 - 변경사항 분석 후 자동 생성" allowed-tools: ["Bash", "Read", "Grep", "AskUserQuestion"]

PR 생성 Skill

현재 브랜치 변경사항 분석 후 PR 생성.

실행 순서

1. 변경 내용 분석

PR 생성 가능 상태 확인:

git status --short
git branch --show-current
git fetch origin main --prune

중단 조건:

working tree dirty 상태면 중단, 커밋 또는 스태시 후 재실행 안내
현재 브랜치가 main이면 중단
git fetch origin main --prune 실패 시 원격 기준 검사가 불완전하다는 점을 사용자에게 알리고 진행 여부 확인
기준 브랜치 대비 커밋 0개면 PR 생성 변경사항 없음으로 중단

기준 브랜치는 origin/main 우선, 불가 시 로컬 main 사용:

git log --oneline origin/main..HEAD
git log --name-status --find-renames --oneline origin/main..HEAD
git diff --stat origin/main...HEAD
git diff --name-status --find-renames origin/main...HEAD

origin/main을 사용할 수 없는 경우:

git log --oneline main..HEAD
git log --name-status --find-renames --oneline main..HEAD
git diff --stat main...HEAD
git diff --name-status --find-renames main...HEAD

주의: git diff main..HEAD 또는 git diff origin/main..HEAD 사용 금지.

A..B 형태의 git diff는 PR 기준 diff가 아니라 A와 B 직접 비교
base 브랜치에만 있는 변경사항이 이 브랜치에서 삭제된 것처럼 보일 위험
실제 PR diff 확인은 origin/main...HEAD 같은 triple-dot 사용
커밋 기반 변경 파일 확인은 git log --name-status --find-renames origin/main..HEAD 사용

2. 사전 검사 체크리스트

PR 제목과 본문 작성 전 .claude/skills/pr/check-list.md 읽기와 체크리스트 작성.

체크리스트 중단 조건 항목은 PR 생성 전 수정.

3. PR 제목 생성

변경 내용 분석 후 다음 형식으로 제목 생성:

feat: 새로운 기능 설명 - 새 기능 추가
fix: 버그 수정 설명 - 버그 수정
refactor: 리팩토링 설명 - 코드 리팩토링
style: 스타일 변경 설명 - UI/스타일 변경
chore: 작업 설명 - 설정, 빌드 등
docs: 문서 변경 설명 - 문서 수정
agent: 에이전트, 클로드, ai 관련 설정 - 에이전트 설정

4. PR 본문 생성

다음 형식으로 PR 본문 생성:

## 요약

- 주요 변경사항 1
- 주요 변경사항 2

### 변경사항 1 제목

- 세부 설명

### 변경사항 2 제목

- 세부 설명

본문 작성 규칙:

요약 항목은 주요 변경사항 단위로 그룹화
로직의 핵심 흐름만 간단히 설명
함수명, 변수명 등 구체적인 코드 명칭은 포함하지 않음
파일 경로나 파일 이름은 포함하지 않음
각 설명은 1~2문장으로 간결하게 작성
"~함", "~추가", "~구현" 같은 간결한 문체 사용

5. 라벨 결정

제목 prefix 기준 라벨 결정:

| Prefix | Label | 설명 | | ---------- | ------------- | --------------- | | feat | feat | 새로운 기능 | | fix | fix | 코드 수정 | | fix (버그) | bug | 버그 수정 | | refactor | refactoring | 코드 리팩토링 | | perf | performance | 성능 개선 | | docs | documentation | 문서 작업 | | test | test | 테스트 | | chore | development | 개발 환경 구성 | | ci | CI/CD | 파이프라인 | | deps | dependencies | 의존성 업데이트 | | security | security | 보안 관련 | | remove | remove | 기능 제거 | | agent | agent | 에이전트 설정 |

6. PR 내용 확인 (필수)

PR 생성 전 반드시 사용자에게 다음 내용 공유 후 확인:

PR 미리보기
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

제목: [생성한 제목]

본문:
[생성한 본문 내용]

라벨: [결정한 라벨들]
Base: main

사전 검사:
- CLAUDE.md 준수: [확인/수정 필요/해당 없음]
- AGENTS.md 준수: [확인/수정 필요/해당 없음]
- Claude/Codex 스킬 동기화: [확인/수정 필요/해당 없음]
- 예외 사유: [없음 또는 사유]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

AskUserQuestion 도구로 확인 수집.

중요: 사용자 승인 전 PR 생성 금지.

7. PR 생성

사용자 승인 후에만 gh CLI로 PR 생성:

gh pr create \
  --title "feat: 기능 설명" \
  --body "$(cat <<'EOF'
## 요약

- 내용

EOF
)" \
  --assignee @me \
  --label "라벨" \
  --base main

중요: body는 HEREDOC 필수.

8. 결과 출력

PR 생성 후 URL 공유.

Automated Pull Request Creation

Recommended for