/pr - 풀 리퀘스트 생성 스킬

CI를 통과하고 올바른 브랜치를 대상으로 하는 풀 리퀘스트를 생성합니다.

언어 요구 사항

중요: 모든 풀 리퀘스트는 영어로 작성되어야 합니다.

• PR 제목: 영어
• PR 본문: 영어
• 커밋 메시지: 영어

사전 확인 (필수)

풀 리퀘스트를 생성하기 전에 모든 다음 확인이 통과해야 합니다:

1. 포맷 확인

bash
1cargo fmt --all -- --check

실패할 경우 cargo fmt --all을 실행하여 수정하고 커밋합니다.

2. 클리피 확인

bash
1cargo clippy --all-targets --all-features -- -D warnings

중요: 경고가 0개여야 합니다. 모든 문제를 수정한 후에 진행합니다.

3. 테스트 스위트

bash
1cargo test --all

모든 테스트가 통과해야 합니다.

단계

단계 1: 사전 확인 실행

위의 세 가지 확인을 모두 실행합니다. 실패할 경우:

1. 문제를 수정합니다.
2. /commit 스킬을 사용하여 수정 사항을 커밋합니다.
3. 모든 확인이 통과할 때까지 확인을 다시 실행합니다.

단계 2: 브랜치 상태 확인

bash
1# 현재 브랜치를 확인합니다.
2git branch --show-current
3# 원격 저장소와 동기화 여부를 확인합니다.
4git status

다음 항목을 확인합니다:

• main 브랜치가 아닙니다 (직접 main에 커밋하는 것은 금지되어 있습니다)
• 브랜치 이름 규칙을 따릅니다:
  • 기능: feature/<이슈 번호>-<설명>
  • 버그 수정: bugfix/<이슈 번호>-<설명>
  • 핫픽스: hotfix/<이슈 번호>-<설명>
  • 문서: docs/<이슈 번호>-<설명>
  • 리팩토링: refactor/<이슈 번호>-<설명>

단계 3: 베이스 브랜치 결정

중요: 이 프로젝트에서는 develop을 통합 브랜치로 사용합니다.

bash
1git fetch origin
2git checkout -b feature/<이슈>-<설명> origin/develop

단계 4: 변경 사항 검토

bash
1# 풀 리퀘스트에 포함될 커밋을 확인합니다.
2git log origin/develop..HEAD --oneline
3# 변경 사항을 확인합니다.
4git diff origin/develop...HEAD

단계 5: 원격 저장소에 푸시

bash
1git push -u origin $(git branch --show-current)

단계 6: 풀 리퀘스트 생성

다음 템플릿을 사용합니다:

bash
1gh pr create --base develop --title "제목" --body "$(cat <<'EOF'
2## 요약
3[1-3개의 변경 사항 요약]
4## 관련 이슈
5Closes #XX
6## 변경 사항
7- [변경 사항 1]
8- [변경 사항 2]
9- [변경 사항 3]
10## 테스트 계획
11- [ ] `cargo test --all` 통과
12- [ ] `cargo clippy --all-targets --all-features -- -D warnings` 통과
13- [ ] 수동 테스트 수행 (적용 가능)
14## 스크린샷 (적용 가능)
15[UI 변경 사항의 스크린샷 추가]
16--- Generated with [Claude Code](https://claude.com/claude-code)
17EOF
18)"

단계 7: 풀 리퀘스트 생성 확인

생성 후:

1. 풀 리퀘스트 URL을 출력합니다.
2. CI가 실행 중인지 확인합니다: gh pr checks
3. 상태를 사용자에게 보고합니다.

오류 처리

사전 확인 실패

사전 확인 중 하나라도 실패할 경우:

1. 포맷 실패: cargo fmt --all을 실행하여 수정하고 커밋합니다. 다시 시도합니다.
2. 클리피 실패: 경고를 수정하고 커밋합니다. 다시 시도합니다.
3. 테스트 실패: 테스트를 수정하고 커밋합니다. 다시 시도합니다. 절대 사전 확인이 실패한 경우 풀 리퀘스트를 생성하지 마십시오.

푸시 실패

푸시가 실패할 경우:

1. 원격 저장소에 브랜치가 있는지 확인합니다.
2. 충돌하는 변경 사항이 있는지 확인합니다.
3. 필요할 경우 충돌을 해결하고 다시 시도합니다.

풀 리퀘스트 생성 실패

gh pr create가 실패할 경우:

1. 인증을 확인합니다: gh auth status
2. 이미 풀 리퀘스트가 있는지 확인합니다: gh pr list
3. 오류 세부 정보를 사용자에게 보고합니다.

예제 사용법

사용자: "PRを作成して" Claude는 /pr 스킬을 실행합니다:

1. cargo fmt --all -- --check을 실행합니다 (통과).
2. cargo clippy --all-targets --all-features -- -D warnings을 실행합니다 (통과).
3. cargo test --all을 실행합니다 (통과).
4. 브랜치가 feature/84-agent-skills인지 확인합니다.
5. 베이스 브랜치가 develop인지 확인합니다.
6. 원격 저장소에 푸시합니다.
7. 영어 제목과 본문으로 풀 리퀘스트를 생성합니다 (베이스: develop).
8. 풀 리퀘스트 URL을 사용자에게 보고합니다.