Claude Command: Commit

이 커맨드는 컨벤셔널 커밋 메시지를 사용하여 체계적인 커밋을 생성하도록 도와줍니다. 커밋시 husky 훅이 실행되므로, lint, typecheck 등의 검증을 필요하지 않습니다.

1. --no-verify로 지정되면 –no-verify로 실행해 훅 실행을 건너 뜁니다.
2. git status로 스테이징된 파일을 확인합니다
3. 스테이징된 파일이 0개라면, 자동으로 모든 수정/신규 파일을 git add로 추가합니다
4. git diff를 수행하여 커밋될 변경사항을 파악합니다
5. diff를 분석하여 여러 개의 논리적으로 구분된 변경사항이 있는지 판단합니다
6. 여러 개의 구분된 변경사항이 감지되면, 커밋을 여러 개로 분할할 것을 제안합니다
7. 각 커밋(또는 분할하지 않는 경우 단일 커밋)에 대해 컨벤셔널 커밋 형식으로 메시지를 생성합니다

커밋 모범 사례

• 커밋 전 검증: 코드가 린팅되고, 타입 체크를 통과하는지 확인
• 원자적 커밋: 각 커밋은 단일 목적을 가진 관련된 변경사항만 포함
• 큰 변경사항 분할: 여러 관심사를 다루는 변경사항은 별도 커밋으로 분할
• 컨벤셔널 커밋 형식: <type>(<scope>): [#이슈번호] <설명> 형식 사용, type은 다음 중 하나:
  • feat: 새로운 기능
  • fix: 버그 수정
  • docs: 문서 변경
  • style: 코드 스타일 변경 (포맷팅 등)
  • refactor: 버그 수정이나 기능 추가가 아닌 코드 변경
  • perf: 성능 개선
  • test: 테스트 추가 또는 수정
  • chore: 빌드 프로세스, 도구 등의 변경
  • ci: CI/CD 관련 변경
  • revert: 변경사항 되돌리기
• 커밋 메시지 제목은 한국어로 작성: 설명은 한국어로 명확하게 작성
• 간결한 첫 줄: 첫 줄은 72자 이내로 유지
• 이모지 사용 금지: 커밋 메시지에 이모지를 넣지 않는다. type(scope): 형식만 사용

커밋 분할 가이드라인

diff를 분석할 때, 다음 기준에 따라 커밋 분할을 고려합니다:

1. 다른 관심사: 코드베이스의 서로 관련없는 부분의 변경
2. 다른 변경 타입: 기능, 수정, 리팩토링 등이 섞인 경우
3. 파일 패턴: 다른 유형의 파일 변경 (예: 소스 코드 vs 문서)
4. 논리적 그룹화: 별도로 이해하거나 리뷰하기 쉬운 변경사항
5. 크기: 분할하면 더 명확해질 수 있는 매우 큰 변경사항

예시

좋은 커밋 메시지 (한국어):

• 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자를 넘지 않도록 합니다