Agent skill
git-commit
프로젝트 커밋 컨벤션에 맞는 커밋 메시지 자동 생성. git diff 분석 후 Conventional Commits 형식으로 생성합니다. Use when committing changes or when the user asks to commit.
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단계 커밋 워크플로우
- 스테이징된 변경 검토 (git diff --cached)
- 변경 내용에서 타입 결정
- scope 식별 (해당 시)
- Subject 작성 (명령형, 간결)
- 필요 시 Body 작성 (복잡한 변경)
- 필요 시 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등 민감 정보는 커밋하지 않음- 경고 패턴 감지 시 사용자에게 확인 요청
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?