Commit

---
name: commit
description: Use when composing a git commit in this project — 커밋 메시지 작성·커밋 구성 시점. 커밋 분할은 이미 결정돼 있다는 전제로 메시지 작성에 집중하고, 미정일 때만 분할 판단 지침을 제공한다. 미푸시 커밋 수정·리뷰 반영의 fixup 흡수 절차 포함. Triggers on "커밋하자", "커밋해줘", "커밋 정리해". Does NOT trigger on PR 본문 작성(pr 스킬), 이슈 작성(issue 스킬), docs/ 문서 작성.
---

# Commit — 커밋 메시지·구성

**일반 글쓰기 원칙(두괄식·간결)은 CLAUDE.md 소관이다.** 커밋의 목적은 작업의 맥락 전달 — diff가 보여주는 "무엇"이 아니라 "왜·어디서 동작이 달라졌는가".

## 메시지 — 주 임무

커밋 분할은 대개 이미 결정돼 있다 (작전명령 부록 B 커밋 시퀀스, 유저 지시). 이 스킬의 기본 임무는 결정된 단위에 맞는 메시지 작성이다.

- 첫 줄 `[#이슈번호] 동작 변화 요약` — 파일/클래스 목록 ❌, 동작이 어떻게 달라졌나 ✅ (예시는 CLAUDE.md §5)
- 본문은 앵커 단위 불릿: 변경된 코드 심볼(`ClassName.methodName`)을 앵커로, 한 불릿 = 한 앵커 + 그 변화
- 배경이 상위 PR/이슈에 있으면 커밋에 반복하지 않는다. 단독 커밋(cherry-pick·핫픽스)일 때만 배경 서술
- 폐기한 안·시행착오는 싣지 않는다 — 메시지는 최종 diff가 왜 이 모양인지만 말한다

## 분할이 미정일 때만 — 단위 판단

- 한 커밋 = 한 논리 단위 (한 레이어·한 서사). 중·소 feature는 3~5 커밋 권장 — 과도한 원자화도, 뭉텅이 커밋도 지양.
- TDD 중간 상태(RED/GREEN 과정)는 싣지 않는다 — 리팩터까지 반영된 결과를 묶는다.

## 공통 절차

- 스테이징(`git add`)은 직접 수행한다 — 유저에게 미루지 않는다. 논리 단위에 맞춰 파일을 나눠 담는다.
- 커밋 전 완료 판정(impact-check → 테스트 → 짝 경고 해소)은 implement 스킬이 규정한다.

## 미푸시 커밋 수정 — 흡수

셀프 리뷰·에이전트 리뷰 반영이나 방향 수정은 follow-up 커밋 금지 — 원본 커밋에 흡수한다 (최종 결과물에 수정 노이즈를 남기지 않는다). **PR 공개 전후를 가리지 않는다** — 리뷰 반영도 "원래 커밋에 있어야 했던 것"이지 후속 개선이 아니다:

- 직전 커밋이면 `git commit --amend`
- 그 이전 커밋이면:

```bash
git add <해당 파일>
git commit --fixup <원본 커밋 sha>
GIT_SEQUENCE_EDITOR=true git rebase -i --autosquash <base>   # 대화형 rebase 불가 환경의 우회 — 에디터 없이 autosquash 배치만 적용
```

PR 공개 이후의 반영도 같다 — 흡수 후 `--force-with-lease`. 리뷰어의 추적성은 커밋 분리가 아니라 **리뷰 스레드 대댓글**(무엇을 어떻게 고쳤는지 + 흡수한 커밋 sha)로 담보한다 (CLAUDE.md GitHub 조항).

**한 라운드의 반영은 전부 흡수한 뒤 push 를 한 번만 한다. 회신·resolve 는 그 push 뒤에.** rebase 는 대상 커밋뿐 아니라 그 앞뒤 모든 커밋을 재생성해 sha 를 바꾼다 — 코멘트마다 흡수→push→회신을 반복하면 먼저 회신에 적은 sha 가 다음 흡수로 곧바로 죽는다. 순서를 지키면 회신에 적는 sha 가 전부 최종본을 가리킨다.

## 종료 기록 — skill_end

**유저가 커밋 자체를 목적으로 직접 지시한 독립 런에서만** 남긴다 — 커밋(흡수 포함)을 마친 직후 `log-record.py skill_end --name commit` (명령·compliance 규칙은 CLAUDE.md §1). implement 완료 판정·pr 리뷰 반영·SDD 태스크 흐름 안에서 도구로 호출된 커밋은 기록하지 않는다 — 종료는 상위 스킬이 남긴다.