작업 단위별 commit & push & PR 명령어

Role

Git 워크플로우 전문가로서, 변경사항을 분석하고 의미 있는 단위로 분리하여 Conventional Commits 형식의 커밋을 생성하고, 원격 저장소에 push한 후 Pull Request를 생성합니다.

Purpose

코드 변경사항을 논리적 단위로 분리하여 커밋하고, 원격 저장소에 push한 후 PR을 생성하여 코드 리뷰를 요청합니다.

Context

Current git status: !git status
Current git diff (staged and unstaged changes): !git diff HEAD
Current branch: !git branch --show-current
Recent commits: !git log --oneline -10

변경사항 그룹화 기준

다음 기준으로 관련 변경사항을 그룹화합니다:

기능 단위: 하나의 기능을 완성하는 파일들
레이어 단위: 같은 레이어(UI, 로직, 데이터)의 변경
의존성: 서로 의존하는 변경들은 함께 커밋
독립성: 독립적으로 리버트 가능해야 함

분리해야 하는 경우

기능 추가 + 버그 수정 → 별도 커밋
리팩토링 + 새 기능 → 별도 커밋
포맷팅 + 로직 변경 → 별도 커밋

수행 단계

1. 작업을 논리적 단위로 분류

Context의 변경사항을 분석하여 관련된 것끼리 그룹화합니다:

관련된 변경사항끼리 묶어서 분류
각 그룹이 하나의 완성된 기능/수정 단위가 되도록 구성

2. 각 단위별로 순차 commit

가장 핵심적인 변경부터 시작하여 각 작업 단위별로 commit을 생성합니다:

해당 작업 단위의 파일들을 스테이징
```
git add [관련 파일들]
```
컨벤션에 맞는 commit 메시지 작성
- 형식: type(scope): 설명
- 타입 종류:
  - feat: 새로운 기능 추가
  - fix: 버그 수정
  - refactor: 코드 리팩토링
  - docs: 문서 수정
  - style: 코드 포맷팅, 세미콜론 누락 등
  - test: 테스트 코드 추가/수정
  - chore: 빌드 설정, 패키지 매니저 등
- 설명은 현재형으로 작성 (예: "add" not "added")
- 제목은 50자 이내로 작성
commit 실행
```
git commit -m "type(scope): 설명"
```

3. commit 완료 확인

모든 commit이 완료된 후 결과를 확인합니다:

git log --oneline -10으로 생성된 commit 이력 확인
git status로 남은 변경사항 확인

4. 원격 저장소에 push

commit된 변경사항을 원격 저장소에 반영합니다:

기본 push 실행
```
git push origin <current-branch>
```
push 실패 시 대응
- 업스트림 미설정: 새 브랜치인 경우 upstream 설정과 함께 push
```
git push -u origin <branch-name>
```
- 충돌 발생: 원격 브랜치의 변경사항을 먼저 pull하여 병합
- 권한 문제: 저장소 접근 권한 확인 필요함을 안내

5. Pull Request 생성

GitHub CLI를 사용하여 PR을 생성합니다:

PR 제목과 본문 작성
- 제목: 변경사항을 요약하는 명확한 제목
- 본문: 변경 내용, 테스트 방법, 관련 이슈 등

PR 생성 실행

gh pr create --title "PR 제목" --body "PR 본문"

PR 생성 확인
```
gh pr view --web
```

Examples

입력 상황

modified: src/auth/login.ts (로그인 버그 수정)
modified: src/auth/types.ts (타입 수정)
modified: src/users/profile.ts (새 기능 추가)
modified: README.md (문서 업데이트)

기대 출력

# Commit 1: 버그 수정
git add src/auth/login.ts src/auth/types.ts
git commit -m "fix(auth): resolve login validation error"

# Commit 2: 새 기능
git add src/users/profile.ts
git commit -m "feat(users): add profile avatar upload"

# Commit 3: 문서
git add README.md
git commit -m "docs: update installation guide"

# Push
git push origin feature/user-improvements

# PR 생성
gh pr create --title "feat: improve user authentication and profile" --body "## Summary
- Fix login validation error
- Add profile avatar upload feature
- Update installation guide

## Test Plan
- [ ] Test login with invalid credentials
- [ ] Test avatar upload with various image formats"

Constraints

<critical> - 민감한 파일(.env, credentials.json 등)은 절대 커밋하지 않음 - 커밋 없이 메시지만 출력하지 않음 - 반드시 실제 커밋 수행 - 변경사항이 없으면 커밋하지 않음 - force push는 절대 사용하지 않음 - main/master 브랜치에서 직접 PR 생성하지 않음 </critical> <important> - 각 커밋은 독립적으로 리버트 가능해야 함 - 관련 없는 변경사항은 반드시 별도 커밋으로 분리 - 커밋 메시지는 50자 이내로 작성 - 하나의 커밋은 하나의 논리적 변경만 포함 - push 전 원격 브랜치와의 충돌 여부 확인 - PR 제목은 변경사항을 명확히 요약 </important>

Arguments

$ARGUMENTS 처리:

제공됨: 해당 메시지를 PR 제목으로 사용
미제공: 커밋 내역을 분석하여 적절한 PR 제목 자동 생성

/commit-push-pr