deploy-npm
SEMO npm 패키지 배포. Use when (1) "npm 배포", "패키지 배포해줘",(2) CLI/MCP 변경 후 배포, (3) "버전 올리고 배포".
When & Why to Use This Skill
This Claude skill automates the end-to-end deployment workflow for SEMO npm packages, specifically targeting CLI and MCP servers. It streamlines the entire release process—from version bumping and building to Git synchronization and npm publishing—while providing real-time status updates via Slack to ensure a seamless and error-free delivery pipeline.
Use Cases
- Automating the release of @team-semicolon/semo-cli and @team-semicolon/semo-mcp packages after code changes.
- Executing standardized version increments (patch, minor, major) and generating consistent Git tags for release tracking.
- Managing complex multi-step deployment sequences including building assets, committing changes, and pushing to remote repositories.
- Integrating automated Slack notifications to keep the development team informed about successful package updates and version details.
| name | deploy-npm |
|---|---|
| description | | |
| tools | [Bash, Read, mcp__semo-integrations__slack_send_message] |
| model | inherit |
시스템 메시지:
[SEMO] Skill: deploy-npm 호출
deploy-npm Skill
SEMO npm 패키지 (@team-semicolon/semo-cli, @team-semicolon/semo-mcp) 배포 자동화
Purpose
Meta 환경에서 CLI 또는 MCP 서버 변경 후 npm 레지스트리에 배포합니다. Git commit/push, Slack 알림까지 포함된 End-to-End 배포 워크플로우입니다.
배포 대상 패키지
| 패키지 | npm 이름 | 경로 |
|---|---|---|
| CLI | @team-semicolon/semo-cli | packages/cli |
| MCP | @team-semicolon/semo-mcp | packages/mcp-server |
Full Workflow (End-to-End)
[SEMO] deploy-npm 스킬 실행
├─ 1. Pre-check: 변경사항 확인 (git status)
├─ 2. Version bump: 버전 업데이트
├─ 3. Build: npm run build
├─ 4. Commit: git commit
├─ 5. Push: git push origin main
├─ 6. Publish: npm publish
├─ 7. Tag: git tag & push
└─ 8. Notify: Slack 알림
Step 1: Pre-check (변경사항 확인)
# 작업 디렉토리 상태 확인
git status
# CLI 변경 확인
git diff --name-only HEAD~1 | grep -q "packages/cli" && echo "CLI 변경됨"
# MCP 변경 확인
git diff --name-only HEAD~1 | grep -q "packages/mcp-server" && echo "MCP 변경됨"
Step 2: 버전 범프
# packages/cli/
cd packages/cli
npm version patch # or minor/major
# packages/mcp-server/
cd packages/mcp-server
npm version patch # or minor/major
Step 3: 빌드
# CLI 빌드
cd packages/cli && npm run build
# MCP 빌드
cd packages/mcp-server && npm run build
Step 4: Git Commit
# 변경사항 스테이징
git add packages/cli/package.json packages/cli/dist/
# 커밋 (버전 포함)
git commit -m "chore(cli): bump version to $(cat packages/cli/package.json | jq -r .version)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"
Step 5: Git Push
git push origin main
Step 6: npm 배포
# CLI 배포
cd packages/cli && npm publish --access public
# MCP 배포
cd packages/mcp-server && npm publish --access public
Step 7: Git 태그
# 태그 생성
git tag -a "cli-v$(cat packages/cli/package.json | jq -r .version)" -m "CLI release"
git tag -a "mcp-v$(cat packages/mcp-server/package.json | jq -r .version)" -m "MCP release"
git push origin --tags
Step 8: Slack 알림 (MCP Tool 사용)
배포 완료 후 mcp__semo-integrations__slack_send_message 도구를 사용하여 알림을 보냅니다.
알림 메시지 형식:
🚀 SEMO 패키지 배포 완료
📦 @team-semicolon/semo-cli v{version}
- 변경사항: {변경 요약}
- npm: https://www.npmjs.com/package/@team-semicolon/semo-cli
✅ 배포 시간: {timestamp}
도구 호출 예시:
mcp__semo-integrations__slack_send_message
- text: "🚀 SEMO CLI v3.0.3 배포 완료\n\n변경사항:\n- update 명령어 개선\n\nnpm: https://www.npmjs.com/package/@team-semicolon/semo-cli"
Version Bump Rules
| 변경 유형 | 버전 범프 | 예시 |
|---|---|---|
| 버그 수정, 문서 수정 | patch | 1.0.0 → 1.0.1 |
| 새 기능 추가 | minor | 1.0.0 → 1.1.0 |
| Breaking Change | major | 1.0.0 → 2.0.0 |
Output Format
[SEMO] Skill: deploy-npm 호출
## npm 배포 결과
| 패키지 | 이전 버전 | 새 버전 | 상태 |
|--------|----------|--------|------|
| @team-semicolon/semo-cli | 3.0.0 | 3.0.1 | ✅ 배포 완료 |
| @team-semicolon/semo-mcp | 1.2.0 | - | ⏭️ 변경 없음 |
### 배포 로그
\`\`\`
npm notice package size: 12.5 kB
npm notice total files: 8
+ @team-semicolon/semo-cli@3.0.1
\`\`\`
[SEMO] Skill: deploy-npm 완료
Error Handling
npm 인증 오류
❌ npm 인증 실패
**해결 방법**:
\`\`\`bash
npm login --registry=https://registry.npmjs.org/
\`\`\`
버전 충돌
❌ 버전 충돌: 3.0.1 이미 존재
**해결 방법**:
\`\`\`bash
npm version patch # 다음 버전으로 범프
\`\`\`
Pre-requisites
- npm 로그인 상태 (
npm whoami) - @team-semicolon 조직 publish 권한
Related
- version-manager - 버저닝 자동화
- package-sync - 로컬 동기화