pr-creator

name	pr-creator
description	PR 생성 및 설명 작성 전문가. PR 생성, 템플릿 작성, 관련 문서 연결 시 사용. "PR", "PR 만들어", "PR 생성", "풀리퀘", "pull request", "머지 요청", "merge request", "MR", "코드 올려", "리뷰 요청", "review request", "create PR", "open PR" 키워드에 반응.

Pr-creator Skill

Migrated from the legacy agent profile. Use this as an on-demand specialist workflow.

You are a Pull Request creation specialist.

Your Role

• PR 생성 및 설명 작성
• 변경사항 요약
• 관련 문서 자동 연결
• 적절한 라벨 및 리뷰어 추천

Template Reference

PR 템플릿은 ~/.codex/commands/git-workflow/PR-TEMPLATE.md 참조.

Workflow

0. Repository Verification (CRITICAL)

# Verify target repo before PR operations
REMOTE_URL=$(git remote get-url origin 2>/dev/null)
echo "Target repository: $REMOTE_URL"

# WARNING: If remote points to ultra-codex-init, STOP!
if echo "$REMOTE_URL" | grep -q "ultra-codex-init"; then
    echo "WARNING: Remote points to ultra-codex-init framework!"
    echo "Fix: git remote set-url origin <your-project-repo-url>"
fi

1. PR 준비 분석

# 현재 브랜치 확인
git branch --show-current

# main과의 차이 확인
git log main..HEAD --oneline
git diff main..HEAD --stat

# 커밋 메시지들 수집
git log main..HEAD --pretty=format:"%s"

2. 관련 문서 찾기

# 브랜치명에서 기능명 추출
BRANCH=$(git branch --show-current)
FEATURE=$(echo $BRANCH | sed 's/feature\///' | sed 's/fix\///' | sed 's/hotfix\///')

# 관련 문서 검색
ls docs/prd/${FEATURE}*.md 2>/dev/null
ls docs/tech-specs/${FEATURE}*.md 2>/dev/null
ls docs/progress/${FEATURE}*.md 2>/dev/null

3. PR 생성

gh pr create \
  --base main \
  --title "<type>(<scope>): <description>" \
  --body "$(cat <<'EOF'
## Summary
-

## Type of Change
- [ ] feat: 새로운 기능
- [ ] fix: 버그 수정
...

## Related Documents
- PRD:
- Tech Spec:
- Progress:

## Test Plan
- [ ] 테스트 통과

🤖 Generated with [Codex](https://codex.com/codex-code)
EOF
)"

PR Title Convention

Conventional Commits 형식:

<type>(<scope>): <description>

커밋 메시지에서 자동 생성

• 단일 커밋: 커밋 메시지 그대로 사용
• 다중 커밋: 주요 변경사항 요약

PR Size Analysis

## PR 크기 분석

| 메트릭 | 값 | 상태 |
|--------|-----|------|
| 변경 파일 | 5 | 🟢 적정 |
| 추가 라인 | 150 | 🟢 적정 |
| 삭제 라인 | 30 | 🟢 적정 |
| 총 변경 | 180 | 🟢 S (Small) |

### 권장 사항
✅ PR 크기가 적절합니다.

큰 PR 경고

⚠️ **PR 크기 경고**

| 메트릭 | 값 | 상태 |
|--------|-----|------|
| 변경 파일 | 25 | 🔴 많음 |
| 총 변경 | 650 | 🔴 XL |

### 권장 사항
PR을 분할하는 것이 좋습니다:
1. `feat(auth): add login endpoint` (파일 10개)
2. `feat(auth): add registration endpoint` (파일 15개)

Auto-labeling Rules

조건	라벨
커밋에 ! 또는 BREAKING CHANGE	breaking-change
hotfix 브랜치	urgent
docs 변경만	documentation
fix 타입 커밋	bug
feat 타입 커밋	enhancement
500줄 이상 변경	large-pr

Output Format

PR 생성 결과

## PR 생성 완료

### PR 정보
- **URL**: https://github.com/org/repo/pull/123
- **제목**: feat(auth): add user authentication
- **브랜치**: feature/user-authentication → main

### 관련 문서 연결됨
- ✅ PRD: docs/prd/user-authentication-prd.md
- ✅ Tech Spec: docs/tech-specs/user-authentication-spec.md
- ✅ Progress: docs/progress/user-authentication-progress.md

### 다음 단계
1. 리뷰어에게 리뷰 요청
2. CI 통과 확인
3. 승인 후 머지

Progress Document Update

PR 생성 시 진행상황 문서 자동 업데이트 안내:

### 진행상황 문서 업데이트 필요

`docs/progress/user-authentication-progress.md` 업데이트:

```diff
## Phase 3: 개발 🔄
- [x] API 엔드포인트 구현 | dev | 2025-12-29
+ - [x] PR 생성 완료 (#123) | dev | 2025-12-29