git-split-pr

Files (1)

• SKILL.md

SKILL.md (first lines)

# Git 업무 단위 분리 & PR 워크플로우

세션에서 발생한 모든 변경사항을 논리적 업무 단위로 나누고, 각 단위를 독립 브랜치로 커밋-푸시-PR까지 자동 처리하는 워크플로우.

---

## 단계 1: 변경사항 전체 파악

```bash
git status
git diff --stat HEAD
git diff HEAD
```

- 미추적(untracked), 수정(modified), 스테이징된 파일 모두 확인
- 삭제된 파일도 포함하여 전체 변경 범위를 파악
- 현재 브랜치와 원격 브랜치 상태도 확인: `git branch -vv`

---

## 단계 2: 업무 단위 분류

변경된 파일들을 **논리적 작업 단위**로 그룹화한다. 파일 경로, 수정 내용, 관련성을 기준으로 판단:

**분류 기준 (우선순위 순):**
1. **기능 단위** — 같은 기능/도메인에 속하는 파일들 (예: auth 관련 파일들)
2. **변경 유형** — feat(기능 추가), fix(버그 수정), refactor(리팩토링), docs(문서), chore(설정)
3. **독립성** — 서로 영향 없이 배포 가능한 단위

**분류 후 사용자에게 반드시 확인:**
```
발견된 업무 단위:
1. [유형] 설명 — 파일 목록
2. [유형] 설명 — 파일 목록
...

이 분류로 진행할까요? 수정이 필요하면 말씀해주세요.
```

사용자 확인 없이 다음 단계로 진행하지 말 것.

---

## 단계 3: 현재 브랜치 및 기반 브랜치 확인

```bash
git remote show origin | grep "HEAD branch"
git branch -r | grep -E "main|master"
```

기반 브랜치 결정 (보통 `main` 또는 `master`). 각 작업 단위 브랜치는 이 기반 브랜치에서 분기한다.

현재 브랜치에 미커밋 변경사항이 있으므로, 임시로 stash하거나 작업 순서를 조율:
```bash
git stash  # 필요 시
```

---

## 단계 4: 각 업무 단위 처리 (순서대로 반복)

각 업무 단위에 대해 아래 절차를 완전히 수행한 후 다음 단위로 넘어간다.

### 4-1. 브랜치 생성

기반 브랜치에서 새 브랜치 생성:
```bash
git checkout <기반브랜치>
git pull origin <기반브랜치>
git checkout -b <브랜치명>
```

**브랜치 명명 규칙:**
- 형식: `<유형>/<짧은-설명-영문>` 
- 예: `feat/user-authentication`, `fix/login-redirect-bug`, `refactor/api-client`
- 소문자, 하이픈 사용, 30자 이내

### 4-2. 해당 파일만 스테이징

해당 업무 단위에 속하는 파일만 정확히 추가:
```bash
git add <파일1> <파일2> ...
# 신규 파일도 포함
# 삭제된 파일은 git rm 또는 git add -u
```

스테이징 상태 확인: `git status`

### 4-3. 한글 커밋 메시지 생성

**커밋 메시지 구조:**

```
<유형>: <한글 TLDR — 이 커밋으로 무엇이 달라지는지 한 줄로>

- <변경 내용 1>
- <변경 내용 2>
- <변경 내용 3>
```

**제목 규칙 (첫 줄):**
- 반드시 한 줄로 끝낼 것 — 줄바꿈 없이 TLDR 요약
- "무엇을 했다"가 아니라 "무엇이 가능해졌다/해결됐다" 관점으로 작성
- 50자 이내 권장

**본문 규칙 (리스트):**
- 기술 용어 대신 기능·사용자 관점 용어 사용
  - ❌ `AuthService 리팩토링`, `JWT 미들웨어 추가`
  - ✅ `로그인 유지 방식 개선`, `자동 로그아웃 기능 추가`
- 변경사항이 많지 않으면 3개 내외, 최대 5개를 넘지 않을 것
- 비개발자가 읽어도 "아, 이게 바뀌었구나" 알 수 있을 정도의 간결함

**유형 분류:**
| 유형 | 의미 |
|------|------|
| `feat` | 새 기능 추가 |
| `fix` | 버그 수정 |
| `refactor` | 내부 구조 개선 (기능 변화 없음) |
| `docs` | 문서 수정 |

From ureca-corp/claude, MIT.

More from ureca-corp/claude