변경 사항 승격 (Promote Changes)
현재 작업 상태에서 메인 브랜치의 태그된 GitHub 릴리스까지 전체 릴리스 워크플로우를 실행합니다.
현재 브랜치: !git branch --show-current 2>/dev/null || echo "unknown"
Git 상태: !git status --short 2>/dev/null || echo "not a git repo"
마지막 태그: !git describe --tags --abbrev=0 2>/dev/null || echo "none"
마지막 태그 이후의 최근 커밋:
!`git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --oneline -10 2>/dev/null || git log --oneline -10`
다음 버전 (위 커밋에서 계산):
!`(last=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0"); IFS='.' read -r ma mi pa <<< "${last#v}"; log=$(git log "${last}..HEAD" --format="%s" 2>/dev/null); if echo "$log" | grep -qE "^[a-z]+(\([^)]+\))?!:"; then echo "v$((ma+1)).0.0"; elif echo "$log" | grep -qE "^feat"; then echo "v${ma}.$((mi+1)).0"; else echo "v${ma}.${mi}.$((pa+1))"; fi)`
0단계: 사전 비행 점검
gh auth status 2>&1 || { echo "ERROR: gh is not authenticated. Run: gh auth login"; exit 1; }
실수로 스테이징될 수 있는 추적되지 않은 .env 파일 확인:
git status --short | grep -E '^\?\? .*\.env' && echo "WARNING: untracked .env files detected — review before staging"
cat .gitignore 2>/dev/null | grep -q '\.env' || echo "WARNING: .gitignore does not exclude .env files"
만약 .env 파일이 스테이징될 경우:
if [ -t 0 ]; then
# 대화형 모드 — 계속 진행하기 전에 확인 요청
read -p "WARNING: .env files detected. Continue? (y/N) " confirm
[[ "$confirm" =~ ^[Yy]$ ]] || { echo "Aborted."; exit 1; }
else
# 비대화형 모드 — 사람의 검토 없이 진행하기에는 너무 위험함
echo "ERROR: untracked .env files detected in non-interactive mode. Aborting."
exit 1
fi
1단계: 커밋되지 않은 변경 사항 커밋
위 Git 상태에 커밋되지 않았거나 추적되지 않은 변경 사항이 있는 경우:
- 차이점 검토:
git diff및git diff --cached - 변경 사항을 선택적으로 스테이징 — 추적된 파일 선호:
git add -u, 그런 다음 검토하고 의도적인 새 파일만 개별적으로 추가. 사용자가 명시적으로 확인하지 않는 한git add -A는 피하세요. - 변경 사항에서 컨벤셔널 커밋 메시지 초안 작성 — 유형 접두사(
feat:,fix:,docs:,chore:등)와 간결한 요약으로 시작 - 여러 줄 메시지가 올바르게 포맷되도록 heredoc을 사용하여 커밋
커밋되지 않은 항목이 없으면 2단계로 건너뜁니다.
2단계: 푸시
현재 브랜치를 원격으로 푸시:
git push -u origin HEAD
3단계: 메인 브랜치에 병합 (기능 브랜치만 해당)
이미 main(또는 저장소의 기본 브랜치)에 있으면 이 단계를 건너뜁니다.
기능 브랜치에 있는 경우:
-
마지막 태그 이후의 커밋에서 이슈 참조 스캔:
git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --format="%B"Closes #N,Fixes #N,Resolves #N(대소문자 구분 없음)을 찾습니다. 발견된 모든 이슈 번호를 수집합니다. 발견된 것이 없으면:if [ -t 0 ]; then # 대화형 모드 — 사용자에게 질문 read -p "Any GitHub issues this resolves? (e.g. 12 15 — or enter to skip) " issues else # 비대화형 모드 — 조용히 건너뜀 issues="" fi -
메인 브랜치를 대상으로 하는 PR 생성, 병합 시 GitHub가 이슈를 자동으로 닫도록 본문에 종료 키워드 포함:
gh pr create --title "<type>: <summary>" --body "$(cat <<'EOF' ## Summary <bullet points from commits> Closes #N, Closes #N 🤖 Generated with [claude-workflow-skills:promote](https://github.com/ali5ter/claude-workflow-skills) on behalf of [Alister](https://github.com/ali5ter) EOF )"식별된 이슈가 없으면
Closes줄을 생략합니다. -
자동 병합 활성화 (스쿼시 선호):
gh pr merge --auto --squash -
병합될 때까지 폴링:
gh pr view --json state --jq '.state' -
메인 브랜치로 전환하고 풀:
git checkout main && git pull
4단계: 다음 버전 확인
다음 버전은 위의 컨텍스트 블록에서 다음 시맨틱 버저닝 규칙을 사용하여 미리 계산됩니다:
- 커밋 제목에
!:가 포함된 경우 (예:feat!:,fix!:) → major 증가 feat로 시작하는 커밋 제목 → minor 증가- 그 외 모든 커밋 → patch 증가
계산된 버전이 커밋 목록을 고려하여 올바른지 확인합니다. 이전 태그가 없으면 v1.0.0을 사용합니다. 계산된 버전이 명백히 잘못된 경우에만 재정의합니다 (예: 인젝션이 오류를 반환했거나 출력이 비어 있는 경우).
5단계: 플러그인 매니페스트 동기화 (있는 경우)
.claude-plugin/plugin.json이 존재하는 경우 version 필드를 <next-version>으로 업데이트합니다 (v 접두사 없음 — 플러그인 매니페스트는 1.2.3과 같은 bare semver를 사용함):
node -e "
const fs = require('fs');
const f = '.claude-plugin/plugin.json';
const d = JSON.parse(fs.readFileSync(f, 'utf8'));
d.version = '<next-version>';
fs.writeFileSync(f, JSON.stringify(d, null, 2) + '\n');
"
그런 다음 커밋하고 푸시:
git add .claude-plugin/plugin.json
git commit -m "chore: sync plugin.json version to v<next-version>"
git push
.claude-plugin/plugin.json이 존재하지 않으면 이 단계를 완전히 건너뜁니다.
6단계: 태그 및 릴리스
git tag -a v<next-version> -m "Release v<next-version>"
git push origin v<next-version>
gh release create v<next-version> \
--generate-notes \
--title "v<next-version>"
7단계: 해결된 이슈 닫기 (메인 브랜치만 해당)
3단계에서 PR이 생성된 경우 이 단계를 건너뜁니다 — GitHub는 PR 본문의 Closes #N 키워드를 통해 PR이 병합될 때 이슈를 자동으로 닫습니다.
승격이 메인 브랜치에서 직접 이루어진 경우 (PR 없음), 식별된 이슈를 지금 닫습니다:
gh issue close <N> --comment "Resolved in $(gh release view v<next-version> --json url --jq '.url')"
8단계: 병합된 기능 브랜치 정리
3단계에서 기능 브랜치가 병합된 경우, 로컬 및 원격에서 삭제:
git branch -d <feature-branch>
git push origin --delete <feature-branch>
9단계: 깨끗한 상태 확인
git status
git log --oneline -5
gh release view v<next-version> --json url --jq '.url'의 GitHub 릴리스 URL을 보고합니다.