📌 참고: 이 문서는 awesome Claude Code 문서의 원문 + 레퍼런스입니다.

• 원문 링크를 방문하셔서 복사해서 사용하셔도 됩니다
• 이 파일을 .claude/skills/ 하위에 복사하여 스킬로 등록할 수도 있습니다

(26.03.15 기준)

Claude 커맨드: 커밋

이 커맨드는 컨벤셔널 커밋 메시지와 이모지를 사용하여 잘 구성된 커밋을 생성하는 것을 도와줍니다.

사용법

커밋을 생성하려면 다음과 같이 입력하세요:

/commit

또는 옵션과 함께:

/commit --no-verify

이 커맨드가 하는 일

1. --no-verify로 지정하지 않는 한, 자동으로 사전 커밋 검사를 실행합니다:
   • pnpm lint로 코드 품질을 확인합니다
   • pnpm build로 빌드 성공 여부를 검증합니다
   • pnpm generate:docs로 문서를 업데이트합니다
2. git status로 스테이징된 파일을 확인합니다
3. 스테이징된 파일이 0개이면, git add로 수정 및 신규 파일을 자동으로 모두 추가합니다
4. git diff를 수행하여 커밋되는 변경 사항을 파악합니다
5. diff를 분석하여 여러 개의 서로 다른 논리적 변경이 있는지 판단합니다
6. 여러 개의 서로 다른 변경이 감지되면, 커밋을 여러 개의 작은 커밋으로 분리할 것을 제안합니다
7. 각 커밋(분할하지 않는 경우 단일 커밋)에 대해 이모지 컨벤셔널 커밋 형식으로 커밋 메시지를 생성합니다

커밋 모범 사례

• 커밋 전 검증: 코드가 린트되었는지, 빌드가 정상인지, 문서가 업데이트되었는지 확인하세요
• 원자적 커밋: 각 커밋은 단일 목적을 위한 관련 변경 사항만 포함해야 합니다
• 큰 변경 분할: 변경 사항이 여러 관심사에 걸쳐 있다면, 별도의 커밋으로 분리하세요
• 컨벤셔널 커밋 형식: <type>: <description> 형식을 사용하며, type은 다음 중 하나입니다:
  • feat: 새로운 기능
  • fix: 버그 수정
  • docs: 문서 변경
  • style: 코드 스타일 변경 (포맷팅 등)
  • refactor: 버그 수정이나 기능 추가가 아닌 코드 변경
  • perf: 성능 개선
  • test: 테스트 추가 또는 수정
  • chore: 빌드 프로세스, 도구 등의 변경
• 현재형, 명령형: 커밋 메시지를 명령어로 작성하세요 (예: "added feature"가 아닌 "add feature")
• 간결한 첫 번째 줄: 첫 번째 줄은 72자 이하로 유지하세요
• 이모지: 각 커밋 타입은 적절한 이모지와 짝을 이룹니다:
  • ✨ feat: 새로운 기능
  • 🐛 fix: 버그 수정
  • 📝 docs: 문서
  • 💄 style: 포맷팅/스타일
  • ♻️ refactor: 코드 리팩토링
  • ⚡️ perf: 성능 개선
  • ✅ test: 테스트
  • 🔧 chore: 도구, 설정
  • 🚀 ci: CI/CD 개선
  • 🗑️ revert: 변경 사항 되돌리기
  • 🧪 test: 실패하는 테스트 추가
  • 🚨 fix: 컴파일러/린터 경고 수정
  • 🔒️ fix: 보안 이슈 수정
  • 👥 chore: 기여자 추가 또는 업데이트
  • 🚚 refactor: 리소스 이동 또는 이름 변경
  • 🏗️ refactor: 아키텍처 변경
  • 🔀 chore: 브랜치 병합
  • 📦️ chore: 컴파일된 파일 또는 패키지 추가/업데이트
  • ➕ chore: 의존성 추가
  • ➖ chore: 의존성 제거
  • 🌱 chore: 시드 파일 추가 또는 업데이트
  • 🧑💻 chore: 개발자 경험 개선
  • 🧵 feat: 멀티스레딩 또는 동시성 관련 코드 추가/업데이트
  • 🔍️ feat: SEO 개선
  • 🏷️ feat: 타입 추가 또는 업데이트
  • 💬 feat: 텍스트 및 리터럴 추가 또는 업데이트
  • 🌐 feat: 국제화 및 현지화
  • 👔 feat: 비즈니스 로직 추가 또는 업데이트
  • 📱 feat: 반응형 디자인 작업
  • 🚸 feat: 사용자 경험 / 사용성 개선
  • 🩹 fix: 중요하지 않은 이슈에 대한 간단한 수정
  • 🥅 fix: 에러 캐치
  • 👽️ fix: 외부 API 변경에 따른 코드 업데이트
  • 🔥 fix: 코드 또는 파일 제거
  • 🎨 style: 코드 구조/형식 개선
  • 🚑️ fix: 긴급 핫픽스
  • 🎉 chore: 프로젝트 시작
  • 🔖 chore: 릴리스/버전 태그
  • 🚧 wip: 진행 중인 작업
  • 💚 fix: CI 빌드 수정
  • 📌 chore: 의존성을 특정 버전으로 고정
  • 👷 ci: CI 빌드 시스템 추가 또는 업데이트
  • 📈 feat: 분석 또는 추적 코드 추가/업데이트
  • ✏️ fix: 오타 수정
  • ⏪️ revert: 변경 사항 되돌리기
  • 📄 chore: 라이선스 추가 또는 업데이트
  • 💥 feat: 호환성을 깨는 변경 도입
  • 🍱 assets: 에셋 추가 또는 업데이트
  • ♿️ feat: 접근성 개선
  • 💡 docs: 소스 코드의 주석 추가 또는 업데이트
  • 🗃️ db: 데이터베이스 관련 변경 수행
  • 🔊 feat: 로그 추가 또는 업데이트
  • 🔇 fix: 로그 제거
  • 🤡 test: 목(mock) 처리
  • 🥚 feat: 이스터 에그 추가 또는 업데이트
  • 🙈 chore: .gitignore 파일 추가 또는 업데이트
  • 📸 test: 스냅샷 추가 또는 업데이트
  • ⚗️ experiment: 실험 수행
  • 🚩 feat: 기능 플래그 추가, 업데이트 또는 제거
  • 💫 ui: 애니메이션 및 트랜지션 추가 또는 업데이트
  • ⚰️ refactor: 사용되지 않는 코드 제거
  • 🦺 feat: 유효성 검사 관련 코드 추가 또는 업데이트
  • ✈️ feat: 오프라인 지원 개선

