changelog
[UDS] 以 Keep a Changelog 格式產生並維護 CHANGELOG.md 條目。 Use when: 從 commit 歷史撰寫變更日誌條目、填寫 Unreleased 區段、將變更分類為 Added/Changed/Fixed。 Not for: 決定下一個版本號或執行發版——請用 /release；撰寫 commit message 本身——請用 /commit。 Keywords: changelog, CHANGELOG.md, Keep a Changelog, release notes, unreleased, 變更日誌, 發布說明, 版本紀錄.
소스 정보
- 저장소
- AsiaOstrich/universal-dev-standards
- 최근 소스 활동
- 2026년 8월 20일 06:47
- 감지된 SKILL.md 언어
- 중국어
- 스타
- 75
- 포크
- 13
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
파일 탐색기
2 개 파일SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- changelog
- source
- ../../../../skills/changelog-guide/SKILL.md
- source_version
- 1.0.0
- translation_version
- 1.1.0
- last_synced
- 2026-08-17T00:00:00.000Z
- status
- current
- description
- [UDS] 以 Keep a Changelog 格式產生並維護 CHANGELOG.md 條目。 Use when: 從 commit 歷史撰寫變更日誌條目、填寫 Unreleased 區段、將變更分類為 Added/Changed/Fixed。 Not for: 決定下一個版本號或執行發版——請用 /release；撰寫 commit message 本身——請用 /commit。 Keywords: changelog, CHANGELOG.md, Keep a Changelog, release notes, unreleased, 變更日誌, 發布說明, 版本紀錄.
- allowed-tools
- Read, Write, Grep, Bash(git log:*)
- scope
- partial
# 變更日誌助手
> **語言**: [English](../../../../skills/changelog-guide/SKILL.md) | 繁體中文
根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目。
## 工作流程
1. **分析 git log** - 使用 `git log` 讀取上次發布以來的提交歷史
2. **分類變更** - 將提交對應到變更日誌分類
3. **產生條目** - 為每個變更撰寫使用者友善的描述
4. **更新 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` |
## 條目格式
```markdown
## [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
## 使用方式
- `/changelog` - 分析近期提交並產生變更日誌條目
- 也可透過 `/release changelog [version]` 使用
## 下一步引導
`/changelog` 完成後，AI 助手應建議：
> **變更日誌已更新。建議下一步：**
> - 執行 `/release` 開始發布流程
> - 執行 `/commit` 提交日誌變更
> - 審查日誌條目確保使用者導向語言
## 參考
- 詳細指南：[guide.md](./guide.md)
- 核心規範：[changelog-standards.md](../../../../core/changelog-standards.md)
GitHub에서 보기