PF GitHub PR 워크플로우

$ARGUMENTS PR을 pluxity/pf-frontend 프로젝트에 생성합니다.

---

프로젝트 정보

• 저장소: pluxity/pf-frontend
• PR URL: https://github.com/pluxity/pf-frontend/pulls
• 기본 브랜치: main

---

PR 워크플로우

1. 변경사항 확인
   ↓
2. 커밋 메시지 작성
   ↓
3. 푸시
   ↓
4. PR 생성
   ↓
5. 리뷰 요청

---

1단계: 변경사항 확인

# 변경된 파일 확인
git status

# 변경 내용 확인
git diff

# 스테이징된 변경 확인
git diff --staged

---

2단계: 커밋 메시지 컨벤션

형식

#이슈번호 - 타입(스코프): 제목

본문 (선택)

Footer (선택)

중요: 이슈번호는 제일 앞에 #번호 - 형식으로 작성합니다.

타입

타입	설명	예시
feat	새 기능	#123 - feat(ui): Button 컴포넌트 추가
fix	버그 수정	#456 - fix(map): 마커 클릭 이벤트 수정
docs	문서	#789 - docs: README 업데이트
style	포맷팅	#101 - style: 코드 포맷 정리
refactor	리팩토링	#202 - refactor(core): API 클라이언트 개선
perf	성능 개선	#303 - perf(ui): Table 가상화 적용
test	테스트	#404 - test(ui): Button 테스트 추가
chore	빌드/설정	#505 - chore: 의존성 업데이트

스코프 (선택)

- ui: @pf-dev/ui 패키지
- map: @pf-dev/map 패키지
- core: @pf-dev/core 패키지
- app명: 특정 앱
- (생략): 전체 또는 여러 패키지

예시

# 단일 커밋
git commit -m "#123 - feat(ui): DatePicker 컴포넌트 추가

- 날짜 선택 기능
- 범위 선택 기능
- 한국어 로케일 지원

Refs #123"

# 버그 수정
git commit -m "#456 - fix(map): 3D 모델 로딩 실패 수정

nullish 체크 누락으로 인한 크래시 수정

Refs #456"

---

3단계: 브랜치 & 푸시

브랜치 네이밍

# 기능 개발
feature/이슈번호-간단설명
feature/123-user-profile

# 버그 수정
fix/이슈번호-간단설명
fix/456-login-crash

# 문서
docs/간단설명
docs/readme-update

# 리팩토링
refactor/간단설명
refactor/api-client

푸시

# 첫 푸시 (업스트림 설정)
git push -u origin feature/123-user-profile

# 이후 푸시
git push

---

4단계: PR 생성

기본 템플릿

gh pr create \
  --repo pluxity/pf-frontend \
  --base main \
  --title "#123 - feat(ui): DatePicker 컴포넌트 추가" \
  --body "$(cat <<'EOF'
## 개요
DatePicker 컴포넌트를 @pf-dev/ui 패키지에 추가합니다.

## 변경사항
- DatePicker 컴포넌트 구현
- 날짜 범위 선택 기능
- 한국어 로케일 지원
- Storybook 문서 추가

## 스크린샷
[스크린샷 첨부]

## 테스트
- [ ] 단일 날짜 선택
- [ ] 범위 선택
- [ ] 키보드 네비게이션
- [ ] 모바일 반응형

## 체크리스트
- [ ] 타입 체크 통과 (`pnpm tsc --noEmit`)
- [ ] 린트 통과 (`pnpm lint`)
- [ ] 빌드 성공 (`pnpm build`)
- [ ] Storybook 확인

## 관련 이슈
Closes #123
EOF
)"

PR 타입별 템플릿

기능 추가 (Feature)

gh pr create \
  --repo pluxity/pf-frontend \
  --title "#이슈번호 - feat(스코프): 제목" \
  --label "enhancement" \
  --body "$(cat <<'EOF'
## 개요
[기능 설명]

## 변경사항
- 변경1
- 변경2

## 스크린샷
[해당시 첨부]

## 테스트
- [ ] 테스트1
- [ ] 테스트2

## 체크리스트
- [ ] 타입 체크 통과
- [ ] 린트 통과
- [ ] 빌드 성공

## 관련 이슈
Closes #이슈번호
EOF
)"