커밋 분할 가이드라인

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

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

예시

좋은 커밋 메시지:

• ✨ feat: add user authentication system
• 🐛 fix: resolve memory leak in rendering process
• 📝 docs: update API documentation with new endpoints
• ♻️ refactor: simplify error handling logic in parser
• 🚨 fix: resolve linter warnings in component files
• 🧑💻 chore: improve developer tooling setup process
• 👔 feat: implement business logic for transaction validation
• 🩹 fix: address minor styling inconsistency in header
• 🚑️ fix: patch critical security vulnerability in auth flow
• 🎨 style: reorganize component structure for better readability
• 🔥 fix: remove deprecated legacy code
• 🦺 feat: add input validation for user registration form
• 💚 fix: resolve failing CI pipeline tests
• 📈 feat: implement analytics tracking for user engagement
• 🔒️ fix: strengthen authentication password requirements
• ♿️ feat: improve form accessibility for screen readers

커밋 분할 예시:

• 첫 번째 커밋: ✨ feat: add new solc version type definitions
• 두 번째 커밋: 📝 docs: update documentation for new solc versions
• 세 번째 커밋: 🔧 chore: update package.json dependencies
• 네 번째 커밋: 🏷️ feat: add type definitions for new API endpoints
• 다섯 번째 커밋: 🧵 feat: improve concurrency handling in worker threads
• 여섯 번째 커밋: 🚨 fix: resolve linting issues in new code
• 일곱 번째 커밋: ✅ test: add unit tests for new solc version features
• 여덟 번째 커밋: 🔒️ fix: update dependencies with security vulnerabilities

커맨드 옵션

• --no-verify: 사전 커밋 검사(lint, build, generate:docs) 건너뛰기

중요 참고 사항

• 기본적으로 코드 품질을 보장하기 위해 사전 커밋 검사(pnpm lint, pnpm build, pnpm generate:docs)가 실행됩니다
• 이러한 검사가 실패하면, 그래도 커밋을 진행할지 아니면 문제를 먼저 수정할지 묻습니다
• 특정 파일이 이미 스테이징되어 있으면, 해당 파일만 커밋합니다
• 스테이징된 파일이 없으면, 수정 및 신규 파일을 모두 자동으로 스테이징합니다
• 커밋 메시지는 감지된 변경 사항을 기반으로 구성됩니다
• 커밋하기 전에, diff를 검토하여 여러 커밋이 더 적절한지 확인합니다
• 여러 커밋을 제안하는 경우, 변경 사항을 별도로 스테이징하고 커밋하는 것을 도와줍니다
• 커밋 메시지가 변경 사항과 일치하는지 항상 커밋 diff를 검토합니다