| source | ../../../../skills/changelog-guide/SKILL.md |
| source_version | 1.0.0 |
| translation_version | 1.0.0 |
| last_synced | "2026-02-10T00:00:00.000Z" |
| status | current |
| description | [UDS] 根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目 |
| name | changelog |
| allowed-tools | Read, Write, Grep, Bash(git log:*) |
| scope | partial |
| disable-model-invocation | true |
變更日誌助手
語言: English | 繁體中文
根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目。
工作流程
- 分析 git log - 使用
git log 讀取上次發布以來的提交歷史
- 分類變更 - 將提交對應到變更日誌分類
- 產生條目 - 為每個變更撰寫使用者友善的描述
- 更新 CHANGELOG.md - 將條目插入 [Unreleased] 或版本區段
變更分類
| 分類 | 使用時機 | When to Use | 對應提交類型 |
|---|
| Added | 新功能 | New features | feat |
| Changed | 修改既有功能 | Modifications to existing features | perf, BREAKING CHANGE |
| Deprecated | 即將移除的功能 | Features to be removed | -- |
| Removed | 已移除的功能 | Removed features | BREAKING CHANGE |
| Fixed | 錯誤修復 | Bug fixes | fix |
| Security | 安全性修補 | Security patches | security |
條目格式
## [Unreleased]
### Added
- Add user dashboard with customizable widgets (#123)
### Changed
- **BREAKING**: Change API response format from XML to JSON (#789)
### Fixed
- Fix memory leak when processing large files (#456)
撰寫指南
- 為使用者而非開發者撰寫 | Write for users, not developers
- 聚焦影響而非實作 | Focus on impact, not implementation
- 附上 issue/PR 編號 | Include issue/PR references
- 用 BREAKING 標記破壞性變更 | Mark breaking changes with BREAKING prefix
使用方式