Pr

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

# PR 생성 Skill

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

## 실행 순서

### 1. 변경 내용 분석

PR 생성 가능 상태 확인:

```bash
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` 사용:

```bash
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`을 사용할 수 없는 경우:

```bash
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 본문 생성:

```markdown
## 요약

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

### 변경사항 1 제목

- 세부 설명

### 변경사항 2 제목

- 세부 설명
```

**본문 작성 규칙:**

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

### 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 생성:

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

- 내용

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

**중요:** body는 HEREDOC 필수.

### 8. 결과 출력

PR 생성 후 URL 공유.