changelog-updater

CHANGELOG 更新技能

描述

根據變更內容自動更新 CHANGELOG.md，遵循 Keep a Changelog 格式。

觸發條件

• 「更新 changelog」「CL」「變更紀錄」
• 被 git-precommit 編排器調用
• 功能完成後需要記錄時

法規依據

• 憲法：CONSTITUTION.md 第 7 條
• 格式：Keep a Changelog 1.1.0

---

📁 CHANGELOG.md 標準格式

# Changelog

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

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

## [Unreleased]

### Added
- 待發布的新功能

## [1.2.0] - 2026-01-15

### Added
- 新增用戶認證模組 (#123)
- 新增密碼重設功能

### Changed
- 改進登入頁面 UI

### Fixed
- 修復登出後 session 未清除問題 (#456)

## [1.1.0] - 2026-01-01

### Added
- 初始版本功能

---

🔧 操作步驟

Step 1: 讀取現有 CHANGELOG

read_file("CHANGELOG.md")

Step 2: 取得變更資訊

從 git-precommit 調用時，分析變更內容：

get_changed_files()

或從使用者提供的變更描述判斷。

Step 3: 分類變更

類型	使用時機	關鍵字偵測
Added	新功能	新增, add, feat, create
Changed	修改現有功能	變更, 修改, update, change, refactor
Deprecated	即將移除的功能	棄用, deprecate
Removed	已移除的功能	移除, 刪除, remove, delete
Fixed	Bug 修復	修復, fix, bug, resolve
Security	安全性修復	安全, security, 漏洞, CVE

Step 4: 判斷版本號

依據 Semantic Versioning：

MAJOR.MINOR.PATCH

├── MAJOR: 不相容的 API 變更（Breaking Changes）
│   - 移除功能
│   - API 簽名變更
│   - 資料格式變更
│
├── MINOR: 新增功能（向下相容）
│   - 新增 API
│   - 新增功能模組
│   - 新增設定選項
│
└── PATCH: Bug 修復（向下相容）
    - 修復錯誤
    - 安全性修補
    - 文檔修正

Step 5: 更新 CHANGELOG

方式 A：新增到 Unreleased（推薦用於開發中）

oldString: "## [Unreleased]\n\n### Added"
newString: "## [Unreleased]\n\n### Added\n- 新增功能描述"

方式 B：發布新版本（用於 release）

oldString: "## [Unreleased]\n\n### Added\n- 新功能"
newString: "## [Unreleased]\n\n## [1.2.0] - 2026-01-15\n\n### Added\n- 新功能"

---

📝 條目撰寫規範

好的寫法

### Added
- 新增使用者認證模組，支援 OAuth2.0 (#123)
- 實作密碼強度檢查功能

### Fixed
- 修復登出後 session 未正確清除的問題 (#456)