워크플로우
- 저장소 상태 확인:
git status --short, git diff --cached, git diff. 또한 git log --oneline -10을 확인하여 기존 스타일과 일치시킵니다.
- 스테이징된 항목이 없으면, 명시적 경로로 관련 변경 사항을 스테이징합니다(
git add -A는 관련 없거나 민감한 파일이 있을 경우 피합니다). .env, secrets, .venv는 절대 스테이징하지 마세요.
- 변경 사항에 명백히 관련 없는 내용이 포함된 경우, 별도의 커밋으로 분리합니다.
- 아래 형식에 따라 메시지를 작성한 후
git commit으로 커밋합니다.
git status를 실행하여 커밋이 성공했는지 확인합니다.
- 사용자가
--push를 전달한 경우에만 푸시합니다: git push 실행 (업스트림이 설정되지 않은 경우 git push -u origin <branch> 사용). 강제 푸시는 절대 하지 마세요.
메시지 형식
<type>(<optional scope>): <description>
<optional body>
<optional footer>
- 타입:
feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert.
- 설명: 명령형, 소문자, 마침표 없음, 최대 약 72자.
- 범위: 영향을 받는 영역을 나타내는 짧은 명사(예:
cli, server, translate); 모호하면 생략.
- 본문: 이유를 설명하며, 약 72자로 줄바꿈; 사소한 변경 사항은 생략.
- 주요 변경 사항: 타입/범위 뒤에
!를 추가하고 BREAKING CHANGE: 푸터를 포함.
규칙
- 요청하지 않는 한 수정, 리베이스, 또는 히스토리 재작성을 하지 마세요.
- 훅을 건너뛰지 마세요(
--no-verify).
- 훅이 실패하면 문제를 해결하고 새 커밋을 만드세요.
- 변경 사항이 없으면 커밋하지 말고 그렇다고 알리세요.