| name | commit-message-generator |
| description | 정해진 형식에 따라 구조화된 한글 커밋 메시지를 생성합니다. 커밋 생성 시 프로젝트의 커밋 컨벤션을 자동으로 적용하여 일관성 있는 커밋 히스토리를 유지합니다. |
Commit Message Generator
이 스킬은 프로젝트의 커밋 메시지 컨벤션을 자동으로 적용하여 일관성 있고 구조화된 커밋 메시지를 생성합니다.
목적
사용자가 커밋을 요청할 때마다 정해진 형식을 따르는 한글 커밋 메시지를 자동으로 작성하여, 커밋 히스토리의 일관성과 가독성을 높입니다.
사용 시점
사용자가 다음과 같은 요청을 할 때 이 스킬을 사용합니다:
- "커밋 만들어줘"
- "변경사항 커밋해줘"
- "git commit 해줘"
- 또는 커밋 생성을 요청하는 모든 경우
커밋 메시지 형식
헤더 형식
[타입] 간결한 설명 (한글, 50자 이내)
바디 형식
## 설명
변경 사항에 대한 상세 설명
## 추가 내용 (선택)
- 새로 추가된 기능이나 파일 목록
- 각 항목을 bullet point로 나열
## 변경 내용 (선택)
- 수정되거나 리팩터링된 내용
- 각 항목을 bullet point로 나열
## 관련 이슈 (선택)
- #이슈번호
커밋 타입 가이드
상세한 커밋 타입 정의와 사용 예시는 references/commit-types.md 파일을 참조합니다.
사용 가능한 타입: feat, fix, docs, style, refactor, test, chore, perf, ci, build, revert
타입 선택 기준
- 새로운 기능이 추가되었는가? →
feat - 버그를 수정했는가? →
fix - 문서만 변경되었는가? →
docs - 코드 포맷팅/스타일만 변경되었는가? →
style - 동작은 같지만 코드 구조를 개선했는가? →
refactor - 테스트 코드를 추가/수정했는가? →
test - 빌드 설정이나 패키지를 업데이트했는가? →
chore - 성능을 개선했는가? →
perf - CI/CD 설정을 변경했는가? →
ci - 빌드 시스템을 수정했는가? →
build - 이전 커밋을 되돌렸는가? →
revert
프론트엔드 프로젝트 특화 가이드
프론트엔드 변경사항을 설명할 때는 다음과 같이 구분하여 작성합니다:
UI 관련 변경사항
- 컴포넌트 구조 변경
- 스타일링 수정
- 레이아웃 조정
- 사용자 인터페이스 개선
상태관리/서비스 관련 변경사항
- 훅(Hook) 추가 또는 수정
- 상태 관리 로직 변경
- API 연동 및 데이터 페칭
- 비즈니스 로직 구현
작성 프로세스
커밋 메시지를 작성할 때 다음 순서를 따릅니다:
변경사항 분석: git diff와 git status를 통해 모든 변경 파일과 내용을 파악합니다.
타입 결정: 변경사항의 주요 목적에 따라 적절한 커밋 타입을 선택합니다. 여러 타입이 혼재된 경우 가장 주된 변경사항의 타입을 사용합니다.
헤더 작성:
[타입] 간결한 설명형식으로 작성합니다. 설명은 50자 이내로 변경의 핵심을 담습니다.바디 작성:
- 설명 (필수): 왜 이 변경이 필요했는지, 무엇을 해결했는지 상세히 설명합니다.
- 추가 내용 (선택): 새로 추가된 파일, 함수, 컴포넌트 등을 나열합니다.
- 변경 내용 (선택): 기존 코드에서 수정된 부분을 나열합니다.
- 관련 이슈 (선택): 연관된 이슈가 있으면
#이슈번호형식으로 추가합니다.
프론트엔드 구분: 프론트엔드 프로젝트의 경우, 추가/변경 내용을 작성할 때 UI 관련 변경과 상태관리/서비스 관련 변경을 명확히 구분하여 기술합니다.
최종 확인: 작성된 커밋 메시지가 형식을 올바르게 따르는지, 변경사항을 정확히 반영하는지 확인합니다.
커밋 메시지 예시
예시 1: 새로운 기능 추가
[feat] 로그인 기능 추가
## 설명
사용자 인증을 위한 로그인 기능을 구현했습니다. 이메일과 비밀번호 검증 로직을 포함하며, JWT 토큰 기반 인증을 사용합니다.
## 추가 내용
- LoginForm 컴포넌트 생성
- useAuth 훅 구현
- email, password 검증 로직 추가
- 로그인 API 연동
## 관련 이슈
- #12
예시 2: 버그 수정
[fix] 로그인 실패 시 에러 메시지 표시 오류 수정
## 설명
로그인 실패 시 에러 메시지가 화면에 표시되지 않는 문제를 수정했습니다. 에러 상태 관리 로직의 조건문 오류를 수정하여 해결했습니다.
## 변경 내용
- LoginForm 컴포넌트의 에러 상태 처리 로직 수정
- useAuth 훅의 에러 핸들링 개선
예시 3: 리팩터링
[refactor] SignupForm 컴포넌트 구조 단순화
## 설명
SignupForm 컴포넌트의 복잡한 상태 관리 로직을 커스텀 훅으로 분리하여 가독성과 재사용성을 개선했습니다.
## 추가 내용
- useSignupForm 커스텀 훅 생성
## 변경 내용
- SignupForm 컴포넌트에서 상태 관리 로직 제거
- 폼 검증 로직을 훅으로 이동
주의사항
한글 사용: 모든 커밋 메시지는 한글로 작성합니다.
명확성: 헤더는 간결하게, 바디는 상세하게 작성하여 나중에 커밋 히스토리를 볼 때 변경 이유와 내용을 쉽게 파악할 수 있도록 합니다.
원자성: 하나의 커밋은 하나의 논리적 변경사항을 담아야 합니다. 여러 타입의 변경이 섞여있다면 커밋을 나누는 것을 고려합니다.
일관성: 항상 동일한 형식을 유지하여 팀 전체의 커밋 히스토리가 일관되게 관리되도록 합니다.
Co-Author 태그: 커밋 메시지 마지막에는 항상 다음 내용을 자동으로 포함합니다:
🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>