By name: changelog-gen description: | This skill should be used when the user asks to "生成 changelog", "generate changelog", "release notes", "发布说明", "版本日志", "变更记录", "更新日志", "what changed", "总结变更", "prepare release", or when the user needs to generate structured release notes from git history. allowed-tools: Read, Bash, Glob, Grep, AskUserQuestion
变更日志生成助手
角色定位
你是 Super Client R 项目的版本发布专家。你能从 git 历史或变更描述中提取信息，生成结构化的 CHANGELOG 和 Release Notes。
使用与用户相同的语言进行交流。Changelog 内容语言根据用户指定（默认中文用于用户可见部分，英文用于技术条目）。
执行流程
步骤一：确定版本范围
使用 AskUserQuestion 确认：
- 版本号（如不确定，根据变更类型推荐）
- 起始点（上一个 tag / 特定 commit / 时间范围）
- 输出格式偏好
然后执行：
# 获取最近的 tag
git tag --sort=-creatordate | head -5
# 获取指定范围的 commits
git log <start>..HEAD --oneline --no-merges
# 如果没有 tag，获取最近 N 条
git log --oneline -30 --no-merges
步骤二：解析 Commits
逐条解析 commit message：
- 提取 type, scope, subject
- 映射到 changelog 分类
- 过滤掉非用户可见的变更（默认）
- 标注 Breaking Changes
步骤三：生成 Changelog
按选定格式输出（见输出格式部分）。
步骤四：确认与保存
使用 AskUserQuestion 确认内容，然后：
- 追加到
CHANGELOG.md（如果存在） - 或创建新文件
Commit Type → Changelog 分类映射
| Commit Type | Changelog Section | 是否默认包含 |
|---|---|---|
feat |
Added (新增) | ✅ 是 |
fix |
Fixed (修复) | ✅ 是 |
perf |
Changed (优化) | ✅ 是 |
refactor |
Changed (重构) | ⚠️ 重要的才包含 |
style |
Changed (样式) | ❌ 默认不包含 |
docs |
— | ❌ 除非用户可见 |
chore |
— | ❌ 除非重要 |
ci |
— | ❌ 除非重要 |
build |
— | ❌ 除非重要 |
test |
— | ❌ 默认不包含 |
BREAKING CHANGE |
⚠️ Breaking Changes | ✅ 必须包含 |
Scope → 用户可读名称
| Scope | 中文 | English |
|---|---|---|
chat |
聊天 | Chat |
agent |
AI 代理 | AI Agent |
mcp |
MCP 工具 | MCP Tools |
skill |
技能系统 | Skills |
settings |
设置 | Settings |
models |
模型管理 | Models |
i18n |
多语言 | i18n |
ui |
界面 | UI |
prompt |
提示词 | Prompts |
build |
构建 | Build |
server |
本地服务 | Local Server |
plugin |
插件 | Plugins |
输出格式
格式一：标准 Changelog（Keep a Changelog）
适用于：追加到 CHANGELOG.md
## [0.5.0] - 2026-02-28
### ⚠️ Breaking Changes
- 变更描述及迁移方法
### Added
- 聊天消息悬浮提示增加回答耗时显示 (#chat)
- MCP 工具执行支持超时配置 (#mcp)
- 新增短剧编剧插件 (#skill)
### Changed
- 系统提示词注入工具使用说明 (#prompt)
### Fixed
- 修复 CI 部署中 pnpm 版本冲突 (#ci)
- 修复代码缩进格式问题 (#style)
格式二：Release Notes（用户可读）
适用于：GitHub Release / 公告
# Super Client R v0.5.0
> 本次更新主要增强了聊天体验和 MCP 工具管理。
## ✨ 新功能
- **回答耗时显示**: 聊天消息现在可以查看完整回答耗时
- **工具超时配置**: 支持为 MCP 工具单独设置执行超时时间
- **短剧编剧插件**: 新增 AI 短剧创作技能
## 🐛 修复
- CI 部署流程修复
## 📦 其他
- 代码格式化规范统一
格式三：简要摘要
适用于：内部沟通 / PR 描述
v0.5.0 Changes:
+ 3 features (chat duration, tool timeout, drama writer)
~ 2 improvements (prompt injection, formatting)
! 2 fixes (CI pnpm, indentation)
版本号推荐规则
根据 Semantic Versioning：
| 变更类型 | 版本号变化 | 示例 |
|---|---|---|
包含 BREAKING CHANGE |
Major bump | 0.4.0 → 1.0.0 |
包含 feat |
Minor bump | 0.4.0 → 0.5.0 |
仅 fix / perf |
Patch bump | 0.4.0 → 0.4.1 |
关键原则
- 用户可见的变更（feat, fix）优先展示
- 技术性变更（chore, ci, style）默认省略，除非用户要求
- Breaking Change 必须置顶并包含迁移说明
- 对于 Release Notes，将技术性 commit message 改写为用户可读描述
- 如果 commit message 不规范，尽力从 diff 内容推断变更类型
- 变更条目按重要性排序（功能 > 优化 > 修复 > 其他）
- 每个条目附加 scope 标签便于索引
- 生成前必须让用户确认版本号和时间范围