---
name: commit
description: |
  코드 수정 완료 후 conventional commit 형식의 커밋 메시지를 자동 생성하고 사용자 확인 후 커밋합니다.
  사용자가 커밋해줘 또는 /commit 요청 시 사용.
arguments:
  - name: message
    description: 커밋 메시지 직접 지정 (미지정 시 자동 생성)
    required: false
  - name: all
    description: 모든 변경사항 자동 스테이징 (-a 옵션)
    required: false
---

# 커밋 스킬

변경사항을 분석하여 Conventional Commits 형식의 커밋 메시지를 자동 생성하고, 사용자 확인 후 커밋합니다.

## 사용법

```
/commit                        # 자동 메시지 생성 후 확인
/commit --all                  # 모든 변경사항 스테이징 후 커밋
/commit --message "feat: 기능" # 메시지 직접 지정
```

## 워크플로우

### Step 1: 변경사항 분석

1. **스테이징 상태 확인**: `git status --porcelain`
   - 변경사항 없으면: "커밋할 변경사항이 없습니다" 안내 후 중단

2. **staged 변경사항 확인**: `git diff --cached --stat`
   - staged 파일 없고 --all 미지정 시: unstaged 파일 목록 보여주고 스테이징 여부 확인

3. **변경 내용 분석**: `git diff --cached` (또는 --all 시 `git diff`)
   - 변경된 파일들과 내용 파악

### Step 2: 커밋 메시지 생성

--message 미지정 시 자동 생성:

1. **변경 유형 판단**:
   - 새 파일 추가 → `feat:`
   - 버그 수정 → `fix:`
   - 리팩토링 → `refactor:`
   - 문서 수정 (.md 파일만) → `docs:`
   - 스타일/포맷 변경 → `style:`
   - 테스트 추가/수정 → `test:`
   - 빌드/설정 변경 → `chore:`

2. **메시지 형식**:
   ```
   <type>: <간결한 설명 (한국어 또는 영어)>

   - 변경사항 1
   - 변경사항 2
   ```

### Step 3: 사용자 확인

AskUserQuestion으로 확인 요청:

```
커밋 메시지를 확인해주세요:

---
feat: 새로운 기능 추가

- 파일1.ts 변경
- 파일2.ts 추가
---

이 메시지로 커밋할까요?
```

**선택지**:
- 커밋 진행
- 메시지 수정 (사용자가 직접 입력)
- 취소

### Step 4: 커밋 실행

1. **스테이징** (필요 시):
   - --all 옵션: `git add -A`
   - 특정 파일만: `git add <files>`

2. **커밋 실행**:
   ```bash
   git commit -m "<message>"
   ```

3. **결과 출력**:
   ```
   커밋 완료: <commit-hash>
   <commit-message 첫 줄>
   ```

## Conventional Commits 타입

| 타입 | 설명 | 예시 |
|------|------|------|
| feat | 새 기능 | feat: 사용자 로그인 추가 |
| fix | 버그 수정 | fix: 버튼 클릭 오류 수정 |
| refactor | 리팩토링 | refactor: API 호출 로직 개선 |
| docs | 문서 수정 | docs: README 업데이트 |
| style | 포맷/스타일 | style: 코드 포맷팅 |
| test | 테스트 | test: 유닛 테스트 추가 |
| chore | 빌드/설정 | chore: 의존성 업데이트 |

## 에러 처리

| 상황 | 메시지 |
|------|--------|
| 변경사항 없음 | 커밋할 변경사항이 없습니다 |
| git 저장소 아님 | git 저장소가 아닙니다 |
| 사용자 취소 | 커밋이 취소되었습니다 |