gc-guide/.claude/skills/mr/SKILL.md

name	description	user-invokable	argument-hint
mr	커밋 + 푸시 + Gitea MR을 한 번에 생성합니다	true	[target-branch: develop|main] (기본: develop)

현재 브랜치의 변경 사항을 커밋+푸시하고, Gitea에 MR을 생성합니다. 타겟 브랜치: $ARGUMENTS (기본: develop)

수행 단계

0. 권한 확인

# 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이면: "MR 생성 권한이 필요합니다. 프로젝트 관리자에게 요청하세요." 안내 후 종료

1. 사전 검증

# 현재 브랜치 확인 (main/develop이면 중단)
BRANCH=$(git branch --show-current)

• 현재 브랜치가 main 또는 develop이면: "feature 브랜치에서 실행해주세요" 안내 후 종료

2. 커밋 + 푸시 (변경 사항이 있을 때만)

git status --short

커밋되지 않은 변경이 있으면:

• 변경 범위(파일 목록, 추가/수정/삭제) 요약 표시
• Conventional Commits 형식 커밋 메시지 자동 생성
• 사용자 확인 (AskUserQuestion): 커밋 메시지 수락/수정/취소
• 수락 시: git add -A → git commit → git push

변경이 없으면:

• 이미 커밋된 내용으로 MR 생성 진행
• 리모트에 push되지 않은 커밋이 있으면 git push

3. MR 대상 브랜치 결정

타겟 브랜치 후보를 분석하여 표시:

# develop과의 차이
git log develop..HEAD --oneline 2>/dev/null
# main과의 차이
git log main..HEAD --oneline 2>/dev/null

사용자 확인 (AskUserQuestion):

• 질문: "MR 타겟 브랜치를 선택하세요"
• 옵션 1: develop (추천, N건 커밋 차이)
• 옵션 2: main (N건 커밋 차이)
• 옵션 3: 취소

인자($ARGUMENTS)로 브랜치가 지정되었으면 확인 없이 바로 진행.

4. RELEASE-NOTES.md 갱신 (develop 대상 MR일 때만)

타겟이 develop일 때 릴리즈 노트를 자동 갱신한다.

4-1. 커밋 분석

# develop 대비 현재 브랜치의 커밋 목록 (Conventional Commits 파싱)
git log develop..HEAD --format="%s"

모든 커밋 타입을 타입별 섹션으로 분류:

타입	섹션
feat	추가
fix	수정
refactor, perf	변경
docs	문서
test	테스트
style, chore, ci	기타

• 커밋 메시지에서 이슈 번호를 자동 추출하여 (#번호) 형태로 연결
• 커밋 메시지의 scope는 제거하고, 설명부만 사람이 읽기 좋은 형태로 변환
  • 예: feat(auth): 로그인 검증 로직 추가 → - 로그인 검증 로직 추가

4-2. RELEASE-NOTES.md 갱신

docs/RELEASE-NOTES.md 파일이 없으면 새로 생성:

# Release Notes

이 문서는 [Keep a Changelog](https://keepachangelog.com/ko/1.0.0/) 형식을 따릅니다.

## [Unreleased]

기존 파일이 있으면 [Unreleased] 섹션에 항목을 추가한다. 이미 같은 내용이 있으면 중복 추가하지 않는다.

4-3. 사용자 첨삭 확인

사용자에게 릴리즈 노트 초안을 표시하고 AskUserQuestion으로 확인:

• 질문: "릴리즈 노트 초안입니다. 수정할 내용이 있으면 알려주세요."
• 옵션 1: 이대로 진행 (추천)
• 옵션 2: 수정 (Other 입력)
• 옵션 3: 릴리즈 노트 생략

사용자가 수정 사항을 입력하면 반영 후 커밋. 생략을 선택하면 릴리즈 노트 변경 없이 MR 생성 진행.

4-4. 추가 커밋 + 푸시

릴리즈 노트 변경이 있으면:

git add docs/RELEASE-NOTES.md
git commit -m "docs: 릴리즈 노트 업데이트"
git push

5. MR 정보 구성

# 커밋 목록
git log {target}..HEAD --oneline
# 변경 파일 통계
git diff {target}..HEAD --stat

• 제목: 커밋이 1개면 커밋 메시지 사용, 여러 개면 브랜치명에서 추출
  • feature/ISSUE-42-user-login → feat: ISSUE-42 user-login
  • bugfix/fix-timeout → fix: fix-timeout
• 본문:

  ## 변경 사항
  - (커밋 목록 기반 자동 생성)
  
  ## 관련 이슈
  - closes #이슈번호 (브랜치명에서 추출, 없으면 생략)
  
  ## 테스트
  - [ ] 빌드 성공 확인
  - [ ] 기존 테스트 통과
  

6. Gitea API로 MR 생성

curl -X POST "https://{host}/api/v1/repos/{owner}/{repo}/pulls" \
  -H "Authorization: token ${GITEA_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "MR 제목",
    "body": "MR 본문",
    "head": "현재브랜치",
    "base": "타겟브랜치"
  }'

7. 결과 출력

✅ MR 생성 완료
  브랜치: feature/my-branch → develop
  MR: https://gitea.gc-si.dev/gc/my-project/pulls/42
  커밋: 3건, 파일: 5개 변경
  릴리즈 노트: docs/RELEASE-NOTES.md [Unreleased] 갱신됨

  다음 단계: 리뷰어 지정 → 승인 대기 → 머지

필요 환경변수

• GITEA_TOKEN: Gitea API 접근 토큰
  • 없으면: "Gitea 토큰이 필요합니다. Settings → Applications에서 생성하세요" 안내

기존 /create-mr과의 차이

• /mr: 커밋+푸시 + 릴리즈 노트 포함, 빠른 실행 (일상적 사용)
• /create-mr: MR 생성만, 세부 옵션 지원 (상세 제어)