changelog-gen

name	changelog-gen
description	트리거: "changelog", "변경 이력", "릴리즈 노트", "release notes", "CHANGELOG 만들어줘" git log 또는 PR/커밋 목록을 분석하여 Keep a Changelog 형식의 CHANGELOG.md를 생성한다. 버전별 Added/Changed/Deprecated/Removed/Fixed/Security 섹션으로 구조화한다. 출력: CHANGELOG.md 형식 마크다운 + 버전 범프 권고

Changelog Generator — 변경 이력 자동 생성

목적

커밋 메시지, PR 제목, 또는 변경 내용을 분석하여 Keep a Changelog 형식의 CHANGELOG.md를 생성한다.

실행 절차

1단계: 변경 내용 수집

# 마지막 태그 이후 커밋 목록
git log $(git describe --tags --abbrev=0)..HEAD --oneline --no-merges

# 또는 두 태그 사이
git log v1.2.0..v1.3.0 --oneline --no-merges

# PR 머지 포함
git log --merges --pretty=format:"%s" v1.2.0..HEAD

2단계: 커밋 분류

Conventional Commits 규칙 기반으로 분류:

커밋 타입	Changelog 섹션
feat	Added
perf, refactor	Changed
deprecate	Deprecated
remove	Removed
fix	Fixed
security	Security
docs, test, chore	(내부 변경, 생략 가능)

3단계: 버전 결정 (Semantic Versioning)

• MAJOR (x.0.0): Breaking change (feat!, fix!, BREAKING CHANGE)
• MINOR (0.x.0): 새 기능 (feat)
• PATCH (0.0.x): 버그 수정 (fix, security)

4단계: 항목 작성 기준

• 사용자 관점에서 서술 (개발자 내부 용어 최소화)
• 링크: PR 번호 또는 이슈 번호 연결
• 간결하게: 한 줄로 변경 내용 표현

5단계: 기존 CHANGELOG.md 병합

• 파일이 이미 있으면 새 버전을 최상단에 추가
• [Unreleased] 섹션 패턴을 사용하면 해당 섹션에 누적

출력 형식

## CHANGELOG.md

```markdown
# Changelog

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

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [1.3.0] - 2026-04-01

### Added
- 사용자 프로필 이미지 업로드 기능 (#142)
- 다국어 지원 추가 (영어, 일본어) (#138)
- API 요청 레이트 리밋 헤더 노출 (#135)

### Changed
- 주문 조회 API 응답 속도 40% 개선 (Redis 캐시 적용) (#140)
- 에러 응답 형식 RFC 7807 표준으로 통일 (#133)

### Fixed
- 로그인 만료 후 토큰 갱신 무한 루프 버그 수정 (#144)
- Safari에서 날짜 피커가 표시되지 않는 문제 해결 (#141)

### Security
- JWT 서명 알고리즘 HS256 → RS256 으로 변경 (#139)

## [1.2.1] - 2026-03-15

### Fixed
- 결제 금액 소수점 계산 오류 수정 (#128)

## [1.2.0] - 2026-03-01
...

[Unreleased]: https://github.com/org/repo/compare/v1.3.0...HEAD
[1.3.0]: https://github.com/org/repo/compare/v1.2.1...v1.3.0
[1.2.1]: https://github.com/org/repo/compare/v1.2.0...v1.2.1

---

버전 범프 권고

• 현재: v1.2.1
• 권고: v1.3.0 (새 기능 2개 포함 → MINOR 버전 업)
• Breaking change: 없음

## 사용 예시

**입력:**

changelog 만들어줘 feat: 이미지 업로드 추가 fix: 토큰 갱신 버그 수정 security: JWT 알고리즘 변경

**출력 예시 (축약):**

[1.3.0] - 2026-04-01

Added

• 이미지 업로드 기능

Fixed

• 토큰 갱신 버그 수정

Security

• JWT 알고리즘 RS256으로 교체

버전 권고: 1.2.0 → 1.3.0 (새 기능 포함, MINOR 범프)

## 주의사항
- `chore`, `docs`, `test` 커밋은 기본적으로 생략한다 (사용자 요청 시 포함).
- 커밋 메시지가 Conventional Commits 형식이 아닌 경우 내용 기반으로 유추한다.
- 버전은 권고만 하며 실제 태깅은 사용자가 결정한다.
- 민감한 변경(security fix)은 CVE 번호나 취약점 상세를 포함하지 않는 것이 원칙이다.