Git 提交自动生成更新日志技能 Skill 技能

把 commit 翻译成用户可读发布说明

Git 提交自动生成更新日志技能(Changelog Generator)

技能简介

Changelog Generator 是一款把 Git 提交记录自动转成面向用户更新日志的 Agent Skill。发布团队常要花数小时把技术性 commit 翻译成客户能读懂的版本说明,人工整理既慢又容易漏重点。该技能能按时间范围或版本范围读取提交历史,把变更归类为新增、改进、修复、破坏性变更与安全更新,并改写为面向用户的发布语言。来源 GitHub 上的 awesome-claude-skills 集合,MIT 许可,Skillstore 质量分 79,属铜级(bronze)。项目地址见 github.com/ComposioHQ/awesome-claude-skills。

核心能力

  1. 提交记录分析:按日期范围、版本范围或最近一次发布窗口读取并分析 git 提交。
  2. 变更自动归类:把改动分成新功能、改进、缺陷修复、破坏性变更与安全更新。
  3. 语言改写:将技术性 commit 信息改写成面向客户的发布说明语言。
  4. Markdown 排版:把日志章节格式化为整洁的 Markdown 发布说明。
  5. 噪声过滤:自动过滤内部维护、测试与重构类改动,只保留用户可见更新。
  6. 风格对齐:当用户提供风格文件时,可按指定风格生成日志。

安装配置

  1. 通过 Skillstore CLI 安装:npx skillstore add composiohq/changelog-generator。
  2. 需在 Git 仓库环境中运行,确保技能能读取提交历史。
  3. 安装后适配 Claude、Codex 与 Claude Code,风险因素为外部命令。
  4. 建议从仓库根目录发起请求,或直接提供相关提交列表。

使用步骤

  1. 打开目标仓库,确认本地已拉取到需要生成日志的提交范围。
  2. 提出请求,例如"用 changelog-generator 生成自上个版本以来的更新日志,按用户影响分组"。
  3. 如历史很长,指定日期范围(如 3 月 1 日至 3 月 15 日)或版本范围以缩小范围。
  4. 让技能输出分好类的 Markdown 发布说明。
  5. 人工复核产品准确性、语气与客户影响,再发布到 CHANGELOG.md 或 GitHub Release。

适用场景

  1. 客户发布说明:为产品上线、周更与功能发布生成清晰更新。
  2. 公开更新日志:把打标签的提交转成 CHANGELOG.md 与 GitHub Release 条目。
  3. 产品周报草稿:把每周工程改动转成适合邮件简报或客服团队的更新摘要。
  4. 版本发布说明:为特定版本号(如 v2.5.0)生成发布说明。
  5. 多团队同步:让非技术团队也能读懂工程进展。

适用人群

  • 产品经理与发布经理:负责撰写版本发布说明。
  • 开源项目维护者:需要维护公开 CHANGELOG。
  • 技术写作者:负责把工程改动转成用户语言。
  • 增长与客服团队:需要及时了解产品更新。

工作原理

技能先解析指定范围内的 git 提交,提取提交信息与变更类型;再按用户影响把改动分桶归类,过滤掉维护、测试、重构等内部噪声;随后把技术性描述改写为面向用户的发布语言,并输出为结构化的 Markdown 章节。它只生成草稿,不自动推送或发布文件。

注意事项

  • 生成结果发布前可能需要人工复核。
  • 技能本身不会发布 Release 或推送日志文件。
  • 历史很长时应指定更窄的日期或版本范围。
  • 从仓库根目录运行,或提供相关提交列表。
  • commit 信息不清晰时需补充产品上下文。

官方链接

团队信息

由 AI 猎手自动发现

评论与建议

0 条评论