Skill: changelog
Git 히스토리로부터 버전별로 그룹화되고 기능 유형별로 분류된 체인지로그를 생성하거나 업데이트합니다.
트리거
/changelog- 체인지로그 생성 또는 업데이트- "체인지로그 생성해 줘", "체인지로그 업데이트", "뭐가 바뀌었어..."
파라미터
다음 정보가 제공되지 않은 경우 사용자에게 물어보세요:
-
대상 그룹 (기본 파일도 결정함)
- 사용자 →
Changelog.md(간소화, 이점 설명) - 개발자 →
Changelog-Dev.md(기술적, 커밋 세부 정보 포함)
- 사용자 →
-
모드
- 업데이트(기본): 마지막 항목 이후의 새 변경 사항만 추가
- 새로 생성: 특정 시점부터 전체 체인지로그 생성
-
기간 ("새로 생성"의 경우에만)
- 예: "2025년 3월부터", "v2.3.0부터"
워크플로우
1. 기존 체인지로그 확인
# 체인지로그 존재 여부 확인
ls Changelog.md Changelog-Dev.md 2>/dev/null
체인지로그가 존재하는 경우:
- 마지막으로 문서화된 상태(버전 또는 커밋) 확인
## 🔮 In Entwicklung마커 이후의 마지막 알려진 커밋 검색- 또는 마지막으로 문서화된 Insiders/Stable 버전을 참조로 사용
2. Git 데이터 수집
# 태그 및 날짜 가져오기
git for-each-ref --sort=-creatordate --format='%(refname:short) %(creatordate:short)' refs/tags
# 마지막 태그 확인
git describe --tags --abbrev=0
# 마지막 태그 이후 커밋 ("In Entwicklung"용)
git log $(git describe --tags --abbrev=0)..HEAD --pretty=format:"%h %ad %s" --date=short
# 특정 버전 이후 커밋
git log v2.3.0..HEAD --pretty=format:"%h %ad %s" --date=short
3. 커밋 분류
커밋 메시지를 분석하여 다음 범주에 할당합니다:
| 카테고리 | 키워드 |
|---|---|
| 새로운 기능 | Add, Feat, Feature, New, Implement |
| 버그 수정 | Fix, Bugfix, Hotfix, Resolve |
| 성능 | Performance, Optimize, Speed |
| 기술적 | Bump, Update, Refactor, Chore, Deps |
무시할 항목:
- Merge 커밋 ("Merge branch", "Merge pull request")
- 릴리스 커밋 ("Release v", "Bump version")
- WIP 커밋, 빌드 수정
4. 버전 할당
중요: 기능은 다음 단계를 순차적으로 거칩니다:
🔮 In Entwicklung → 🧪 Insiders → ✅ Stable
(예정) (얼리 어답터) (모든 사용자)
- 기능은 하나의 단계에만 표시될 수 있음
- Stable에 있으면 이전에 Insiders에 있었음
- Insiders에 있으면 이전에 Entwicklung에 있었음
- 각 섹션은 이전 버전 대비 새로운 변경 사항만 표시
5. 체인지로그 업데이트
업데이트 시:
- 기존 파일 읽기
- "In Entwicklung" 섹션을 새 커밋으로 업데이트
- 새 릴리스 시: "In Entwicklung" → "Insiders" 또는 "Insiders" → "Stable"로 이동
- 파일 저장
새로 생성 시:
- 모든 버전이 포함된 전체 템플릿 생성
기본 파일
| 대상 그룹 | 파일 | 내용 |
|---|---|---|
| 사용자 | Changelog.md | 이점 설명, 기술적 세부 사항 없음, 커밋 해시 없음 |
| 개발자 | Changelog-Dev.md | 기술적 세부 사항, 커밋 해시, PR 번호, 주요 변경 사항 |
출력 템플릿 (사용자)
# Changelog [프로젝트명]
---
## 🔮 In Entwicklung (다음 릴리스 예정)
*이 기능들은 [마지막_태그] 이후 추가되었으며 다음 릴리스에 포함될 예정입니다.*
### 새로운 기능
- 사용자 관점의 기능 설명
### 버그 수정
- 사용자 관점의 수정 설명
---
## 🧪 Insiders vX.Y.Z-insiders.N (DD.MM.YYYY)
*Stable vX.Y.Z 대비 새로운 기능이 포함된 프리뷰 버전.*
### 새로운 기능 (vX.Y.Z 대비)
- 기능 설명
---
## ✅ Stable vX.Y.Z (DD.MM.YYYY)
*안정 버전 - vX.Y.Z-insiders.1부터 vX.Y.Z-insiders.N까지의 모든 기능 포함.*
### 새로운 기능 (vX.Y-1.Z 대비)
- 기능 설명 *(insiders.N부터)*
### 버그 수정 (vX.Y-1.Z 대비)
- 수정 설명 *(insiders.M부터)*
---
## 릴리스 프로세스
기능은 모든 사용자에게 도달하기 전에 세 단계를 거칩니다:
🔮 In Entwicklung → 🧪 Insiders → ✅ Stable (예정) (얼리 어답터) (모든 사용자)
| 단계 | 대상 그룹 | 설명 |
|-------|------------|--------------|
| 🔮 **In Entwicklung** | 개발자 | 향후 기능에 대한 예정. 아직 어떤 릴리스에도 포함되지 않음. |
| 🧪 **Insiders** | 얼리 어답터 | Stable 릴리스 전에 새 기능을 테스트하기 위한 프리뷰 버전. |
| ✅ **Stable** | 모든 사용자 | 프로덕션 준비 완료 버전. 기능이 완전히 테스트되고 승인됨. |
**참고:** 각 섹션은 해당 단계에서 **새로운** 변경 사항만 나열합니다.
출력 템플릿 (개발자)
# Changelog (개발자)
---
## 🔮 In Entwicklung
*[마지막_태그] 이후 커밋*
### 새로운 기능
- `abc1234` 기능 X 추가 (#123)
### 버그 수정
- `def5678` 버그 Y 수정 (#456)
### 기술적 변경 사항
- `ghi9012` 의존성 Z 업데이트
---
## 🧪 Insiders vX.Y.Z-insiders.N (DD.MM.YYYY)
### 주요 변경 사항
- 주요 변경 사항 설명
### 새로운 기능
- `abc1234` 기능 설명 (#123)
### 버그 수정
- `def5678` 수정 설명 (#456)
---
## ✅ Stable vX.Y.Z (DD.MM.YYYY)
*Insiders .1부터 .N까지 포함*
### 주요 변경 사항
- 설명
### 커밋
- 마지막 Stable 이후 모든 커밋 목록
예제
예제 1: 체인지로그 업데이트 (기본)
사용자: "체인지로그 업데이트해 줘"
수행 방법:
Changelog.md존재 여부 확인- 마지막으로 문서화된 상태 확인
git log [마지막_상태]..HEAD --pretty=format:"%h %ad %s" --date=short- 새 커밋 분류
- "In Entwicklung" 섹션 업데이트
예제 2: 개발자용 체인지로그
사용자: "개발자 체인지로그 만들어 줘"
수행 방법:
Changelog-Dev.md존재 여부 확인- 커밋 해시와 PR 번호를 포함한 Git 히스토리 수집
- 기술적 세부 사항 및 주요 변경 사항 문서화
Changelog-Dev.md에 저장
예제 3: 새 릴리스 문서화
사용자: "v2.4.0-insiders.3을 릴리스했어"
수행 방법:
- Changelog.md 읽기
- "In Entwicklung"의 내용을 "Insiders v2.4.0-insiders.3"로 이동
- 새 빈 "In Entwicklung" 섹션 생성
- 날짜 추가
팁
- 긴 커밋 메시지의 경우 첫 번째 문장 사용
- PR 번호(#123)는 개발자 체인지로그에만 유지
- 관련 커밋 그룹화 (예: 하나의 기능에 여러 커밋)
- 커밋이 많을 경우
head명령어를 사용하여 출력 제한 - 업데이트 시 항상 기존 체인지로그를 기준으로 사용