| name | commit |
| description | 컨벤셔널 커밋 메시지 생성. "커밋해줘", "커밋", "변경사항 저장" 등의 요청 시 사용 Use when this capability is needed. |
| metadata | {"author":"gihwan-dev"} |
Claude Command: Commit
이 커맨드는 컨벤셔널 커밋 메시지를 사용하여 체계적인 커밋을 생성하도록 도와줍니다. 커밋시 husky 훅이 실행되므로, lint, typecheck 등의 검증을 필요하지 않습니다.
--no-verify로 지정되면 --no-verify로 실행해 훅 실행을 건너 뜁니다.git status로 스테이징된 파일을 확인합니다- 스테이징된 파일이 0개라면, 자동으로 모든 수정/신규 파일을
git add로 추가합니다
git diff를 수행하여 커밋될 변경사항을 파악합니다- diff를 분석하여 여러 개의 논리적으로 구분된 변경사항이 있는지 판단합니다
- 여러 개의 구분된 변경사항이 감지되면, 커밋을 여러 개로 분할할 것을 제안합니다
- 각 커밋(또는 분할하지 않는 경우 단일 커밋)에 대해 컨벤셔널 커밋 형식으로 메시지를 생성합니다
커밋 모범 사례
- 커밋 전 검증: 코드가 린팅되고, 타입 체크를 통과하는지 확인
- 원자적 커밋: 각 커밋은 단일 목적을 가진 관련된 변경사항만 포함
- 큰 변경사항 분할: 여러 관심사를 다루는 변경사항은 별도 커밋으로 분할
- 컨벤셔널 커밋 형식:
<type>(<scope>): [#이슈번호] <설명> 형식 사용, type은 다음 중 하나:
feat: 새로운 기능fix: 버그 수정docs: 문서 변경style: 코드 스타일 변경 (포맷팅 등)refactor: 버그 수정이나 기능 추가가 아닌 코드 변경perf: 성능 개선test: 테스트 추가 또는 수정chore: 빌드 프로세스, 도구 등의 변경ci: CI/CD 관련 변경revert: 변경사항 되돌리기
- 커밋 메시지 제목은 한국어로 작성: 설명은 한국어로 명확하게 작성
- 간결한 첫 줄: 첫 줄은 72자 이내로 유지
- 이모지 사용 금지: 커밋 메시지에 이모지를 넣지 않는다.
type(scope): 형식만 사용
커밋 분할 가이드라인
diff를 분석할 때, 다음 기준에 따라 커밋 분할을 고려합니다:
- 다른 관심사: 코드베이스의 서로 관련없는 부분의 변경
- 다른 변경 타입: 기능, 수정, 리팩토링 등이 섞인 경우
- 파일 패턴: 다른 유형의 파일 변경 (예: 소스 코드 vs 문서)
- 논리적 그룹화: 별도로 이해하거나 리뷰하기 쉬운 변경사항
- 크기: 분할하면 더 명확해질 수 있는 매우 큰 변경사항
예시
좋은 커밋 메시지 (한국어):
feat(react): [#52] 사용자 인증 시스템 추가fix(react): [#63] 렌더링 프로세스의 메모리 누수 해결docs(docs): 새로운 엔드포인트로 API 문서 업데이트refactor(react): [#45] 파서의 에러 처리 로직 단순화test(react): [#52] RowClick Feature 단위 테스트 추가chore(root): 개발자 도구 설정 프로세스 개선perf(react): [#45] 그룹 헤더 연관 기능 성능 개선
커밋 분할 예시:
- 첫 번째 커밋:
feat(react): [#52] 새로운 solc 버전 타입 정의 추가
- 두 번째 커밋:
docs(docs): 새로운 solc 버전에 대한 문서 업데이트
- 세 번째 커밋:
chore(deps): package.json 의존성 업데이트
- 네 번째 커밋:
test(react): [#52] 새로운 기능에 대한 단위 테스트 추가
커맨드 옵션
--no-verify: 커밋 전 검증 (lint, typecheck) 건너뛰기
중요 사항
- 기본적으로 코드 품질을 보장하기 위해 커밋 전 검증(
pnpm lint, pnpm typecheck)이 실행됩니다
- 이러한 검증이 실패하면, 커밋을 계속 진행할지 아니면 먼저 문제를 수정할지 묻습니다
- 특정 파일이 이미 스테이징되어 있다면, 해당 파일만 커밋됩니다
- 스테이징된 파일이 없다면, 모든 수정 및 신규 파일을 자동으로 스테이징합니다
- 커밋 메시지는 감지된 변경사항을 기반으로 작성됩니다
- 커밋하기 전에 diff를 검토하여 여러 커밋으로 나누는 것이 더 적절한지 식별합니다
- 여러 커밋을 제안하는 경우, 변경사항을 별도로 스테이징하고 커밋하도록 도와줍니다
- 항상 커밋 diff를 검토하여 메시지가 변경사항과 일치하는지 확인합니다
- 커밋 메시지는 반드시 한국어로 작성합니다
- 이모지를 절대 사용하지 않습니다
- body 각 줄은 100자를 넘지 않도록 합니다
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
