القائمة
CHANGELOG.md에 변경 사항과 담당자를 정리하고 package.json 버전을 올립니다. changelog 작성, 변경 이력 정리, 버전 올리기, 릴리즈 노트, CHANGELOG 업데이트 요청 시 사용.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | changelog |
| description | CHANGELOG.md에 변경 사항과 담당자를 정리하고 package.json 버전을 올립니다. changelog 작성, 변경 이력 정리, 버전 올리기, 릴리즈 노트, CHANGELOG 업데이트 요청 시 사용. |
| argument-hint | [버전 유형: patch/minor/major] |
CHANGELOG.md에 변경 사항과 변경 담당자(문의담당자)를 정리하고, package.json 버전을 함께 올립니다.
먼저 모노레포 여부를 확인하고, 대상 패키지를 결정합니다.
# 1. 모노레포 여부 확인 (pnpm-workspace.yaml, lerna.json, workspaces in package.json)
ls pnpm-workspace.yaml lerna.json 2>/dev/null
grep -q '"workspaces"' package.json 2>/dev/null && echo "npm workspaces 사용"
# 2. 패키지 목록 확인 (모노레포인 경우)
ls packages/*/package.json 2>/dev/null
모노레포인 경우: 사용자에게 대상 패키지를 확인합니다.
이후 모든 경로(package.json, CHANGELOG.md)는 해당 패키지 디렉토리 기준으로 사용합니다.
예: packages/cli/package.json, packages/cli/CHANGELOG.md
단일 패키지인 경우: 루트의 package.json, CHANGELOG.md를 사용합니다.
# 3. 현재 버전 확인 (PKG_DIR은 대상 패키지 경로, 단일 패키지면 ".")
PKG_DIR="." # 또는 "packages/cli" 등
grep -m 1 '"version"' $PKG_DIR/package.json
# 4. 최근 태그 이후 커밋 확인 (태그가 없으면 전체 커밋)
git tag --sort=-v:refname | head -1
git log $(git tag --sort=-v:refname | head -1)..HEAD --oneline --no-merges 2>/dev/null || \
git log --oneline --no-merges -20
# 5. 기존 CHANGELOG.md 확인
head -30 $PKG_DIR/CHANGELOG.md 2>/dev/null || echo "CHANGELOG.md 없음 - 새로 생성"
사용자에게 버전 유형을 확인합니다.
| 유형 | 변환 | 사용 시점 |
|---|---|---|
patch | X.Y.Z → X.Y.(Z+1) | 버그 수정, 작은 변경 |
minor | X.Y.Z → X.(Y+1).0 | 기능 추가 (하위 호환) |
major | X.Y.Z → (X+1).0.0 | 대규모 변경 (하위 호환 X) |
커밋 로그를 분석하여 카테고리별로 분류합니다.
커밋 분류 기준:
| 카테고리 | 커밋 타입 | 아이콘 |
|---|---|---|
| 새 기능 | feat | ✨ |
| 버그 수정 | fix | 🐛 |
| 리팩토링 | refactor | ♻️ |
| 문서 | docs | 📝 |
| 스타일 | style | 💄 |
| 테스트 | test | ✅ |
| 빌드/설정 | chore, build, ci | 🔧 |
담당자 추출:
# 커밋별 작성자 확인
git log $(git tag --sort=-v:refname | head -1)..HEAD --format="%s|%an" --no-merges
아래 형식으로 CHANGELOG.md 상단에 새 버전 섹션을 추가합니다.
형식: CHANGELOG 형식 가이드 참조
## [X.Y.Z] - YYYY-MM-DD
### ✨ 새 기능
- 기능 설명 — @담당자
### 🐛 버그 수정
- 수정 내용 — @담당자
### ♻️ 리팩토링
- 변경 내용 — @담당자
작성 규칙:
— @담당자이름 형식으로 문의담당자 표기YYYY-MM-DD (오늘 날짜)# 대상 패키지의 package.json version 필드를 수정
# Edit 도구를 사용하여 "version": "이전버전" → "version": "새버전" 변경
# PKG_DIR: 모노레포면 패키지 경로 (예: packages/cli), 단일이면 "."
변경된 파일을 사용자에게 보여줍니다:
# 변경된 파일 확인
git diff --stat
# CHANGELOG.md 상단 확인
head -30 $PKG_DIR/CHANGELOG.md
CHANGELOG.md가 없거나 비어있으면 아래 헤더로 시작합니다.
파일 위치는 대상 패키지 디렉토리입니다 (모노레포: packages/<name>/CHANGELOG.md, 단일: CHANGELOG.md).
# Changelog
이 프로젝트의 주요 변경 사항을 기록합니다.
형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 기반으로 합니다.
## [X.Y.Z] - YYYY-MM-DD
...