Agent skill

git-commit

프로젝트 커밋 컨벤션에 맞는 커밋 메시지 자동 생성. git diff 분석 후 Conventional Commits 형식으로 생성합니다. Use when committing changes or when the user asks to commit.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/git-commit-jimmy-jung-claude-symbiote

SKILL.md

Git Commit

프로젝트 커밋 컨벤션에 맞는 커밋 메시지를 자동 생성합니다.

참조 룰

Read tool로 읽어 적용: rules/project/project context — 프로젝트별 커밋 형식 (있을 경우)


커밋 타입 표

타입 설명 예시
feat 새로운 기능 feat(auth): add OAuth2 login flow
fix 버그 수정 fix(parser): handle null input gracefully
refactor 동작 변경 없는 코드 변경 refactor(api): extract error handler
docs 문서 변경 docs: update API reference
test 테스트 추가/수정 test(auth): add login unit tests
chore 빌드, 툴링 변경 chore: upgrade dependencies
style 포맷팅, 공백 (로직 변경 없음) style: fix indentation
perf 성능 개선 perf(query): add index on user_id
ci CI 설정 변경 ci: add lint workflow
build 빌드 시스템 변경 build: migrate to new bundler
revert 이전 커밋 되돌리기 revert: undo feat(auth)

Subject 규칙

  • 명령형 어조: add, fix, change (added, fixed, changed 사용 금지)
  • 마침표 없음
  • 50자 이내 권장, 72자 절대 한도
  • type(scope): 뒤 첫 글자는 소문자
  • 간결하되 충분히 설명적

Body 규칙

  • Subject와 본문 사이 빈 줄 필수
  • WHY를 설명 (WHAT은 코드가 보여줌)
  • 72자마다 줄바꿈
  • 관련 이슈/티켓 번호 참조

Footer 규칙

  • BREAKING CHANGE: 호환성 깨짐 설명
  • Closes #issue-number
  • Co-authored-by: Name

Scope 컨벤션

  • 선택 사항, 모듈/기능명 사용 시 권장
  • 예: feat(auth), fix(api), refactor(parser)

Pre-commit 체크

  • 스테이징된 변경 내역 검토 (git diff --cached)
  • 의도치 않은 파일 스테이징 여부 확인
  • 시크릿/자격증명 노출 없음
  • Lint 통과
  • 관련 테스트 통과

6단계 커밋 워크플로우

  1. 스테이징된 변경 검토 (git diff --cached)
  2. 변경 내용에서 타입 결정
  3. scope 식별 (해당 시)
  4. Subject 작성 (명령형, 간결)
  5. 필요 시 Body 작성 (복잡한 변경)
  6. 필요 시 Footer 추가 (breaking change, 이슈 참조)

원자적 커밋 원칙

  • 하나의 논리적 변경당 하나의 커밋
  • 커밋 단위로 독립적으로 이해 가능해야 함
  • PR 전 불필요한 커밋은 squash

메시지 예시 비교

나쁜 예시 좋은 예시
fixed bug fix(auth): handle token expiry
Updated stuff. chore: update dependency to v2.0
WIP (WIP 커밋은 PR 전 squash)
add feat(api): add pagination support
수정함 fix(parser): handle empty input

워크플로우 (에이전트)

Step 1: 변경 사항 수집

Shell로 git status, git diff --staged 실행하여 변경 내용 파악

Step 2: 변경 분석

무엇이, 왜 변경되었는지, 영향 범위 파악

Step 3: 컨벤션 확인

프로젝트 project context에 커밋 컨벤션이 있으면 적용. 없으면 위 기본 컨벤션 적용.

Step 4: 메시지 생성

컨벤션에 맞는 커밋 메시지 생성

Step 5: 사전 검사 (선택)

프로젝트에 pre-commit hook(lint, format)이 있으면 실행

Step 6: 커밋 실행

git commit 수행


안전 사항

  • .env, .env.*, credentials, secrets, *.key 등 민감 정보는 커밋하지 않음
  • 경고 패턴 감지 시 사용자에게 확인 요청

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results