commit-all

name	commit-all
description	WSS-iOS-V2 프로젝트에서, 현재 Git 변경 전부를 스테이징해 커밋할 때 사용한다. 선택적으로 사용자가 지정한 개수만큼 개념 단위로 나눠 커밋할 수 있다. "전부 커밋", "다 커밋해줘", "/commit-all", "/commit-all 3" 같은 요청에 트리거. 커밋 양식은 `[Type]
metadata	{"short-description":"전체 Git 변경을 WSS 양식으로 커밋(선택적 분할)"}

Commit All (WSS-iOS-V2)

현재 Git 변경 전부를 스테이징해 커밋한다. 스킬명 뒤에 숫자 인자 하나가 오면 그 개수만큼 개념 단위로 분할 커밋한다.

인자

• 선택적 커밋 개수: 양의 정수 (예: commit-all 3).
• 개수가 없으면 모든 변경을 하나의 커밋으로.
• 개수가 있으면 변경을 그만큼의 일관된 개념 그룹으로 나눌 수 있을 때만 정확히 그 수만큼 커밋한다.
• 요청한 개수가 부적절·불가능하거나 명확한 개념 그룹으로 못 나누면 멈추고 어떻게 나눌지 사용자에게 묻는다.

커밋 양식 (고정)

[Type] #<이슈번호> - <한글 내용>

예: [Fix] #132 - 작품 평가 뒤로가기 경합 수정

• [Type]: 아래 Type 표에서 각 커밋의 성격에 맞는 하나. 브랜치의 Type과 무관 — 그 커밋의 변경 내용 기준.
• #<이슈번호>: 현재 브랜치명에서 자동 추출한다 (→ 이슈 번호 추출). 분할 커밋이라도 모두 같은 이슈 번호.
• <한글 내용>: 변경을 한 줄로 요약한 한글 설명.
• 이 양식에서 벗어나지 않는다. 헷갈리면 git log --oneline -8의 실제 커밋들이 진실.

이슈 번호 추출

1. git branch --show-current로 현재 브랜치명을 얻는다 (정규형 <Type>/#<번호>, 예: Feat/#132).
2. 브랜치명에서 # 뒤 숫자, 없으면 마지막 / 뒤 숫자를 이슈 번호로 쓴다.
3. 추출 실패 시 → git log --oneline -8에서 최근 커밋의 #번호를 재사용하거나, 모호하면 사용자에게 묻는다. 지어내지 않는다.

절차

1. 전체 변경 파악:

   • git status --short 실행.
   • unstaged 추적 변경은 git diff --stat, 이미 스테이징된 변경은 git diff --cached --stat로 확인.
   • git status --short에서 untracked 파일도 메모.

2. 이슈 번호 확보: 위 이슈 번호 추출 절차 수행.

3. 커밋 그룹 결정:

   • 개수 미지정이면 모든 변경을 한 커밋으로 계획.
   • 개수가 있으면 파일 경로·diff를 충분히 보고 그만큼의 개념 그룹(독립적 기능/수정/문서/테스트/도구 등)으로 묶는다.
   • 파일 수 균형이 아니라 동작·소유 단위로 묶는다. 강하게 결합된 변경을 개수 맞추려 쪼개지 말고, 그럴 땐 의도한 분할을 사용자에게 묻는다.

4. 스테이징 & 커밋:

   • 스테이징·unstaged·untracked 변경이 하나도 없으면 커밋하지 말고 알린다.
   • 단일 커밋: git add -A 후 스테이징 diff를 검토하고 커밋.
   • 분할 커밋: 각 그룹을 명시적 pathspec으로 따로 스테이징. 이미 스테이징돼 있던 변경도 올바른 그룹에 포함시킨다.
   • 인덱스에 이미 여러 그룹의 변경이 섞여 있어 그대로 커밋하면 안 되는 경우, 스테이징을 조정하기 전에 멈추고 묻는다.
   • 각 커밋 전 git status --short, git diff --cached --stat, git diff --cached --name-only 실행. 필요 시 git diff --cached로 제목 근거 확인.
   • 각 그룹을 git commit -m "[Type] #번호 - 내용"으로 커밋.
   • 샌드박스가 .git 쓰기를 막으면 좁은 사유를 달아 권한 상승 후 같은 명령 재시도.

5. 검증:

   • git status --short, 만든 커밋 수만큼 git log --oneline -n <count> 실행.
   • 각 커밋 해시·제목, 워크트리가 깨끗하지 않으면 남은 파일을 보고한다.

Type 표

각 커밋의 [Type]은 반드시 ../commit-types.md를 읽어 그 표에서 해당 커밋의 성격에 맞는 하나를 고른다. 표를 여기 복제하지 않는다 — 그 파일이 단일 진실 소스다. 커밋 헤더에서는 대괄호로 감싼다([Feat] 등).

안전 규칙

• 기본 단일 커밋 흐름에서는 git add -A가 정상이다.
• 사용자가 커밋 개수를 줬거나 분할을 명시적으로 요청한 경우에만 선택적으로 스테이징한다.
• 사용자의 변경을 보존한다. 스테이징을 비우려 git reset·git checkout 같은 파괴적 명령을 쓰지 말고, 의도한 그룹을 직접 스테이징한다.
• 사용자가 명시적으로 요청하지 않는 한 git reset·git checkout 등 파괴적 명령 금지.
• 워크트리에 명백히 무관하거나 위험한 생성 산출물이 섞여 있으면 멈추고 커밋 전에 묻는다.