Optimization convention-commit
Git commit 메시지 작성 전 Conventional Commits 형식 확인이 필요할 때. 브랜치 전략, commit 타입, 스코프 선택이 불명확할 때. "/convention-commit quick"으로 빠른 참조.
install
source · Clone the upstream repo
git clone https://github.com/sunLeee/optimization
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/sunLeee/optimization "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/process/commit" ~/.claude/skills/sunleee-optimization-convention-commit && rm -rf "$T"
manifest:
.claude/skills/process/commit/SKILL.mdsource content
convention-commit
Git commit 및 브랜치 컨벤션.
형식
type(scope): subject ← 50자 이내
주요 타입
| 타입 | 용도 |
|---|---|
| 새 기능 |
| 버그 수정 |
| 리팩토링 (기능 변화 없음) |
| 문서 수정 |
| 테스트 추가/수정 |
| 빌드, 설정 변경 |
스코프 예시
feat(demand-agent): add zone aggregation tool fix(preprocessing): resolve H3 null cell handling docs(claude): update team-operations AW rules
브랜치 전략
{type}/issue-{number}-{subject} ← kebab-case feat/issue-74-ai-pr-workflow fix/issue-12-zone-id-validation
금지
- Co-Authored-By 푸터 사용 금지
/main
직접 commit 금지master- 50자 초과 제목
Gotchas (실패 포인트)
- 스코프 없음:
→feat: add something
로 스코프 필수feat(demand-agent): add zone tool - 너무 큰 커밋: PR = 설계 결정 하나 (@AW-006). commit도 마찬가지.
- 제목에 마침표:
→ 마침표 제거feat: add tool. - 영어 소문자:
→feat(ADK): Add Tool
로 소문자 시작feat(adk): add tool
빠른 참조
# 마지막 commit 메시지 검증 git log --oneline -1 # Conventional Commits 형식 검증 echo "feat(scope): subject" | grep -E "^(feat|fix|docs|refactor|test|chore|style|perf|ci|build|revert)(\(.+\))?: .{1,50}$"
관련 규칙
- @AW-006 (설계문서 먼저, 코드 PR 전 설계 PR)
- Git Workflow: CLAUDE.md § Git Workflow
- convention-pr — PR 범위 규칙