Community라이팅 & 에디팅github.com

Changelog (ProcessCube)

Git 히스토리로부터 버전별로 그룹화되고 기능 유형별로 분류된 체인지로그를 생성하거나 업데이트합니다.

Changelog (ProcessCube)란 무엇인가요?

이 스킬은 Git 커밋 히스토리를 분석하여 구조화된 CHANGELOG.md 파일(사용자용 단순 버전 및 개발자용 기술 버전)을 자동 생성하거나 업데이트합니다. 사용자가 '/changelog' 명령을 실행하거나 자연어 요청을 하면, 스킬은 기존 체인지로그 파일을 확인하고, 최신 Git 태그와 커밋을 가져오며, 커밋 메시지를 새로운 기능, 버그 수정, 성능 개선, 기술 변경 사항으로 분류합니다. 체인지로그는 '🔮 In Entwicklung(개발 중)', '🧪 Insiders(내부 테스트)', '✅ Stable(안정)'의 세 가지 진행 단계를 따르며, 각 단계는 해당 단계에서만 새로운 변경 사항을 표시합니다. Claude Code, Codex, OpenClaw에서 작동하며, 개발자는 자세한 커밋 해시, PR 번호, 주요 변경 사항을 포함하는 기술 버전을, 사용자는 기능과 버그 수정에 대한 간결한 설명을 선택할 수 있습니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add processcube-io/ProcessCube.Agent.Skills

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Skill: changelog

Git 히스토리로부터 버전별로 그룹화되고 기능 유형별로 분류된 체인지로그를 생성하거나 업데이트합니다.

트리거

  • /changelog - 체인지로그 생성 또는 업데이트
  • "체인지로그 생성해 줘", "체인지로그 업데이트", "뭐가 바뀌었어..."

파라미터

다음 정보가 제공되지 않은 경우 사용자에게 물어보세요:

  1. 대상 그룹 (기본 파일도 결정함)

    • 사용자 → Changelog.md (간소화, 이점 설명)
    • 개발자 → Changelog-Dev.md (기술적, 커밋 세부 정보 포함)
  2. 모드

    • 업데이트(기본): 마지막 항목 이후의 새 변경 사항만 추가
    • 새로 생성: 특정 시점부터 전체 체인지로그 생성
  3. 기간 ("새로 생성"의 경우에만)

    • 예: "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. 체인지로그 업데이트

업데이트 시:

  1. 기존 파일 읽기
  2. "In Entwicklung" 섹션을 새 커밋으로 업데이트
  3. 새 릴리스 시: "In Entwicklung" → "Insiders" 또는 "Insiders" → "Stable"로 이동
  4. 파일 저장

새로 생성 시:

  1. 모든 버전이 포함된 전체 템플릿 생성

기본 파일

대상 그룹파일내용
사용자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: 체인지로그 업데이트 (기본)

사용자: "체인지로그 업데이트해 줘"

수행 방법:

  1. Changelog.md 존재 여부 확인
  2. 마지막으로 문서화된 상태 확인
  3. git log [마지막_상태]..HEAD --pretty=format:"%h %ad %s" --date=short
  4. 새 커밋 분류
  5. "In Entwicklung" 섹션 업데이트

예제 2: 개발자용 체인지로그

사용자: "개발자 체인지로그 만들어 줘"

수행 방법:

  1. Changelog-Dev.md 존재 여부 확인
  2. 커밋 해시와 PR 번호를 포함한 Git 히스토리 수집
  3. 기술적 세부 사항 및 주요 변경 사항 문서화
  4. Changelog-Dev.md에 저장

예제 3: 새 릴리스 문서화

사용자: "v2.4.0-insiders.3을 릴리스했어"

수행 방법:

  1. Changelog.md 읽기
  2. "In Entwicklung"의 내용을 "Insiders v2.4.0-insiders.3"로 이동
  3. 새 빈 "In Entwicklung" 섹션 생성
  4. 날짜 추가

팁

  • 긴 커밋 메시지의 경우 첫 번째 문장 사용
  • PR 번호(#123)는 개발자 체인지로그에만 유지
  • 관련 커밋 그룹화 (예: 하나의 기능에 여러 커밋)
  • 커밋이 많을 경우 head 명령어를 사용하여 출력 제한
  • 업데이트 시 항상 기존 체인지로그를 기준으로 사용

관련 스킬