---
description: 브랜치 차이, 커밋, 변경 파일을 분석하여 Pull Request 자동 생성
allowed-tools: Bash(git status:*), Bash(git diff:*), Bash(git log:*), Bash(git branch:*), Bash(git rev-parse:*), Bash(git symbolic-ref:*), Bash(gh pr:*), Bash(gh auth:*), Bash(gh api:*)
---

# 자동 PR 생성기

현재 브랜치와 main 브랜치의 차이를 분석하여 적절한 PR을 생성합니다.

## 컨텍스트 정보

**현재 브랜치:**
!`git rev-parse --abbrev-ref HEAD`

**현재 git 상태:**
!`git status --short`

타겟 브랜치, 커밋, 변경 파일은 아래 1단계에서 조회합니다.

## 작업 순서

1. **브랜치 정보 분석** (명령은 하나씩 실행하고 결과를 다음 명령에 넣습니다)
   - 타겟 브랜치: `git symbolic-ref --short refs/remotes/origin/HEAD`의 결과(예: `origin/main`)를 씁니다. 실패하면 `git rev-parse --verify origin/main`, 그다음 `origin/master` 순서로 확인합니다.
   - 이 브랜치의 커밋: `git log --oneline <타겟>..HEAD`
   - 변경 파일: `git diff --stat <타겟>...HEAD`, `git diff --name-status <타겟>...HEAD`
   - push되지 않은 커밋이 있는지 확인: `git status -sb`의 ahead 표시

2. **커밋 분석**
   - PR에 포함될 모든 커밋 검토
   - 변경사항의 전체적인 목적 파악
   - feature, bugfix, refactor 등 유형 식별

3. **변경 파일 분석**
   - 어떤 파일이 수정/추가/삭제되었는가?
   - 코드베이스의 어느 영역이 영향받는가?
   - breaking changes가 있는가?

4. **기존 PR 확인**
   - `gh pr view --json number,title,body,url,state` 로 현재 브랜치에 열린 PR이 있는지 확인
   - **PR이 이미 열려 있으면 → 5-A (업데이트 플로우)**
   - **PR이 없으면 → 5-B (생성 플로우)**

5-A. **기존 PR 업데이트 플로우**
   - 기존 PR의 title과 body를 가져오기
   - 현재 변경사항을 기반으로 새로운 title과 body를 생성
   - 기존 내용과 새 내용을 비교하여 **변경점을 사용자에게 보여주기**
   - 사용자가 승인하면 `gh pr edit --title "title" --body "body"` 로 업데이트
   - 사용자가 수정을 원하면 반영 후 다시 확인

5-B. **새 PR 생성 플로우**
   - **제목**: 한국어로 간결한 요약 (커밋 컨벤션이 있으면 따르기)
   - **설명**: 다음 섹션 포함:
     - `## 변경 사항` (변경사항 요약)
     - `## 변경된 파일` (주요 변경 파일 목록)
     - `## 테스트` (해당되는 경우 테스트 방법)
     - `## 리뷰 포인트` (리뷰어가 특히 봐 줬으면 하는 부분, 판단이 필요했던 트레이드오프. 이 브랜치에서 `/fundamentals-review`를 돌렸다면 남겨 둔 🟡 항목과 그 이유. 없으면 생략)
   - **"Generated with Claude Code" 또는 AI attribution footer 추가 금지**
   - **생성한 title과 body를 사용자에게 보여주고 확인받기**
   - 사용자가 수정을 원하면 반영 후 다시 확인

6. **실행**
   - **사용자가 승인한 후에만** 실행
   - 먼저 브랜치가 remote에 push되었는지 확인 (안 되었으면 push 제안)
   - 새 PR: `gh pr create --title "title" --body "body"`
   - 기존 PR 업데이트: `gh pr edit --title "title" --body "body"`

## 출력 형식

먼저 간략히 설명:
- 현재 브랜치와 타겟 브랜치
- 포함될 커밋 수
- 변경사항 요약
- 기존 PR 존재 여부

그 다음:
- **새 PR**: 제안된 title과 body를 보여주고 사용자 확인 후 생성
- **기존 PR 업데이트**: 기존 내용 vs 새 내용 비교를 보여주고 사용자 확인 후 업데이트

## 에러 처리

- GitHub CLI 로그인 안됨: `gh auth login` 실행 안내
- 브랜치 미푸시: `git push -u origin <branch>`로 push 제안
- main 브랜치에서 실행: feature 브랜치 먼저 생성하라고 안내