release-notes · diff

git:20260316.42db254 to git:20260416.03661bd

3 added, 0 removed. Audit A to A.

---

name: release-notes

description: >

Conventional Commits 기반 릴리즈 노트 자동 생성. 버전 결정 + CHANGELOG.md + Git 태그 + GitHub Release.

/release로 실행.

triggers:

- "release"

- "릴리즈"

- "release-notes"

- "릴리즈 노트"

- "버전 올려"

- "changelog"

auto_apply: false

---

# Release Notes — 릴리즈 노트 자동화

> Conventional Commits에서 버전을 결정하고, CHANGELOG를 생성하고, 태그를 찍는다.

> `commit-work` 스킬로 커밋한 뒤, 릴리즈할 때 사용.

## Quick Start

```

/release # 자동 버전 결정 + CHANGELOG + 태그

/release patch # patch 버전 강제 (0.1.0 → 0.1.1)

/release minor # minor 버전 강제 (0.1.0 → 0.2.0)

/release major # major 버전 강제 (0.1.0 → 1.0.0)

/release --dry-run # 미리보기만 (변경 없음)

/release --no-tag # CHANGELOG만 생성 (태그 안 찍음)

/release --github # GitHub Release도 생성

```

**공식 호출명:** `/release` (별칭: `릴리즈`, `릴리즈 노트`, `버전 올려`)

## 파이프라인 위치

```

/commit-work → /release

커밋 작성 릴리즈 노트 + 버전 + 태그

```

**독립 실행 가능** — 파이프라인 밖에서 단독으로 사용.

---

## CRITICAL: First Actions

### 1. Print Intro

```

Release Notes — 릴리즈 노트 생성

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

순서: Analyze → Version → CHANGELOG → Tag → (GitHub Release)

```

### 2. 현재 상태 확인

```bash

# 마지막 태그 확인

git describe --tags --abbrev=0 2>/dev/null || echo "태그 없음 (첫 릴리즈)"

# 마지막 태그 이후 커밋 목록

git log $(git describe --tags --abbrev=0 2>/dev/null)..HEAD --oneline

# 또는 태그 없으면 전체 커밋

git log --oneline

```

상태 출력:

```

📋 현재 상태:

마지막 버전: v{X.Y.Z} (또는 "없음 — 첫 릴리즈")

새 커밋: {N}개

브랜치: {branch}

```

**새 커밋이 0개면:**

```

⚠️ 마지막 태그 이후 새 커밋이 없습니다. 릴리즈할 내용이 없습니다.

```

→ 종료

---

## Phase 1: 커밋 분석

마지막 태그 이후의 모든 커밋을 Conventional Commits 형식으로 파싱합니다.

### 파싱 규칙

```

type(scope): description → type, scope, description 추출

```

| Type | 분류 | 버전 영향 |

|------|------|-----------|

| `feat` | Features (새 기능) | **minor** |

| `fix` | Bug Fixes | **patch** |

| `docs` | Documentation | patch |

| `style` | Code Style | patch |

| `refactor` | Refactoring | patch |

| `perf` | Performance | patch |

| `test` | Tests | patch |

| `build` | Build System | patch |

| `ci` | CI/CD | patch |

| `chore` | Miscellaneous | patch |

| `revert` | Reverts | patch |

| `BREAKING CHANGE` | (footer 또는 `!` suffix) | **major** |

### Conventional Commits가 아닌 커밋

Conventional Commits 형식이 아닌 커밋도 수집합니다:

- `Other Changes` 섹션에 포함

- 버전 영향: patch

### 분석 결과 출력

```

📊 커밋 분석:

feat: {N}개

fix: {N}개

docs: {N}개

refactor: {N}개

기타: {N}개

BREAKING: {N}개

```

---

## Phase 2: 버전 결정

### 자동 결정 (인수 없을 때)

Semantic Versioning (major.minor.patch) 규칙:

| 조건 | 버전 변경 |

|------|-----------|

| `BREAKING CHANGE` 또는 `!` suffix 있음 | **major** (1.0.0 → 2.0.0) |

| `feat` 커밋 있음 | **minor** (1.0.0 → 1.1.0) |

| 그 외 (fix, docs, refactor 등) | **patch** (1.0.0 → 1.0.1) |

### 수동 결정 (인수 있을 때)

```

/release major → major 강제

/release minor → minor 강제

/release patch → patch 강제

/release v2.0.0 → 특정 버전 강제

```

### 첫 릴리즈

태그가 없으면 기본 `v0.1.0`으로 시작. 단, `feat`가 있으면 `v1.0.0`.

### 버전 소스 파일 업데이트

프로젝트에 버전을 관리하는 파일이 있으면 자동 업데이트:

| 파일 | 필드 |

|------|------|

+ | `VERSION` | 파일 전체를 `X.Y.Z`로 교체 (줄바꿈 포함) |

| `package.json` | `"version": "X.Y.Z"` |

| `pyproject.toml` | `version = "X.Y.Z"` |

| `setup.py` | `version="X.Y.Z"` |

| `*.csproj` | `<Version>X.Y.Z</Version>` |

| `Cargo.toml` | `version = "X.Y.Z"` |

| `build.gradle` | `version = 'X.Y.Z'` |

**없으면 건너뜀** — 에러 아님.

+ **중요**: `VERSION` 파일은 업데이트 체크 시스템(`scripts/update-check.ps1|sh`)이 참조합니다. 반드시 릴리즈 시 업데이트해야 합니다.

### 버전 확인

```

📌 다음 버전: v{X.Y.Z}

이유: {feat N개 → minor / BREAKING CHANGE → major / fix만 → patch}

```

AskUserQuestion으로 확인:

- "v{X.Y.Z}로 릴리즈합니다. 진행할까요?"

- 옵션: "진행" / "버전 변경" / "취소"

---

## Phase 3: CHANGELOG 생성

### CHANGELOG.md 형식

[Keep a Changelog](https://keepachangelog.com/) 규격을 따릅니다.

```markdown

# Changelog

All notable changes to this project will be documented in this file.

## [X.Y.Z] - YYYY-MM-DD

### Breaking Changes