---

name: pr description: Commit, push, and open a PR. Use when the user asks to create a PR (e.g. "PR 만들어줘", "PR 생성해줘", "풀리퀘 올려줘"). argument-hint: "[issue-number]" allowed-tools: Bash(git status:), Bash(git diff:), Bash(git log:), Bash(git branch:), Bash(git push:), Bash(gh pr create:), Bash(gh pr edit:*)

PR Creation Skill

Input

$ARGUMENTS

Format: <issue-number> (optional) Examples:

• /pr 42 → PR 생성 후 GitHub Issue #42와 development 연동 (PR merge 시 자동 close)
• /pr → issue 연동 없이 PR 생성

Current Git Context

Current git status: !git status Current git diff (staged and unstaged changes): !git diff HEAD Current branch: !git branch --show-current Recent commits since branching: !git log --oneline origin/HEAD..HEAD

---

Base Branch Detection

Determine the base branch using this priority:

1. If the project CLAUDE.md specifies a main/base branch, use that
2. Try git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's|refs/remotes/origin/||'
3. Default: main

---

Pre-checks

1. Verify current branch is NOT the base branch — if on base branch, warn and abort
2. Check for uncommitted changes — if any, warn the user to run /commit first

---

PR Template

.github/PULL_REQUEST_TEMPLATE.md 를 기반으로 아래 항목을 채워 PR body를 작성한다. issue-number가 제공된 경우, Background 아래에 Closes #N 을 추가한다 — GitHub이 이를 인식해 PR merge 시 issue를 자동 close하고 development 패널에 연동한다.

## Background

{이 PR의 배경. 어떤 Phase인지, 무엇을 목표로 했는지. 1~3줄.}

Closes #{issue-number}   ← issue-number가 있을 때만 포함

## 구현 내용

{무엇을 구현했는지. 핵심 변경 사항을 번호 목록으로.}

1. ...

## 설계 결정 & 트레이드오프

{왜 이 방식을 선택했는지. 고려한 대안과 포기한 이유.}

| 결정 | 이유 | 포기한 대안 |
|------|------|------------|
| ... | ... | ... |

## 성능 측정

{최적화 전/후 수치. 목표 대비 실제 결과. 해당 없으면 "N/A"}

| 지표 | 목표 | Before | After |
|------|------|--------|-------|
| TPS | ... | ... | ... |
| P99 Latency | ... | ... | ... |

## 참고 자료

- ...

## 코멘트

{리뷰어나 미래의 나에게 전달할 메모. 없으면 생략.}

작성 원칙: diff를 나열하지 않는다. 변경의 무엇(What), 왜(Why), 어떻게(How) 를 서술해 코드를 읽지 않아도 맥락을 파악할 수 있게 쓴다.

---

Procedure

Step 1: Analyze

• 위 git context를 바탕으로 변경 내용 파악
• 필요 시 변경된 파일 직접 읽어 context 보완
• PR 제목과 body 초안 작성
  • 제목 형식: type: 한국어 요약 (50자 이내, 명령문, 끝 마침표 없음)
  • type은 커밋 컨벤션과 동일: feat / fix / refactor / style / chore / test / docs
  • 브랜치의 커밋들을 종합해 가장 대표적인 type 하나 선택

Step 2: Preview & confirm

다음을 사용자에게 보여주고 승인 대기:

• PR 제목
• PR body 미리보기
• {base_branch} ← {current_branch}

승인 시 Step 3 진행, 수정 요청 시 재작성 후 재확인.

Step 3: Push & create PR

git push -u origin {current_branch}
gh pr create --base {base_branch} --title "{title}" --body "{body}"

Step 4: Report

• PR URL
• 제목
• base ← head 브랜치명