deploy-npm

SEMO npm 패키지 배포. Use when (1) "npm 배포", "패키지 배포해줘",(2) CLI/MCP 변경 후 배포, (3) "버전 올리고 배포".

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026⬇️3downloads

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.
namedeploy-npm
description|
tools[Bash, Read, mcp__semo-integrations__slack_send_message]
modelinherit

시스템 메시지: [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 권한