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

0.5. 팀 워크플로우 최신화 확인

.claude/workflow-version.json이 존재하지 않으면 이 단계를 건너뛴다 (팀 프로젝트가 아닌 경우).

# 로컬 설정 읽기
GITEA_URL=$(python3 -c "import json; print(json.load(open('.claude/workflow-version.json')).get('gitea_url', 'https://gitea.gc-si.dev'))" 2>/dev/null)
PROJECT_TYPE=$(python3 -c "import json; print(json.load(open('.claude/workflow-version.json')).get('project_type', ''))" 2>/dev/null)
CUSTOM_PRECOMMIT=$(python3 -c "import json; print(json.load(open('.claude/workflow-version.json')).get('custom_pre_commit', False))" 2>/dev/null)

# 서버 해시 조회 (custom_pre_commit이면 pre-commit 제외 해시 사용)
SERVER_VER=$(curl -sf --max-time 5 "${GITEA_URL}/gc/template-common/raw/branch/develop/workflow-version.json")
if [ "$CUSTOM_PRECOMMIT" = "True" ]; then
  SERVER_HASH=$(echo "$SERVER_VER" | python3 -c "import sys,json; print(json.load(sys.stdin).get('content_hashes_custom_precommit',{}).get('${PROJECT_TYPE}',''))" 2>/dev/null)
else
  SERVER_HASH=$(echo "$SERVER_VER" | python3 -c "import sys,json; print(json.load(sys.stdin).get('content_hashes',{}).get('${PROJECT_TYPE}',''))" 2>/dev/null)
fi

# 로컬 해시 계산 (custom_pre_commit이면 .githooks/pre-commit 제외)
if [ "$CUSTOM_PRECOMMIT" = "True" ]; then
  LOCAL_HASH=$(find .claude/rules .claude/agents .claude/scripts .githooks \
    .claude/skills/push .claude/skills/mr .claude/skills/create-mr \
    .claude/skills/release .claude/skills/version .claude/skills/fix-issue \
    -type f ! -path '.githooks/pre-commit' 2>/dev/null | sort | xargs cat 2>/dev/null | shasum -a 256 | cut -d' ' -f1)
else
  LOCAL_HASH=$(find .claude/rules .claude/agents .claude/scripts .githooks \
    .claude/skills/push .claude/skills/mr .claude/skills/create-mr \
    .claude/skills/release .claude/skills/version .claude/skills/fix-issue \
    -type f 2>/dev/null | sort | xargs cat 2>/dev/null | shasum -a 256 | cut -d' ' -f1)
fi

비교 결과 처리:

• 서버 조회 실패 (SERVER_HASH 비어있음): "⚠️ 서버 연결 불가, 워크플로우 체크를 건너뜁니다" 경고 후 다음 단계 진행
• 일치 (LOCAL_HASH == SERVER_HASH): 다음 단계 진행
• 불일치: "⚠️ 팀 워크플로우가 최신이 아닙니다. 동기화를 실행합니다..." 출력 → sync-team-workflow 절차를 자동 실행 → 완료 후 원래 작업 계속

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. PR 승인 + 머지 (선택)

사용자 확인 (AskUserQuestion):

• 질문: "MR을 어떻게 처리하시겠습니까?"
• 옵션 1: 리뷰 대기 (추천) — MR만 생성, 리뷰어 지정 후 수동 머지
• 옵션 2: 승인 + 머지 — claude-bot으로 즉시 승인하고 머지

승인 + 머지 선택 시:

# CLAUDE_BOT_TOKEN 확인
if [ -z "$CLAUDE_BOT_TOKEN" ]; then
  echo "CLAUDE_BOT_TOKEN이 설정되지 않아 자동 승인이 불가합니다. MR만 생성합니다."
  # MR URL 출력 후 종료
fi

# 1. claude-bot이 PR 리뷰 승인
curl -X POST "https://{host}/api/v1/repos/{owner}/{repo}/pulls/{pr_number}/reviews" \
  -H "Authorization: token ${CLAUDE_BOT_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"event": "APPROVED", "body": "MR 승인 (via /mr skill)"}'

# 2. 머지 실행
curl -X POST "https://{host}/api/v1/repos/{owner}/{repo}/pulls/{pr_number}/merge" \
  -H "Authorization: token ${GITEA_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"Do": "merge", "merge_message_field": "MR 제목", "delete_branch_after_merge": true}'

⚠️ delete_branch_after_merge: true — feature 브랜치는 머지 후 삭제한다 (develop/main과 달리).

8. 결과 출력

승인 + 머지한 경우:

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

리뷰 대기 선택 시:

✅ 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에서 생성하세요" 안내
• CLAUDE_BOT_TOKEN: claude-bot PR 승인용 토큰 (선택, 없으면 자동 승인 건너뜀)

기존 /create-mr과의 차이

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