一键导入
git-changelog-generator
分析 Git 提交记录并生成面向非技术用户的友好变更日志。当用户需要将技术性提交日志转换为易读的更新摘要、创建发布说明或向客户/利益相关者沟通产品变更时调用此技能。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
分析 Git 提交记录并生成面向非技术用户的友好变更日志。当用户需要将技术性提交日志转换为易读的更新摘要、创建发布说明或向客户/利益相关者沟通产品变更时调用此技能。
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
专精于 HTML5 Canvas 网页与动画交互开发。创建高性能、视觉丰富的 Canvas 应用,包括粒子系统、数据可视化、交互式动画、游戏渲染等。当用户需要创建、修改或优化 Canvas 网页时调用此技能。
数据库设计技能包,提供完整的数据库设计指导。适用于新建数据库、设计规范查询、数据库优化咨询等场景。
强制执行'先想清楚、再动手'工作流程。当任务涉及设计/架构决策、新功能实现、重构或任何需要规划的代码变更时调用此技能。
| name | git-changelog-generator |
| description | 分析 Git 提交记录并生成面向非技术用户的友好变更日志。当用户需要将技术性提交日志转换为易读的更新摘要、创建发布说明或向客户/利益相关者沟通产品变更时调用此技能。 |
本技能将技术性的 Git 提交记录转化为清晰、结构化且面向非技术用户的变更日志,帮助最终用户理解产品更新内容。
在以下情况调用此技能:
git log 命令)git log v1.0..v2.0)为了获得最佳效果,使用以下 git log 格式:
git log --pretty=format:"%h|%s|%b|%an|%ad" --date=short
此格式提供:提交哈希 | 主题 | 正文 | 作者 | 日期
| 类别 | 识别关键词 | 用户友好标签 |
|---|---|---|
| 新功能 | feat, add, new, implement, introduce | ✨ 新功能 |
| Bug 修复 | fix, bug, issue, resolve, patch | 🐛 问题修复 |
| 优化改进 | improve, refactor, optimize, enhance | ⚡ 优化改进 |
| 性能提升 | perf, speed, fast, latency, throughput | 🚀 性能提升 |
| 安全更新 | security, vuln, cve, protect, safe | 🔒 安全更新 |
| 文档更新 | docs, readme, guide, comment | 📝 文档更新 |
| 破坏性变更 | breaking, remove, deprecate, major | ⚠️ 破坏性变更 |
| 依赖更新 | deps, update, upgrade, bump | 📦 依赖更新 |
| 测试相关 | test, spec, coverage, e2e | 🧪 测试相关 |
| 样式调整 | style, format, lint, prettier | 💄 样式调整 |
# [版本 X.X] 变更日志 - YYYY-MM-DD
## 版本概览
[2-3句话概述本次发布的主要内容]
---
## ✨ 新功能
### [功能名称]
**更新内容:** [不含技术术语的清晰描述]
**为什么重要:** [用户收益和价值主张]
**影响范围:** [如何影响日常使用]
---
## 🐛 问题修复
### [问题描述]
**解决的问题:** [用简单语言描述故障]
**改进之处:** [现在的改善情况]
**用户收益:** [用户体验的提升]
---
## ⚡ 优化与增强
### [改进领域]
**改进内容:** [增强功能的描述]
**您会注意到:** [具体的实际收益]
---
## 🚀 性能更新
### [组件/领域]
**速度提升:** [用易懂的语言描述性能提升]
**实际影响:** [示例场景]
---
## 🔒 安全更新
### [安全领域]
**新增保护:** [哪些方面更加安全]
**您的数据更安全因为:** [解释说明]
---
## 📊 发布统计
- 总变更数:[数量]
- 新功能数:[数量]
- 问题修复数:[数量]
- 优化改进数:[数量]
- 安全更新数:[数量]
---
*基于 [提交数量] 次提交生成,由 [贡献者数量] 位贡献者完成*
| 技术术语 | 用户友好的替代说法 |
|---|---|
| 重构代码库 | 改进内部系统 |
| 实现缓存机制 | 让加载速度更快 |
| 修复竞态条件 | 解决时序问题 |
| 更新依赖项 | 升级底层技术 |
| 优化数据库查询 | 让数据获取更快 |
| 增加错误处理 | 更好的错误恢复能力 |
| 迁移到新的 API | 升级连接系统 |
| 增强日志记录 | 改进问题检测能力 |
反面示例:
"重构认证模块以实现 OAuth 2.0 和 JWT 令牌并增强会话管理"
正面示例:
"更安全的登录系统:我们升级了登录方式,使其更加安全和可靠。您的会话现在可以保持更长时间而无需重新登录,并且账户受到行业标准的保护。"
被动语态(避免):
"仪表板的性能通过优化数据库查询得到了改善"
主动语态(推荐):
"得益于优化的数据检索,您的仪表板现在加载更快"
不要只说"性能提升了",而是说:
根据目标受众配置语气:
用户可以请求特定格式:
用户可以指定包含/排除哪些章节:
输入:
feat: add dark mode support
fix: resolve login timeout issue
perf: optimize image loading by 50%
docs: update API documentation
输出:
# 变更日志
## ✨ 新功能
### 暗色模式支持
**更新内容:** 您现在可以切换到更深色的配色方案,让眼睛更舒适。
**为什么重要:** 非常适合深夜工作或在光线较暗的环境中减少眼睛疲劳。
**如何使用:** 在设置中找到主题切换开关即可。
---
## 🐛 问题修复
### 登录超时问题
**解决的问题:** 部分用户在使用过程中被意外退出登录。
**改进之处:** 会话管理现在更加稳定可靠。
**用户收益:** 可以更长时间地保持登录状态而不被打断。
---
## 🚀 性能更新
### 更快的图片加载
**速度提升:** 浏览时图片几乎瞬间显示。
**实际影响:** 相册和产品图片的加载速度提高了一倍,让浏览体验更流畅。
请求: "生成一个友好风格的中文 JSON 格式变更日志,仅关注功能和问题修复"
输出:
{
"version": "未指定",
"language": "zh-CN",
"tone": "friendly",
"summary": "本次更新带来了新功能并修复了一些问题",
"changes": [
{
"category": "新功能",
"icon": "✨",
"title": "暗色模式支持",
"description": "现在可以切换到护眼的深色主题啦!特别适合夜间使用。",
"benefit": "在设置中找到主题开关即可体验"
},
{
"category": "问题修复",
"icon": "🐛",
"title": "登录超时问题",
"description": "修复了使用过程中意外掉线的问题",
"benefit": "现在可以更稳定地保持登录状态"
}
],
"statistics": {
"total_changes": 2,
"new_features": 1,
"bug_fixes": 1
}
}
如果提交非常技术化:
如果提交缺少细节:
处理许多提交时:
交付输出前,请验证:
适用于任何提供提交日志的 VCS:
可集成到发布流水线中:
输出兼容以下平台:
问题:输出过于技术化 解决方案:重新请求时明确指示避免专业术语;指定目标受众(例如,"向我的祖母解释")
问题:遗漏了重要变更 解决方案:提供更多产品上下文;突出应该强调的特定提交
问题:分类不正确 解决方案:手动覆盖分类;在输入中提供分类提示
问题:太冗长/简洁 解决方案:调整详细程度参数;指定大致长度或章节数量
自动按用户影响力为每个变更评分:
使用评分来:
可选择性地包含贡献者致谢:
将变更日志条目链接到:
生成对比视图:
本技能基于以下方面持续改进:
请提供反馈,帮助我们将未来的输出定制为满足您的特定需求!