메뉴
dooray-cli 새 버전 릴리스 자동화 — 빌드 검증, 버전 범프, git tag, GitHub Release, npm publish, 해결된 이슈 자동 close 순으로 진행. "/release", "릴리스", "버전 범프", "npm publish", "새 버전 배포" 같은 요청 시 반드시 이 스킬 사용.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | release |
| description | dooray-cli 새 버전 릴리스 자동화 — 빌드 검증, 버전 범프, git tag, GitHub Release, npm publish, 해결된 이슈 자동 close 순으로 진행. "/release", "릴리스", "버전 범프", "npm publish", "새 버전 배포" 같은 요청 시 반드시 이 스킬 사용. |
dooray-cli의 새 버전을 릴리스한다.
/release <version> [--notes "릴리스 노트"]
<version>: semver 버전 (예: 0.4.0, 0.3.2)--notes: 릴리스 노트 (생략 시 git log에서 자동 생성)아래 단계를 순서대로 실행한다. 각 단계 실패 시 즉시 중단하고 사용자에게 보고한다.
# 작업 디렉토리가 clean한지 확인
git status --porcelain
# 빌드 성공 확인
pnpm run build
이전 태그 이후 커밋을 모아 사용자에게 변경 요약을 제시한다.
# 직전 태그 식별
LAST_TAG=$(git describe --tags --abbrev=0)
# 커밋 목록
git log --oneline ${LAST_TAG}..HEAD
# 분류용 (feat/fix/refactor/docs/chore)
git log ${LAST_TAG}..HEAD --pretty=format:"%s" | sort
다음을 도출:
feat(commands) 등) — 사용자에게 노출되는 새 명령/서브커맨드feat(...) 메시지에 --xxx 등장) — 기존 명령에 추가된 플래그추가로 해결된 GitHub 이슈를 식별:
# 열린 이슈 목록
gh issue list --state open --json number,title --jq '.[] | "#\(.number) \(.title)"'
# task 디렉토리 / 커밋 메시지 / PR 본문에서 "Issue #N" 또는 "#N" 참조 추출
grep -rE "Issue #[0-9]+|^#[0-9]+" tasks/ 2>/dev/null
git log ${LAST_TAG}..HEAD --grep="#[0-9]" --oneline
각 열린 이슈에 대해 "이번 릴리스로 해결되었는가?" 판단:
feat(... ) follow-up)는 release 시점에 close하지 않음 — 별도 task가 필요결과를 사용자에게 제시하고 close 대상 이슈 목록을 확정. 이 목록은:
Closes #N, #M 으로 기록이 결과는 다음 단계(문서 동기화 검증)와 GitHub Release 노트에 그대로 활용한다.
위에서 식별된 신규 명령/옵션이 있다면, 다음 두 위치에 반영되었는지 확인한다.
# 신규 명령/옵션 키워드를 README.md / skills/dooray-cli/SKILL.md에서 grep
grep -nE "<신규 옵션|신규 명령>" README.md
grep -nE "<신규 옵션|신규 명령>" skills/dooray-cli/SKILL.md
검증 기준:
| 위치 | 무엇을 확인 |
|---|---|
README.md | "사용법" 섹션에 신규 명령/옵션이 등장. 새 명령은 적절한 카테고리(### 업무, ### 멤버 등)에 추가 |
skills/dooray-cli/SKILL.md | AI 에이전트가 사용하는 외부 스킬. 신규 명령/옵션이 명령 카탈로그에 반영되어야 함 |
누락 발견 시:
docs(readme): document <feature> 또는 docs(skill): add <feature> to dooray-cli SKILL.md)버그 수정/리팩토링만 있는 릴리스라면 본 단계는 통과 가능 — 사용자에게 그 사실을 명시하고 진행.
CLAUDE.md "개인 식별 정보 / 사내 식별자 노출 금지 (public OSS)" 섹션의 검증 grep 두 명령을 모두 실행한다.
grep 패턴 정의는 거기에서 단일 소스로 관리 — 본 skill 은 실행 시점과 후속 처리만 정의.
히트가 있으면:
<project> / <tenant> / <postId> 등) 또는 dummy 패턴으로 교체 후 보완 commit사전 가드 (필수): 현재 branch 가 main 인지 확인. PR branch 에서 bump 하면 commit 이 다른 branch 에 박혀 main 미반영 + tag 가 엉뚱한 commit 가리킴.
CURRENT=$(git branch --show-current)
if [ "$CURRENT" != "main" ]; then
echo "⚠ 현재 branch: $CURRENT — main 으로 switch"
git switch main
fi
# main 이어도 항상 origin 과 동기화 — 다른 세션이 PR 을 머지해 로컬이 stale 이면
# bump→push 가 non-fast-forward 로 거부된다 (v0.12.0 release 시 3회 발생).
# fetch + rebase 로 로컬 미push 커밋이 있어도 안전하게 최신 위로 올린다.
git fetch origin
git rebase origin/main
Why fetch+rebase (단순 pull --ff-only 아님): release 직전엔 로컬에 미push 커밋(직전 작업)이 남아 있을 수 있다. pull --ff-only 는 그 경우 실패하지만 fetch + rebase 는 로컬 커밋을 origin 최신 위로 재배치해 통과시킨다.
버전 변경:
package.json의 version 필드를 <version>으로 변경src/index.ts의 .version("x.y.z")를 <version>으로 변경pnpm run build로 빌드 검증# 커밋 직전 branch 재확인 (위 가드와 중복이지만 자기 방어)
[ "$(git branch --show-current)" = "main" ] || { echo "STOP: not on main"; exit 1; }
git add package.json src/index.ts
git commit -m "chore: bump version to v<version>"
git push origin main
복구 — 실수로 PR branch 에 bump commit 박았을 때:
git switch main && git merge <bump-sha> --ff-only && git push origin main. force-push 불요cherry-pick 후 PR branch 의 commit 정리git tag -a v<version> -m "v<version>"
git push origin v<version>
릴리스 노트는 2단계 분석 결과를 그대로 활용해 작성한다 (Highlights / 신규 명령 / 신규 옵션 / 버그 수정 / Closes / Full Changelog 링크).
전달 방식: --notes-file <path> 필수 — 인라인 --notes "..." 또는 quoted heredoc 금지.
# 1. 임시 파일에 본문 작성 (Write 도구 / cat / EDITOR 어느 쪽이든 OK)
# → /tmp/release-v<version>-notes.md
# 2. 파일 경로로 전달
gh release create v<version> --title "v<version> — <요약>" --notes-file /tmp/release-v<version>-notes.md
Why (CLAUDE.md "Markdown 작성 함정" 표):
<<'EOF') 안에서는 `·$·\ 모두 이미 비활성화 → escape 불요\` / \$ 박으면 backslash 가 리터럴로 본문에 남아 markdown 깨짐 (v0.10.0 release 사고 — backtick 66개가 ```로 출력)--notes-file 은 파일 경로 전달이라 shell quoting / escape 함정 자체 회피자가 점검 — release create / edit 직후:
gh release view v<version> --json body -q .body | tr -cd '\\' | wc -c
# 기대: 0 (backslash 잔재 없음)
0 이 아니면 --notes-file 로 즉시 gh release edit v<version> --notes-file <path> 재발행.
릴리스 노트 본문 마지막에 다음 섹션을 포함:
## Closes
이번 릴리스로 해결된 이슈 (release publish 후 자동 close):
- #16 feat(post): post-id/URL 입력 지원
- #17 feat(member): 표시명 resolve
- #18 feat(post create): mandatory-tag 옵션
자동 생성으로 대체할 경우:
gh release create v<version> --title "v<version>" --generate-notes
npm publish는 2FA OTP가 필요하므로 사용자에게 직접 실행을 요청한다:
npm publish --access public --otp=<code>
사용자에게 위 명령을 안내하고, 완료 후 결과를 확인한다.
https://github.com/jon890/dooray-cli/releases/tag/v<version> 릴리스 확인https://www.npmjs.com/package/@bifos/dooray-cli 버전 확인 (반영에 수 분 소요)2단계에서 식별한 close 대상 이슈를 일괄 close. release publish 완료 후에만 실행 (publish 실패 시 close 금지).
RELEASE_URL="https://github.com/jon890/dooray-cli/releases/tag/v<version>"
for n in <이슈번호 목록>; do
gh issue close $n --comment "v<version>에서 구현 완료되어 close합니다. ${RELEASE_URL}"
done
각 close에 release 링크 코멘트 첨부 — 이슈에서 release notes로 즉시 이동 가능.
close 금지 케이스: