"커밋 메시지 추천 좀" 고민 끝! Conventional Commits 자동 생성

Author: Zzabbis // Date: 2026-02-04

📝 “커밋 메시지 추천 좀” 고민 끝! Conventional Commits 자동 생성

“코드 짜는 것보다 커밋 메시지 쓰는 게 더 어렵네…”

fix: bug, update code… 혹시 이렇게 커밋하고 계신가요? 좋은 커밋 메시지는 히스토리 관리의 핵심이지만, 매번 영작하느라 머리에 쥐가 나죠. git diff 내용만 던져주면, 오픈소스 진영 표준인 Conventional Commits 스타일로 쫙 뽑아드립니다.


⚡️ 3줄 요약 (TL;DR)

  1. 변경 사항을 분석해 적절한 타입(feat, fix, refactor 등) 자동 선정
  2. 간결하고 명확한 제목과 상세한 본문 작성
  3. 팀 컨벤션에 맞춘 포맷팅

🚀 해결책: “Git 커밋 메시지 생성기”

아래 PROMPT 내용을 복사해서 사용하세요.

역할 (Role): 너는 Git 히스토리 관리에 집착하는 오픈소스 메인테이너야.

상황 (Context): 내가 코드를 수정했는데, 동료들이 쉽게 이해할 수 있는 깔끔한 커밋 메시지가 필요해.

요청 (Task): 아래 [변경 사항]을 분석해서 Conventional Commits 규칙에 맞는 커밋 메시지를 3개 추천해줘.

  1. 형식: <type>(<scope>): <subject>
  2. 본문(Body): 변경 이유(Why)와 변경 내용(What)을 글머리 기호로 요약해줘.
  3. 꼬리말(Footer): (선택) 이슈 번호가 있다면 Closes #123 형식으로 추가해줘.

변경 사항 (git diff 또는 요약):

[여기에 `git diff` 결과나 변경 내용을 간단히 적으세요]

제약사항 (Constraints):

  • Type 종류: feat, fix, docs, style, refactor, test, chore 중 하나를 선택해.
  • Subject(제목)는 50자를 넘기지 말고, 명령문(동사 원형)으로 시작해. (한글/영어 선택 가능, 기본은 영어)

🧬 프롬프트 해부 (Why it works?)

이 프롬프트가 강력한 이유는 3가지 논리적 장치 때문입니다.

  1. 표준 준수: Conventional Commits라는 명확한 규칙을 따르도록 강제하여, 일관성 있는 메시지를 생성합니다.
  2. 3가지 옵션: 단 하나만 주는 게 아니라 3가지를 제안받아, 내 의도에 가장 잘 맞는 뉘앙스를 고를 수 있습니다.
  3. 구조화: 제목(Subject), 본문(Body), 꼬리말(Footer)을 분리하여 단순히 “고쳤음”이 아니라 “왜, 무엇을” 고쳤는지 기록하게 합니다.

📊 증명: Before & After

❌ Before (입력 변경 사항)

“로그인 버튼 색깔 빨간색으로 바꾸고, 로그인 안 되는 버그 수정했어. 아 그리고 리드미에 설치법 추가함.”

✅ After (결과)

Option 1 (버그 수정 중심)

fix(auth): resolve login failure issue and update button style

- Fix logic error preventing user login
- Change login button color to red for better visibility
- Add installation guide to README.md

Option 2 (UI 개선 중심)

style(ui): update login button color and fix login bug

- Change login button color to red
- Fix login functionality bug
- docs: update installation guide in README

🚨 트러블 슈팅 (안 될 땐 이렇게!)

Q. 한글 커밋 메시지를 원해요. A. 요청 사항에 “커밋 메시지 제목과 본문을 모두 한글로 작성해줘” 라고 명시하면 됩니다.

Q. 이모지(Emoji)를 넣고 싶어요. A. “Gitmoji 스타일을 적용해서 메시지 앞에 🐛, ✨ 같은 이모지를 붙여줘” 라고 추가하세요.


🎯 결론

커밋 메시지는 미래의 나, 그리고 동료에게 보내는 편지입니다. 대충 쓰지 마세요. AI의 도움을 받아 “이 사람 커밋 로그 참 깔끔하네”라는 칭찬을 들어보세요! 🍷