Changelog guide

Skill AsiaOstrich/universal-dev-standards/skills/changelog-guide

[UDS] Generate and maintain CHANGELOG.md entries in Keep a Changelog format. Use when: writing changelog entries from commit history, filling the Unreleased section, categorising changes as Added/Changed/Fixed. Not for: choosing the next version number or running the release — use /release; writing the commit messages themselves — use /commit. Keywords: changelog, CHANGELOG.md, Keep a Changelog, release notes, unreleased, 變更日誌, 發布說明, 版本紀錄.From its SKILL.md

Install

npx -y skills add AsiaOstrich/universal-dev-standards --skill changelog-guide

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.

SKILL.md

4.4 KB, as published. Nobody here has run it

Changelog Assistant | 變更日誌助手

Generate and maintain CHANGELOG.md entries following the Keep a Changelog format.

根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目。

Workflow | 工作流程

Analyze git log - Read commit history since last release using git log
Categorize changes - Map commits to changelog categories
Generate entries - Write user-friendly descriptions for each change
Update CHANGELOG.md - Insert entries into the [Unreleased] or versioned section

Change Categories | 變更分類

Category	When to Use	使用時機	Commit Types
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`

Entry Format | 條目格式

## [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)

### Security
- Fix SQL injection vulnerability in search endpoint (CVE-2025-12345)

Writing Guidelines | 撰寫指南

Write for users, not developers | 為使用者而非開發者撰寫
Focus on impact, not implementation | 聚焦影響而非實作
Include issue/PR references | 附上 issue/PR 編號
Mark breaking changes with BREAKING prefix | 用 BREAKING 標記破壞性變更

Usage | 使用方式

/changelog - Analyze recent commits and generate changelog entries
Also available via /release changelog [version]

Next Steps Guidance | 下一步引導

After /changelog completes, the AI assistant should suggest:

變更日誌已更新。建議下一步 / Changelog updated. Suggested next steps:

執行 /release 開始發布流程 ⭐ Recommended / 推薦 — Start release process

執行 /commit 提交日誌變更 — Commit changelog changes

審查日誌條目確保使用者導向語言 — Review entries for user-facing language

Reference | 參考

Detailed guide: guide.md
Core standard: changelog-standards.md