publish (릴리스 배포 매니저)
버전 범프 타입만 알려주면 GitHub Actions 배포 워크플로우 실행부터 릴리스 노트 작성, Discord 공지, npm 검증까지 끝까지 몰아주는 릴리스 매니저 스킬.
자동화·워크플로고급★ 67,531⑂ 5,507AI 점수 6/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
publish 스킬은 Claude를 "릴리스 매니저"로 만들어, 배포 과정에서 사람이 빠뜨리기 쉬운 단계를 강제로 끝까지 수행하게 합니다.
- 인자 검증:
patch/minor/major중 하나를 반드시 받고, 없으면 즉시 질문하고 멈춤 - 사전 점검: 커밋되지 않은 변경 확인,
git pull --rebase && git push로 원격 동기화 - 워크플로우 트리거:
gh workflow run publish -f bump=<type>실행 후 run ID 확보 - 진행 폴링: sleep 대신 30초 간격 폴링으로 잡 단계(test → prepare-release-state → publish-platform → publish-main)를 사용자에게 보고
- 릴리스 노트 강화: 자동 생성 커밋 로그 위에 "사용자 임팩트 중심" 요약을 덧붙이되, 기존 내용은 한 글자도 지우지 않는 prepend 정책
- 완료 계약: 워크플로우 성공, 릴리스 존재, 요약 적용, Discord 공지, npm 버전 확인 5가지가 모두 확인되기 전에는 턴을 끝내지 못하게 명문화
- 플랫폼 패키지 스팟 체크: darwin-arm64 / linux-x64 / windows-x64 등 바이너리 패키지 버전 확인
또한 배포 중에 코드 리뷰나 수리 루프에 빠지지 말라는 "ship-only" 원칙이 강하게 명시되어 있습니다.
이런 분께 추천
- npm 패키지를 GitHub Actions로 배포하며, 릴리스 노트·공지까지 매번 수동으로 챙기는 메인테이너
- 에이전트가 배포 도중 턴을 끊거나 절차를 건너뛰어 곤란했던 경험이 있는 분
- 배포 절차를 문서화해 팀 내 표준으로 만들고 싶은 오픈소스 운영자
- 반대로, 배포 파이프라인이 아직 없거나 수동
npm publish만 쓰는 프로젝트에는 과합니다
활용 예시
- 패치 릴리스: "publish patch" → 스킬이 TODO 목록을 만들고, 워크플로우를 트리거한 뒤 CI가 도는 동안 버그 수정 요약을 초안 작성, 릴리스 노트 상단에 붙이고 Discord 공지 후
npm view로 버전 확인까지 완료. - 마이너 기능 릴리스: "release minor" → 커밋 로그를 테마별(예: "⚡ 규칙 파싱 3배 빨라짐")로 묶어 제품 공지문 스타일 요약을 만들고, 자동 생성 changelog 위에 prepend.
- 실패 대응: 워크플로우가 실패하면
gh run view --log-failed로 실패 로그를 보여주고, 코드를 임의로 고치지 않고 즉시 중단해 사람에게 판단을 넘김.
주의: 스크립트에 실제 저장소 이름, Discord 채널 ID, 봇 ID가 그대로 들어 있어 자기 프로젝트에 맞게 반드시 치환해야 합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 code-yeongyu/oh-my-openagent 의 .agents/skills/publish 폴더를 내 ~/.claude/skills/publish/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/code-yeongyu/oh-my-openagent.git /tmp/oh-my-openagent && mkdir -p ~/.claude/skills/publish && cp /tmp/oh-my-openagent/.agents/skills/publish/SKILL.md ~/.claude/skills/publish/SKILL.md⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 작업용 디렉터리로 이동합니다.
- 저장소를 클론합니다:
git clone https://github.com/code-yeongyu/oh-my-openagent.git - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills/publish - 스킬 파일을 복사합니다:
cp oh-my-openagent/.agents/skills/publish/SKILL.md ~/.claude/skills/publish/SKILL.md - 복사한
SKILL.md를 열어 패키지 이름, 저장소 경로, Discord 채널/봇 ID, 워크플로우 이름을 내 프로젝트 값으로 수정합니다. - 사전 조건을 준비합니다:
gh auth login(GitHub CLI 인증), npm 배포 권한,publish라는 이름의 GitHub Actions 워크플로우. - Claude Code를 재시작하고
publish patch처럼 범프 타입과 함께 요청합니다. - 처음에는 테스트용 저장소나 dry-run 환경에서 먼저 시험해 실제 배포 사고를 방지하세요.
GitHub에서 원본 보기 ↗라이선스: NOASSERTION