snp-batch-validation/.claude/skills/release/SKILL.md

name	description	user-invokable
release	develop에서 main으로 릴리즈 MR을 생성합니다	true

develop 브랜치와 원격 동기화를 확인하고, 릴리즈 노트를 정리하고, develop → main 릴리즈 MR을 생성합니다. 사용자 승인 시 claude-bot으로 PR 승인 + 머지까지 자동 처리합니다.

수행 단계

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}")
IS_ADMIN=$(echo "$PERMISSIONS" | python3 -c "import sys,json; print(json.load(sys.stdin)['permissions']['admin'])")

• IS_ADMIN이 False이면: "릴리즈는 프로젝트 관리자만 실행할 수 있습니다." 안내 후 종료

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. 사전 검증

• 커밋되지 않은 변경 사항이 있으면 경고 ("먼저 /push로 커밋하세요")

2. develop 브랜치 동기화 확인

git fetch origin
LOCAL=$(git rev-parse develop 2>/dev/null)
REMOTE=$(git rev-parse origin/develop 2>/dev/null)
BASE=$(git merge-base develop origin/develop 2>/dev/null)

상태	조건	행동
동일	LOCAL == REMOTE	바로 진행
로컬 뒤처짐	LOCAL == BASE, LOCAL != REMOTE	"origin/develop에 새 커밋이 있습니다. git pull origin develop 후 다시 시도하세요"
로컬 앞섬	REMOTE == BASE, LOCAL != REMOTE	"push되지 않은 커밋이 있습니다" → 사용자 확인 후 push
분기됨	그 외	"분기되었습니다. 수동으로 해결해주세요"

3. develop → main 차이 분석

git log main..origin/develop --oneline
git diff main..origin/develop --stat
git rev-list --count main..origin/develop

차이가 없으면 "릴리즈할 변경이 없습니다" 출력 후 종료.

4. 미기록 커밋 감지

docs/RELEASE-NOTES.md에 기록되지 않은 커밋이 있는지 확인:

# develop의 커밋 중 RELEASE-NOTES.md에 언급되지 않은 feat/fix 커밋 추출
git log main..origin/develop --format="%s" | grep -E "^(feat|fix|refactor|perf|docs|test|style|chore|ci)"

• 릴리즈 노트의 [Unreleased] + 날짜 릴리즈 항목과 비교
• 미기록 커밋이 있으면 경고 표시 + 보충 기회 제공
  • 사용자에게 미기록 커밋 목록 표시
  • [Unreleased]에 추가할지 확인

5. 이전 날짜 넘버링 릴리즈 압축

docs/RELEASE-NOTES.md에서 오늘 이전 날짜에 넘버링된 릴리즈가 있으면 압축:

[2026-02-28.1] + [2026-02-28.2] → [2026-02-28]

압축 규칙:

• 같은 기능의 반복 수정 → 최종 상태만 유지
• 추가 후 수정된 항목 → "추가" 섹션에 최종 상태로 합침
• 추가 후 제거된 항목 → 양쪽 모두에서 삭제
• 오늘 날짜의 넘버링은 유지 (압축 대상 아님)

6. [Unreleased] → 날짜 버전 전환

## [Unreleased]    →    ## [2026-03-01] 또는 ## [2026-03-01.2]

• 같은 날 이전 릴리즈가 있으면 순번 부여: .1, .2, .3
• [Unreleased]는 빈 섹션으로 다시 생성

7. 사용자 첨삭 확인

최종 릴리즈 노트를 표시하고 AskUserQuestion으로 확인:

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

8. develop 커밋 + 푸시

git checkout develop
git add docs/RELEASE-NOTES.md
git commit -m "docs: 릴리즈 노트 정리 ($(date +%Y-%m-%d))"
git push origin develop

9. MR 정보 구성 + 생성

제목: release: YYYY-MM-DD (N건 커밋)

본문: 릴리즈 노트 내용 포함 (커밋 type별 그룹핑)

curl -X POST "https://{host}/api/v1/repos/{owner}/{repo}/pulls" \
  -H "Authorization: token ${GITEA_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "release: 2026-03-01 (12건 커밋)",
    "body": "릴리즈 본문 (RELEASE-NOTES.md 내용 포함)",
    "head": "develop",
    "base": "main"
  }'

10. PR 승인 + 머지 (선택)

사용자 확인 (AskUserQuestion):

• 질문: "MR을 승인하고 머지하시겠습니까?"
• 옵션 1: 승인 + 머지 (추천)
• 옵션 2: MR만 생성 (수동 리뷰/머지)

승인 + 머지 선택 시:

# 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": "릴리즈 승인 (via /release 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": "release: YYYY-MM-DD", "delete_branch_after_merge": false}'

⚠️ delete_branch_after_merge: false — develop 브랜치는 삭제하지 않는다.

11. 결과 출력

✅ 릴리즈 완료
  브랜치: develop → main
  MR: https://gitea.gc-si.dev/gc/my-project/pulls/50
  커밋: 12건, 파일: 28개 변경
  릴리즈 노트: [2026-03-01] 생성됨
  PR 승인: claude-bot ✅
  머지: 완료 ✅
  CI/CD: 자동 배포 시작됨

  다음 단계: CI/CD 배포 결과 확인

또는 MR만 생성한 경우:

✅ 릴리즈 MR 생성 완료
  브랜치: develop → main
  MR: https://gitea.gc-si.dev/gc/my-project/pulls/50
  릴리즈 노트: [2026-03-01] 생성됨

  다음 단계:
  1. 리뷰어 지정 (main 브랜치는 1명 이상 리뷰 필수)
  2. 승인 후 머지
  3. CI/CD 자동 배포 확인

필요 환경변수

• GITEA_TOKEN: Gitea API 접근 토큰 (필수)
• CLAUDE_BOT_TOKEN: claude-bot PR 승인용 토큰 (선택, 없으면 자동 승인 건너뜀)