发布说明生成器
根据git提交记录、PR或简单的变更列表生成清晰、专业的发布说明。输出格式化的更新日志,让用户真正愿意阅读。
使用方法
告诉代理发生了什么变更——粘贴提交记录、PR标题或用简单语言描述功能。它会生成结构化的发布说明。
输入选项
- Git差异/日志 — 粘贴
git log --oneline v1.2.0..v1.3.0输出 - PR列表 — 粘贴已合并的PR标题
- 简单描述 — “我们添加了深色模式,修复了登录错误,并放弃了对Python 3.7的支持”
输出格式
## v1.3.0 — 2026-02-13
### 新增功能
- 所有页面支持深色模式 (#142)
### 修复问题
- Safari浏览器上的登录重定向循环问题 (#138)
### 重大变更
- 放弃对Python 3.7的支持 — 最低要求现在是Python 3.9
### 迁移指南
- 将您的CI更新为使用Python 3.9+镜像
行为特性
- 按类型分组变更:新增功能、变更内容、修复问题、已弃用功能、已移除功能、安全更新、重大变更
- 遵循Keep a Changelog规范
- 为重大变更包含迁移指南
- 面向最终用户编写(除非特别说明面向工程师)
- 除非要求包含,否则过滤内部/重构提交
- 在可用时添加PR/问题编号
- 保持可扫描性——使用项目符号,而非段落
受众切换
说明"内部"以生成面向工程师的说明,或"外部"以生成面向客户的说明。默认为外部。
多种格式
可要求生成:
- 更新日志 — 适合追加的CHANGELOG.md格式
- 电子邮件 — 可直接粘贴到发布邮件中
- Slack — 适合#releases频道的紧凑格式
- GitHub发布 — 适合GitHub发布页面的Markdown格式
- 推文线程 — 适合社交媒体的亮点摘要
使用技巧
- 每次冲刺后或每次部署前运行
- 与将
git log输出到文件的CI步骤配合使用 - 维护一个持续的CHANGELOG.md文件,并追加每个发布版本
由AfrexAI构建 — 面向业务团队的AI上下文包(47美元/包)。查看我们的AI收入计算器以了解自动化正在消耗您多少成本。