CLITrigger: Skill for Claude Code

Release

Bump package.json version, commit, and create a git tag for npm release.

Current context

• Current branch: !git branch --show-current
• Working tree status: !git status --short
• Current version: !node -p "require('./package.json').version"
• Recent tags: !git tag --sort=-v:refname | head -5

Instructions

Follow these phases exactly, in order.

---

Phase 1: Validation

1. Branch check: Must be on main (or master). If not, stop and tell the user.

2. Clean working tree: Run git status --porcelain. If there are uncommitted changes, stop and tell the user to commit or stash first.

3. Parse argument:

   • If `` is patch, minor, or major: calculate the next version from the current version using semver rules.
   • If `` is an explicit version (e.g., 1.2.3): use it directly. Validate it's a valid semver string.
   • If `` is empty or not provided: default to patch.

4. Duplicate check: Verify the target version tag (v<version>) does not already exist. If it does, stop and tell the user.

---

Phase 2: Version bump

1. Update package.json: Change the "version" field to the new version.

2. Update package-lock.json: Run npm install --package-lock-only to sync the lockfile version without installing packages.

---

Phase 3: 릴리즈 노트 작성

docs/release-notes/v<new-version>.md에 영어로 릴리즈 노트를 작성한다 (GitHub Release는 영어권 사용자 대상 — 한국어로 쓰지 말 것. 단, 전체 커밋 목록의 커밋 메시지는 원문 그대로 둔다). push 후 GitHub Actions(.github/workflows/release.yml)가 태그 체크아웃 tree에서 이 파일을 읽어 GitHub Release body로 사용한다 (파일이 없으면 자동 PR 인덱스로 폴백).

이 phase에서는 파일만 작성하고 commit하지 않는다. 다음 Phase 4가 release 커밋에 노트 파일을 함께 stage 해서 태그가 노트를 포함한 커밋을 가리키도록 한다.

3-1. 직전 태그 결정

git tag --sort=-v:refname | head -1

• 결과가 비어 있으면 첫 릴리즈로 간주하고 노트 본문에 "초기 릴리즈" 명시. 커밋 범위는 첫 커밋부터 HEAD까지.
• 결과가 있으면 <PREV_TAG> 변수로 사용. Phase 1에서 새 태그 중복 체크가 끝났으므로 항상 새 태그보다 이전.

3-2. 변경 재료 수집

다음 두 가지를 모아 한 번에 본다:

1. 커밋 인덱스:

   git log <PREV_TAG>..HEAD --pretty=format:"%h %s"
   

2. changelog entry 묶음: <PREV_TAG> 커밋의 author date(git log -1 --format=%ad --date=short <PREV_TAG>)부터 오늘까지의 docs/changelog/YYYY-MM/YYYY-MM-DD*.md 파일 모두 읽기.
   • 이미 한국어로 큐레이션된 본문이 있으므로 release 노트는 이걸 영어로 요약/재구성하는 데 집중. 통째 복붙·직역 금지.
   • changelog entry가 0개면(짧은 패치 릴리즈) 커밋 메시지 + 핵심 diff만 보고 직접 작성.