关于 Changelog Generator
Changelog Generator 是一项将提交记录、功能清单或代码变更整理为发布说明的技能,支持面向用户和技术读者的格式,并按常规提交类型归类。
主要功能
- 01根据提交或变更说明生成内容
- 02按变更类型归类
- 03生成标准、用户版和技术版格式
- 04按语义化版本组织条目
适用场景
- 01根据提交列表起草发布说明
- 02汇总代码差异作为发布内容
- 03将缺陷报告整理为变更记录
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ claude-office-skills/ skills --skill changelog-generator安装后在 Claude Code 中输入/changelog-generator确认已加载。
详细介绍
变更日志生成器
根据提交、功能列表或更新生成专业的发行说明和变更日志。
概述
此技能可帮助你:
- 将 git 提交转换为易读的变更日志
- 按类型对变更进行分类
- 编写用户友好的发行说明
- 维护变更日志历史
- 遵循规范格式
使用方法
根据 Git 提交
"Generate a changelog from these commits:
- fix: resolve login timeout issue
- feat: add dark mode support
- docs: update API documentation"
根据功能列表
"Create release notes for version 2.0:
- New dashboard design
- Performance improvements (50% faster)
- Fixed: export button not working
- Removed: legacy API v1"
根据 Diff/变更
"Summarize these code changes into a changelog entry"
输出格式
标准变更日志(Keep a Changelog)
# 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]
## [2.1.0] - 2026-01-29
### Added
- Dark mode support across all pages
- Export to CSV functionality
- Keyboard shortcuts for common actions
### Changed
- Redesigned dashboard with improved navigation
- Upgraded authentication to OAuth 2.0
- Performance improvements (50% faster load times)
### Deprecated
- Legacy API v1 (will be removed in v3.0)
### Removed
- Support for Internet Explorer
### Fixed
- Login timeout issue on slow connections
- Export button not responding on mobile
- Memory leak in real-time updates
### Security
- Updated dependencies to patch CVE-2026-XXXX
## [2.0.0] - 2025-12-01
...
用户友好的发行说明
# What's New in Version 2.1
We're excited to announce version 2.1 with dark mode and major performance improvements!
## ✨ New Features
### Dark Mode
Finally here! Switch between light and dark themes in Settings > Appearance. Your preference syncs across devices.
### CSV Export
Export your data to CSV with one click. Find it in the Actions menu on any data view.
### Keyboard Shortcuts
Work faster with shortcuts:
- `Ctrl/Cmd + K` - Quick search
- `Ctrl/Cmd + N` - New item
- `?` - Show all shortcuts
## 🚀 Improvements
- **50% Faster Loading** - Completely rebuilt our data loading pipeline
- **New Dashboard** - Cleaner design with customizable widgets
- **Better Authentication** - Upgraded to OAuth 2.0 for enhanced security
## 🐛 Bug Fixes
- Fixed login timeouts on slower connections
- Export button now works properly on mobile devices
- Resolved memory issues with real-time updates
## ⚠️ Important Notes
- **Deprecation Notice**: Legacy API v1 will be removed in version 3.0
- **Browser Support**: Internet Explorer is no longer supported
---
Questions? Contact [email protected] or visit our [Help Center](link).
技术发行说明
# Release v2.1.0
**Release Date**: 2026-01-29
**Type**: Minor Release
**Compatibility**: Breaking changes: None
## Summary
This release introduces dark mode, CSV export, and significant performance improvements.
## Changes
### Features
| ID | Description | PR |
|----|-------------|-----|
| FEAT-123 | Dark mode theme support | #456 |
| FEAT-124 | CSV export functionality | #457 |
| FEAT-125 | Keyboard shortcuts | #458 |
### Fixes
| ID | Description | Severity | PR |
|----|-------------|----------|-----|
| BUG-789 | Login timeout on slow connections | High | #459 |
| BUG-790 | Mobile export button | Medium | #460 |
### Dependencies Updated
| Package | From | To | Reason |
|---------|------|-----|--------|
| lodash | 4.17.20 | 4.17.21 | Security patch |
## Migration Guide
No migration required for this release.
## Known Issues
- Dark mode does not apply to embedded iframes
## Contributors
@developer1, @developer2, @designer1
类别定义
变更类型(Conventional Commits)
| 类型 | 描述 | 变更日志章节 |
|---|---|---|
feat | 新功能 | Added |
fix | Bug 修复 | Fixed |
docs | 文档 | Documentation |
style | 格式调整 | Changed |
refactor | 代码重构 | Changed |
perf | 性能 | Changed |
test | 测试 | N/A(内部) |
chore | 维护 | N/A(内部) |
breaking | 破坏性变更 | ⚠️ BREAKING |
security | 安全修复 | Security |
deprecate | 弃用 | Deprecated |
remove | 移除 | Removed |
语义化版本控制
MAJOR.MINOR.PATCH
MAJOR: Breaking changes (incompatible API changes)
MINOR: New features (backwards compatible)
PATCH: Bug fixes (backwards compatible)
模板
提交转为变更日志条目
Input: feat(auth): add OAuth 2.0 support (#123)
Output: - Added OAuth 2.0 authentication support
Bug 报告转为修复条目
Input: Users reported export failing on files > 10MB
Output: - Fixed export functionality for large files (> 10MB)
最佳实践
编写优质条目
✅ 应该:
- 从用户的角度来写
- 具体说明发生了哪些变化
- 包含相关的问题/PR 编号
- 将相关变更归为一组
❌ 不应该:
- 在面向用户的说明中使用技术术语
- 在公开变更日志中包含内部变更
- 内容含糊不清(“各种修复”)
- 在面向用户的文档中包含提交哈希
组织变更
- 优先展示影响:将最重要的变更放在顶部
- 按逻辑分组:按功能领域或类型分组
- 保持一致:全文使用相同格式
- 标注日期:清楚标明版本日期
限制
- 无法直接访问 git 仓库
- 需要将提交消息或变更描述作为输入
- 无法自动验证语义化版本控制
- 技术细节应由开发者核实
评论
支持 Markdown