git-push
Git Flow 브랜치 전략을 준수하며 안전하게 push하는 스킬. "/git-push"를 입력하거나, "푸시해줘", "원격에 올려줘" 같은 요청에 트리거된다. push 전 체크리스트를 확인하고 안전하게 실행한다.
SKILL.md.claude/skills/git-push/SKILL.md
GitHubGit Push
브랜치 전략을 준수하며 안전하게 push하는 스킬이다.
언제 사용하는가
- 로컬 커밋을 원격 저장소에 올릴 때
- "푸시해줘", "원격에 올려줘" 요청 시
동작 흐름
Step 1: 현재 상태 확인
다음 명령을 병렬로 실행한다:
git status # 커밋되지 않은 변경 확인
git branch --show-current # 현재 브랜치
git log --oneline -5 # push할 커밋 확인
git remote -v # 원격 저장소 확인
Step 2: 메인 브랜치 동적 감지 및 규칙 검증
먼저 프로젝트의 메인 브랜치를 감지한다:
git branch -a # main 또는 master 중 실제 존재하는 브랜치 확인
브랜치별 push 규칙
| 브랜치 | 직접 push | 비고 |
|---|---|---|
main/master (메인 브랜치) |
금지 (PR만 허용) | 어떤 이름이든 메인 브랜치는 보호 |
develop (존재하는 경우) |
주의 필요 | feature 브랜치 사용 권장 |
feature/*, feat/* |
허용 | |
release/* |
허용 | |
hotfix/* |
허용 |
경고 상황
- 메인 브랜치 push 시도: "메인 브랜치({name})에 직접 push하면 안 됩니다. PR을 통해 머지해 주세요."
develop브랜치 직접 push: "develop에 직접 push하려고 합니다. feature 브랜치를 만들어서 작업하는 것을 권장합니다. 그래도 push하시겠습니까?"
Step 3: push 전 체크리스트
사용자에게 다음을 확인한다:
push 전 체크리스트:
- 현재 브랜치: feat/login
- push할 커밋: 3개
- abc1234 feat(user): 로그인 기능 추가
- def5678 feat(user): 회원가입 기능 추가
- ghi9012 test(user): 로그인 테스트 추가
- 원격: origin (https://github.com/...)
- 커밋되지 않은 변경: 없음
진행하시겠습니까?
Step 4: push 실행
# 첫 push (원격 브랜치 생성)
git push -u origin {브랜치명}
# 이미 원격 브랜치가 있는 경우
git push origin {브랜치명}
Step 5: 결과 확인
git log --oneline origin/{브랜치명} -5 # 원격에 반영된 커밋 확인
Force Push 안전장치
--force 또는 -f 옵션이 필요한 상황이 발생하면:
- 왜 필요한지 설명: rebase 후, amend 후 등
- 대안 제시:
--force-with-lease사용 권장 (다른 사람의 커밋을 덮어쓰지 않음) - 메인 브랜치 force push 절대 금지:
main/master/develop어느 것이든 요청해도 거부하고 이유를 설명 - 최종 확인: "force push는 원격의 커밋 이력을 덮어씁니다. 정말 실행하시겠습니까?"
# force push가 꼭 필요한 경우 (feature 브랜치만)
git push --force-with-lease origin {브랜치명}
커밋되지 않은 변경이 있을 때
push 전에 커밋되지 않은 변경 사항이 있으면:
커밋되지 않은 변경 사항이 있습니다:
수정됨: src/main/java/com/sample/llm/board/BoardService.java
새 파일: src/main/java/com/sample/llm/board/BoardResponse.java
먼저 커밋하시겠습니까? (/git-commit 사용 가능)
아니면 현재 커밋만 push하시겠습니까?
주의사항
- 메인 브랜치(
main/master)에 직접 push하지 않는다 — PR을 안내한다 --force보다--force-with-lease를 권장한다- push 전 항상 현재 상태와 push할 커밋 목록을 보여준다
- 원격에 같은 브랜치가 없으면
-u플래그로 업스트림을 설정한다