npm-release

Files (1)

• SKILL.md

SKILL.md (first lines)

# npm Release Automation

npm 패키지 릴리스의 전체 프로세스를 자동화합니다.

## 트리거

- "release", "publish", "npm publish", "릴리스", "퍼블리쉬", "배포"

## 전제 조건 확인

릴리스 전 반드시 아래 항목을 순서대로 확인합니다:

### 1. 프로젝트 유효성

```bash
# package.json 존재 확인
test -f package.json || { echo "ERROR: package.json not found"; exit 1; }

# 현재 버전 확인
node -p "require('./package.json').version"

# 패키지명 확인
node -p "require('./package.json').name"
```

### 2. Git 상태

```bash
# 커밋되지 않은 변경사항 확인
git status --porcelain

# 현재 브랜치 확인 (main/master 권장)
git branch --show-current

# remote와 동기화 확인
git fetch && git status -sb
```

만약 커밋되지 않은 변경사항이 있으면:
- 사용자에게 알리고 커밋 여부 확인
- 릴리스에 포함할 변경사항이면 커밋 후 진행
- 관련 없는 변경이면 stash 후 진행

### 3. 테스트

```bash
npm test
```

테스트 실패 시 릴리스 중단. 사용자에게 알림.

### 4. npm 인증

```bash
npm whoami
```

인증 실패 시 `npm login` 안내.

### 5. 이전 버전 확인

```bash
npm view $(node -p "require('./package.json').name") versions --json 2>/dev/null || echo "[]"
```

## 릴리스 프로세스

### Step 1: 버전 타입 선택

사용자에게 AskUserQuestion으로 질문:

- **patch** (0.0.x) — 버그 수정, 작은 변경
- **minor** (0.x.0) — 새 기능 추가 (하위 호환)
- **major** (x.0.0) — 브레이킹 체인지

사용자가 직접 버전을 지정할 수도 있음 (예: "1.2.3")

### Step 2: 버전 범프 + 커밋 + 태그

```bash
# npm version이 자동으로: package.json 수정 → git commit → git tag v{version}
npm version {patch|minor|major}
```

또는 직접 버전 지정:
```bash
npm version {specific-version}
```

### Step 3: Push (코드 + 태그)

```bash
git push && git push --tags
```

### Step 4: 결과 확인

GitHub Actions release.yml이 설정되어 있는 경우:
- 태그 push로 자동 트리거됨
- test → npm publish → GitHub Release 자동 수행
- Actions 상태 확인:

```bash
gh run list --repo $(git remote get-url origin | sed 's/.*github.com[:/]//' | sed 's/.git$//') --limit 3
```

GitHub Actions가 없는 경우 (수동 publish):
```bash
npm publish --access public
```

### Step 5: 검증

```bash
# npm에서 새 버전 확인
npm view $(node -p "require('./package.json').name") version

# 설치 테스트
npx $(node -p "require('./package.json').name") --help 2>/dev/null || echo "No --help handler"

From dmsdc-ai/aigentry-devkit, MIT.

More from dmsdc-ai/aigentry-devkit