설정
처음 사용 시 setup.md를 읽으세요. 기본값: 모범 사례 모드 (설정 불필요).
사용 시점
사용자에게 Git 전문 지식이 필요할 때 — 기본 작업부터 복잡한 워크플로우까지. 에이전트가 브랜칭, 병합, 리베이스, 충돌 해결 및 팀 협업 패턴을 처리합니다.
아키텍처
메모리는 ~/git/에 저장됩니다. 구조는 memory-template.md를 참조하세요.
~/git/
└── memory.md # 사용자 선호도 (선택 사항)
빠른 참조
| 주제 | 파일 |
|---|---|
| 필수 명령어 | commands.md |
| 고급 작업 | advanced.md |
| 브랜치 전략 | branching.md |
| 충돌 해결 | conflicts.md |
| 히스토리 및 복구 | history.md |
| 팀 워크플로우 | collaboration.md |
| 설정 | setup.md |
| 메모리 | memory-template.md |
핵심 규칙
- 공유 브랜치에 강제 푸시 금지 — 기능 브랜치에서만
--force-with-lease사용 - 자주, 작게 커밋하세요 — 작은 커밋은 리뷰, 되돌리기, 이분 탐색이 더 쉽습니다
- 의미 있는 커밋 메시지 작성 — 첫 줄은 72자 미만, 명령형 어조 사용
- 푸시 전 풀 — 병합 커밋을 피하기 위해 항상
git pull --rebase실행 - 병합 전 정리 —
git rebase -i로 픽스업 커밋을 스쿼시하세요
팀 워크플로우
기능 브랜치 플로우:
- 메인에서
git checkout -b feature/name실행 - 커밋하고 정기적으로 푸시
- PR 열고 리뷰 받기
- 스쿼시 후 메인에 병합
- 기능 브랜치 삭제
핫픽스 플로우:
- 메인에서
git checkout -b hotfix/issue실행 - 수정, 테스트, 커밋
- 메인 AND (존재하는 경우) develop에 병합
- 릴리스 태그 지정
일일 동기화:
git fetch --all --prune
git rebase origin/main # 또는 팀 선호에 따라 병합
커밋 메시지
- 컨벤셔널 커밋 형식 사용:
type(scope): description - 첫 줄은 72자 미만 유지
- 타입:
feat,fix,docs,style,refactor,test,chore
푸시 안전
--force대신git push --force-with-lease사용 — 다른 사람의 작업 덮어쓰기 방지- 푸시가 거부되면 재시도 전
git pull --rebase실행 - main/master 브랜치에 강제 푸시 금지
충돌 해결
- 충돌 파일을 편집한 후 마커가 남지 않았는지 확인:
grep -r "<<<\|>>>\|===" . - 병합 완료 전에 코드가 빌드되는지 테스트
- 병합이 복잡해지면
git merge --abort로 중단하고 대신git rebase시도
브랜치 위생
- 로컬에서 병합된 브랜치 삭제:
git branch -d branch-name - 원격 추적 정리:
git fetch --prune - PR 생성 전, 최신 메인으로 기능 브랜치 리베이스
- 푸시 전
git rebase -i로 지저분한 커밋 스쿼시
안전 점검 목록
파괴적인 작업(reset --hard, rebase, force push) 전:
- 공유 브랜치인가요? → 히스토리 다시 쓰지 않음
- 커밋되지 않은 변경사항이 있나요? → 스태시 또는 먼저 커밋
- 올바른 브랜치에 있나요? →
git branch로 확인 - 원격이 최신인가요? → 먼저
git fetch실행
흔한 함정
- git user.email 잘못됨 — 중요한 커밋 전
git config user.email로 확인 - 빈 디렉토리 — Git이 추적하지 않음,
.gitkeep추가 - 서브모듈 — 항상
--recurse-submodules로 클론 - Detached HEAD —
git switch -로 이전 브랜치로 돌아가기 - 푸시 거부됨 — 보통 먼저
git pull --rebase필요 - 충돌 시 stash pop — 스태시가 사라짐. 대신
stash apply사용 - 대용량 파일 — 50MB 이상 파일은 Git LFS 사용, 비밀 절대 커밋 금지
- 대소문자 구분 — Mac/Windows는 무시, Linux는 구분 — CI 실패 원인
복구 명령어
- 변경사항 유지하며 마지막 커밋 취소:
git reset --soft HEAD~1 - 스테이징되지 않은 변경사항 폐기:
git restore filename - 손실된 커밋 찾기:
git reflog(약 90일 히스토리 보관) - 삭제된 브랜치 복구:
git checkout -b branch-name <sha-from-reflog> - 여러 변경사항이 섞인 커밋 시 부분 스테이징을 위해
git add -p사용
바이섹트를 통한 디버깅
버그를 도입한 커밋 찾기:
git bisect start
git bisect bad # 현재 커밋이 깨짐
git bisect good v1.0.0 # 이 버전은 정상 작동
# Git이 중간 커밋을 체크아웃, 테스트 후:
git bisect good # 또는 git bisect bad
# Git이 범인을 찾을 때까지 반복
git bisect reset # 원래 브랜치로 복귀
빠른 요약
git status -sb # 브랜치와 함께 간단한 상태
git log --oneline -5 # 최근 5개 커밋
git shortlog -sn # 커밋 수별 기여자
git diff --stat HEAD~5 # 최근 5개 커밋 변경 요약
git branch -vv # 추적 정보를 포함한 브랜치
git stash list # 대기 중인 스태시
관련 스킬
사용자 확인 시 clawhub install <slug>로 설치:
gitlab— GitLab CI/CD 및 병합 요청docker— 컨테이너화 워크플로우code— 코드 품질 및 모범 사례
피드백
- 유용하다면:
clawhub star git - 최신 상태 유지:
clawhub sync