commit-ko

1# commit-ko — 커밋 메시지 자연화
2 
3한글 커밋 메시지 초안에서 AI 특유의 사무적·번역투 어휘만 걷어내고, 의미·범위·타입은 한 글자도 바꾸지 않는다.
4 
5## 입력
6 
7- 커밋 메시지 초안(subject 1줄 + 선택적 body). 여러 개면 각각 처리.
8- Conventional Commits 형식(`type(scope): subject`, 예: `fix(auth): 로그인 실패 시 재시도 로직을 수행함`)이면 `type`/`scope` 접두사는 그대로 두고, 콜론 뒤 한국어 부분만 윤문 대상으로 삼는다.
9- (선택) 사용자가 `git diff`나 변경 요약을 함께 주면 — 새 내용을 추가하기 위해서가 아니라, 윤문 과정에서 의미가 틀어지지 않았는지 대조 확인하는 용도로만 참고한다.
10 
11## 철칙 (humanize-korean과 동일 정신 계승)
12 
131. **의미·범위·타입 불변** — feat/fix/docs/refactor/chore 등 커밋 타입, 스코프, 무엇을 했는지의 사실관계는 절대 바꾸지 않는다.
142. **새 내용 삽입 금지** — 원문에 없던 이유·효과·수치를 지어내지 않는다. 어휘·종결만 바꾼다.
153. **과공손·과격식 방향으로도 바꾸지 않는다** — "~함" 같은 커밋 관용 종결이 이미 자연스러우면 "~하였습니다"로 격상시키지 않는다.
16 
17## 처리 절차
18 
191. `references/commit-lexicon.md`를 읽는다.
202. 커밋 메시지에서 사무적 동사(수행/진행/실시 등)·한자어 명사화(-성/-적/-화)·과공손 종결·장황한 명사구 패턴과, **영어 직역 구문**(by-passive "~에 의해", 이중 피동 "~되어지다", "가지고 있다"류 have 직역)을 찾는다. 단 업데이트·리팩터링·버그 등 개발 용어로 굳은 외래어는 대상이 아니다 — 어휘의 출신이 아니라 구문 구조가 문제다.
213. 찾은 패턴만 lexicon의 처방대로 치환한다. 해당 패턴이 하나도 없으면 "이미 자연스러운 커밋 메시지입니다"라고 안내하고 종료한다(억지로 손대지 않음).
224. type/scope 접두사, 이슈 번호, 파일·함수명 등 고유 토큰은 그대로 보존한다.
23 
24## 출력
25 
26- 윤문된 커밋 메시지 1개(원문과 형식을 맞춤 — subject만 있었으면 subject만).
27- 애매한 경우 대안 표현을 1~2개까지 병기 가능.
28- 무엇을 왜 바꿨는지 한 줄 근거(예: "'~을 수행함' → '~함' — 커밋 메시지에 불필요한 격식 동사").
29 
30## 참고
31…