semicolon-devteam avatar

changelog-writer

SEMO 변경사항을 블로그 원고로 자동 기록. Use when:(1) 버저닝 완료 후 자동 호출, (2) 주요 기능 추가/삭제 시,(3) 아키텍처 변경 시.

by semicolon-devteam|Open Source

🔔 시스템 메시지: 이 Skill이 호출되면 [SEMO] Skill: changelog-writer 호출 시스템 메시지를 첫 줄에 출력하세요.

changelog-writer Skill

SEMO 변경사항을 블로그 원고로 자동 기록

Purpose

버저닝 완료 후 주요 변경사항을 docs/blog/drafts/ 디렉토리에 원고로 기록합니다. 이 원고들은 나중에 블로그 포스팅으로 편집됩니다.

Trigger

자동 호출 (version-manager 체인)

version-manager 완료
    ↓
[자동] changelog-writer 호출
    ↓
변경사항 분석 → 원고 생성

수동 호출

  • "변경사항 원고 작성해줘"
  • "블로그 원고 업데이트"
  • "릴리스 노트 정리"

Workflow

1. 변경사항 수집

# 최근 커밋에서 변경사항 추출
git log --oneline -10

# CHANGELOG 파일 확인
cat semo-system/semo-core/CHANGELOG/{version}.md

# 버전 정보
cat semo-system/semo-core/VERSION

2. 변경 유형 분류

유형키워드원고 포함
Major아키텍처, 구조 변경✅ 필수
Featurefeat, 신규 기능✅ 필수
Fixfix, 버그 수정⚠️ 중요한 것만
Refactorrefactor, 개선⚠️ 영향 큰 것만
Docsdocs, 문서❌ 제외
Chorechore, 잡무❌ 제외

3. 원고 생성

# docs/blog/drafts/{YYYY-MM-DD}-{package}-{version}.md

---
date: {YYYY-MM-DD}
package: {package_name}
version: {version}
type: {major|minor|patch}
status: draft
---

# {Package} {Version} 변경사항

## 주요 변경

### {변경 제목 1}

{상세 설명}

**Before:**
{이전 동작/구조}

**After:**
{변경 후 동작/구조}

### {변경 제목 2}

...

## 마이그레이션 가이드

{필요한 경우}

## 관련 커밋

- {commit_hash}: {commit_message}
- ...

## 태그

#semo #{package} #v{version}

4. 원고 저장

docs/blog/drafts/
├── 2024-12-29-semo-core-2.2.0.md
├── 2024-12-29-semo-scripts-1.1.0.md
└── 2024-12-29-semo-agents-1.0.0.md

Output Format

성공

[SEMO] Skill: changelog-writer 호출

## 원고 생성 완료

| 파일 | 패키지 | 버전 | 유형 |
|------|--------|------|------|
| 2024-12-29-semo-core-2.2.0.md | semo-core | 2.2.0 | minor |

📝 원고 위치: docs/blog/drafts/

💡 다음 단계:
1. 원고 검토 및 편집
2. docs/blog/로 이동
3. 00-series-index.md 업데이트

스킵 (변경사항 없음)

[SEMO] Skill: changelog-writer 호출

ℹ️ 블로그 원고 불필요
- 유형: patch (버그 수정)
- 사유: 마이너 변경으로 원고 생성 스킵

💡 주요 변경 시에만 원고가 생성됩니다.

🔴 version-manager 연동

version-manager SKILL.md에 추가할 내용

## 🔴 블로그 원고 자동 생성 (선택)

버저닝 완료 후 **주요 변경** 시 changelog-writer를 호출합니다:

| 버전 유형 | 원고 생성 |
|----------|----------|
| MAJOR | ✅ 자동 |
| MINOR (기능 추가) | ✅ 자동 |
| MINOR (개선) | ⚠️ 선택 |
| PATCH | ❌ 스킵 |

**호출 조건:**
- CHANGELOG에 `## Added` 또는 `## Changed` 섹션이 있는 경우
- 커밋 메시지에 `feat:` 또는 `refactor:` 접두사가 있는 경우

원고 템플릿

Major Release

---
date: 2024-12-29
package: semo-core
version: 2.0.0
type: major
status: draft
---

# SEMO Core 2.0.0 - 대규모 재구성

## 개요

이번 릴리스에서는 {핵심 변경 요약}.

## Breaking Changes

### 1. {Breaking Change 1}

**영향받는 사용자:** {누가 영향 받는지}

**이전 방식:**

{code/config}


**새로운 방식:**

{code/config}


**마이그레이션:**
```bash
{migration steps}

새로운 기능

{Feature 1}

{설명}

개선사항

{Improvement 1}

{설명}

관련 링크

태그

#semo #semo-core #v2.0.0 #breaking-change


### Minor Release

```markdown
---
date: 2024-12-29
package: semo-core
version: 2.2.0
type: minor
status: draft
---

# SEMO Core 2.2.0 - /SEMO:health 커맨드 추가

## 새로운 기능

### /SEMO:health 커맨드

환경 헬스체크를 위한 새 커맨드가 추가되었습니다.

**사용법:**

/SEMO:health


**출력 예시:**
```markdown
## .claude 디렉토리 검증 결과

| 항목 | 상태 | 비고 |
|------|------|------|
| semo-core | ✅ | 존재 |
| agents/ | ✅ | 6 symlinks |

관련 커밋

  • 1f3e066: feat(core): #SEMO:health 커맨드 추가

태그

#semo #semo-core #v2.2.0 #health-check


## 디렉토리 구조

docs/blog/ ├── 00-series-index.md # 시리즈 목차 ├── 01-beginning.md # 1편 ├── ... ├── 08-v5-restructuring.md # 8편 └── drafts/ # 원고 디렉토리 ├── README.md # 원고 작성 가이드 ├── 2024-12-29-semo-core-2.2.0.md └── ...


## Related

- [version-manager Skill](../version-manager/SKILL.md) - 버저닝 후 체인 호출
- [Blog Series Index](../../../../docs/blog/00-series-index.md) - 블로그 시리즈
Download Skill