htlee
72a7655aa5
- Claude Code 활용 가이드 신규 추가 (스킬 8종 + 에이전트 3종) - 릴리즈 관리 가이드 신규 추가 (2계층 릴리즈 노트) - 초기 환경 설정에 GITEA_TOKEN 설정 섹션 추가 - Git 워크플로우에 /push, /mr 스킬 추천 보강 - 프로젝트 시작하기 템플릿 파일 구조 v1.5.0 업데이트 - chat 봇 연동/디자인 시스템 섹션 임시 주석처리 - 팀 워크플로우 v1.5.0 동기화 (스킬, 에이전트, 규칙)
112 lines
3.3 KiB
Markdown
112 lines
3.3 KiB
Markdown
---
|
|
name: push
|
|
description: 변경 사항을 확인하고 커밋 + 푸시합니다
|
|
user-invokable: true
|
|
argument-hint: "[commit-message] (생략 시 자동 생성)"
|
|
---
|
|
|
|
현재 브랜치의 변경 사항을 확인하고, 사용자 승인 후 커밋 + 푸시합니다.
|
|
커밋 메시지 인자: $ARGUMENTS (생략 시 변경 내용 기반 자동 생성)
|
|
|
|
## 수행 단계
|
|
|
|
### 0. 권한 확인
|
|
|
|
```bash
|
|
# GITEA_TOKEN 확인
|
|
if [ -z "$GITEA_TOKEN" ]; then
|
|
echo "GITEA_TOKEN이 필요합니다. Gitea → Settings → Applications에서 생성하세요"
|
|
exit 1
|
|
fi
|
|
|
|
# Gitea API로 리포 권한 조회
|
|
REMOTE_URL=$(git remote get-url origin)
|
|
GITEA_HOST=$(echo "$REMOTE_URL" | sed -E 's|^https?://([^/]+)/.*|\1|')
|
|
REPO_PATH=$(echo "$REMOTE_URL" | grep -oE '[^/]+/[^/]+\.git$' | sed 's/.git$//')
|
|
PERMISSIONS=$(curl -sf "https://${GITEA_HOST}/api/v1/repos/${REPO_PATH}" \
|
|
-H "Authorization: token ${GITEA_TOKEN}")
|
|
CAN_PUSH=$(echo "$PERMISSIONS" | python3 -c "import sys,json; print(json.load(sys.stdin)['permissions']['push'])")
|
|
```
|
|
|
|
- `CAN_PUSH`가 `False`이면: "push 권한이 필요합니다. 프로젝트 관리자에게 요청하세요." 안내 후 종료
|
|
|
|
### 1. 현재 상태 수집
|
|
|
|
```bash
|
|
# 현재 브랜치
|
|
git branch --show-current
|
|
|
|
# 커밋되지 않은 변경 사항
|
|
git status --short
|
|
|
|
# 변경 통계
|
|
git diff --stat
|
|
git diff --cached --stat
|
|
```
|
|
|
|
### 2. 변경 범위 표시
|
|
|
|
사용자에게 다음 정보를 **표 형태**로 요약하여 보여준다:
|
|
|
|
- 현재 브랜치명
|
|
- 변경된 파일 목록 (추가/수정/삭제 구분)
|
|
- staged vs unstaged 구분
|
|
- 변경 라인 수 요약
|
|
|
|
변경 사항이 없으면 "커밋할 변경 사항이 없습니다" 출력 후 종료.
|
|
|
|
### 3. 커밋 메시지 결정
|
|
|
|
**인자가 있는 경우** ($ARGUMENTS가 비어있지 않으면):
|
|
- 전달받은 메시지를 커밋 메시지로 사용
|
|
- Conventional Commits 형식인지 검증 (아니면 자동 보정 제안)
|
|
|
|
**인자가 없는 경우**:
|
|
- 변경 내용을 분석하여 Conventional Commits 형식 메시지 자동 생성
|
|
- 형식: `type(scope): 한국어 설명`
|
|
- type 판단 기준:
|
|
- 새 파일 추가 → `feat`
|
|
- 기존 파일 수정 → `fix` 또는 `refactor`
|
|
- 테스트 파일 → `test`
|
|
- 설정/빌드 파일 → `chore`
|
|
- 문서 파일 → `docs`
|
|
|
|
### 4. 사용자 확인
|
|
|
|
AskUserQuestion으로 다음을 확인:
|
|
|
|
**질문**: "다음 내용으로 커밋하시겠습니까?"
|
|
- 옵션 1: 제안된 메시지로 커밋 (추천)
|
|
- 옵션 2: 메시지 수정 (Other 입력)
|
|
- 옵션 3: 취소
|
|
|
|
### 5. 커밋 + 푸시 실행
|
|
|
|
사용자가 수락하면:
|
|
|
|
```bash
|
|
# 모든 변경 사항 스테이징 (untracked 포함)
|
|
# 단, .env, secrets/ 등 민감 파일은 제외
|
|
git add -A
|
|
|
|
# 커밋 (.githooks/commit-msg가 형식 검증)
|
|
git commit -m "커밋메시지"
|
|
|
|
# 푸시 (리모트 트래킹 없으면 -u 추가)
|
|
git push origin $(git branch --show-current)
|
|
```
|
|
|
|
**주의사항**:
|
|
- `git add` 전에 `.env`, `*.key`, `secrets/` 등 민감 파일이 포함되어 있으면 경고
|
|
- pre-commit hook 실패 시 에러 메시지 표시 후 수동 해결 안내
|
|
- 리모트에 브랜치가 없으면 `git push -u origin {branch}` 사용
|
|
|
|
### 6. 결과 출력
|
|
|
|
```
|
|
✅ 푸시 완료
|
|
브랜치: feature/my-branch
|
|
커밋: abc1234 feat(auth): 로그인 검증 로직 추가
|
|
변경: 3 files changed, 45 insertions(+), 12 deletions(-)
|
|
```
|