name: changelog-generator description: 基于提交和PR自动生成更新日志 allowed-tools:
- Read
- Write
- Edit
- Glob
- Grep
- Bash
更新日志生成器技能
概述
本技能通过解析约定式提交和拉取请求,自动生成格式规范的更新日志,为SDK版本提供专业的发布说明。
核心功能
- 解析约定式提交以生成更新日志条目
- 基于PR描述生成发布说明
- 分类变更内容(新功能、修复、重大变更)
- 支持多种输出格式(Markdown、JSON)
- 自动链接到相关问题和PR
- 为重大变更生成升级指南
- 支持更新日志模板
- 与发布自动化流程集成
目标流程
- SDK版本管理与发布流程
- API版本策略管理
- 向后兼容性管理
集成点
- semantic-release自动化工具
- conventional-changelog
- GitHub/GitLab发布功能
- 发布说明平台
- 文档站点
输入要求
- 提交约定(约定式提交)
- 变更分类规则
- 输出格式偏好
- 模板要求
- 链接生成规则
输出产物
- CHANGELOG.md文件
- 各版本发布说明
- 升级指南
- 重大变更文档
- 自动化发布集成文件
使用示例
skill:
name: changelog-generator
context:
convention: conventional-commits
categories:
- type: feat
title: 新功能
- type: fix
title: 错误修复
- type: breaking
title: 重大变更
output:
format: markdown
file: CHANGELOG.md
linkTemplates:
commit: "https://github.com/组织/仓库/commit/{hash}"
issue: "https://github.com/组织/仓库/issues/{id}"
includeUpgradeGuide: true
最佳实践
- 强制执行约定式提交消息
- 每次发布都生成更新日志
- 突出显示重大变更
- 链接到相关问题和PR
- 包含升级指南
- 支持多种格式