git-push

Git Flow 브랜치 전략을 준수하며 안전하게 push하는 스킬. "/git-push"를 입력하거나, "푸시해줘", "원격에 올려줘" 같은 요청에 트리거된다. push 전 체크리스트를 확인하고 안전하게 실행한다.

SKILL.md

GitHub

Git 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 옵션이 필요한 상황이 발생하면:

  1. 왜 필요한지 설명: rebase 후, amend 후 등
  2. 대안 제시: --force-with-lease 사용 권장 (다른 사람의 커밋을 덮어쓰지 않음)
  3. 메인 브랜치 force push 절대 금지: main/master/develop 어느 것이든 요청해도 거부하고 이유를 설명
  4. 최종 확인: "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 플래그로 업스트림을 설정한다