버그 수정 (Bug Fix)

gh pr create \
  --repo pluxity/pf-frontend \
  --title "#이슈번호 - fix(스코프): 제목" \
  --label "bug" \
  --body "$(cat <<'EOF'
## 버그 설명
[수정한 버그 설명]

## 원인
[버그 원인]

## 해결 방법
[어떻게 수정했는지]

## 테스트
- [ ] 버그 재현 후 수정 확인
- [ ] 사이드 이펙트 확인

## 체크리스트
- [ ] 타입 체크 통과
- [ ] 린트 통과
- [ ] 빌드 성공

## 관련 이슈
Fixes #이슈번호
EOF
)"

리팩토링 (Refactor)

gh pr create \
  --repo pluxity/pf-frontend \
  --title "#이슈번호 - refactor(스코프): 제목" \
  --label "refactor" \
  --body "$(cat <<'EOF'
## 개요
[리팩토링 목적]

## 변경사항
- Before: [이전 구조/방식]
- After: [새로운 구조/방식]

## 영향 범위
[영향받는 파일/컴포넌트]

## 테스트
- [ ] 기존 기능 동작 확인
- [ ] 성능 저하 없음

## 체크리스트
- [ ] 타입 체크 통과
- [ ] 린트 통과
- [ ] 빌드 성공
EOF
)"

---

5단계: 리뷰 & 머지

리뷰어 지정

# PR 생성 시 리뷰어 지정
gh pr create --reviewer username1,username2

# 이미 생성된 PR에 리뷰어 추가
gh pr edit 123 --add-reviewer username

PR 상태 확인

# PR 목록 확인
gh pr list --repo pluxity/pf-frontend

# PR 상세 보기
gh pr view 123 --repo pluxity/pf-frontend

# PR 체크 상태 확인
gh pr checks 123 --repo pluxity/pf-frontend

머지

# Squash 머지 (권장)
gh pr merge 123 --repo pluxity/pf-frontend --squash

# 일반 머지
gh pr merge 123 --repo pluxity/pf-frontend --merge

# 리베이스 머지
gh pr merge 123 --repo pluxity/pf-frontend --rebase

---

관련 스킬 연동

코드 리뷰 후 PR

# 1. 코드 리뷰
/pf-code-review src/components/Button

# 2. 수정 후 PR 생성
/pf-pr #123 - feat(ui): Button 접근성 개선

기능 개발 후 PR

# 1. 기능 개발
/pf-feature #123 사용자 프로필

# 2. PR 생성
/pf-pr #123 - feat: 사용자 프로필 페이지 추가

핫픽스 후 PR

# 1. 핫픽스
/pf-hotfix #456 로그인 크래시

# 2. PR 생성
/pf-pr #456 - fix: 로그인 페이지 크래시 수정

---

PR 전 체크리스트

# 1. 타입 체크
pnpm tsc --noEmit

# 2. 린트
pnpm lint

# 3. 빌드
pnpm build

# 4. 테스트 (있는 경우)
pnpm test

---

유용한 명령어

# 내 PR 목록
gh pr list --repo pluxity/pf-frontend --author @me

# PR 댓글 추가
gh pr comment 123 --repo pluxity/pf-frontend --body "리뷰 반영 완료했습니다"

# PR 닫기
gh pr close 123 --repo pluxity/pf-frontend

# Draft PR 생성
gh pr create --draft

# Draft -> Ready
gh pr ready 123

# PR diff 보기
gh pr diff 123 --repo pluxity/pf-frontend

---

CI/CD 연동

PR 생성 시 자동으로 실행되는 체크:

• TypeScript 타입 체크
• ESLint
• Build 테스트

main 브랜치 머지 시:

• Staging 서버 자동 배포 (deploy-staging 워크플로우)

---

주의사항

• [필수] PR은 항상 Draft로 생성 (--draft 플래그 사용)
• 리뷰 준비 완료 시 gh pr ready 로 변경
• PR 제목은 커밋 컨벤션을 따름
• 큰 변경은 여러 PR로 나누기
• 리뷰어 피드백은 적극적으로 반영
• 머지 전 최신 main과 rebase/merge 권장
• [필수] 커밋 메시지에 Co-Authored-By 절대 포함 금지 - 반드시 확인할 것