更新日志生成器Skill changelog-generator

更新日志生成器是一款自动化工具,专门用于从约定式提交和拉取请求中智能生成规范的更新日志和发布说明。该工具支持多种输出格式,自动分类变更内容,生成升级指南,并与主流发布平台无缝集成,极大提升软件开发团队的版本管理和发布效率。关键词:更新日志生成、自动化发布、约定式提交、版本管理、发布说明、SDK文档、变更日志、CI/CD集成、GitHub发布、开发运维工具

DevOps 0 次安装 8 次浏览 更新于 2/25/2026

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

最佳实践

  1. 强制执行约定式提交消息
  2. 每次发布都生成更新日志
  3. 突出显示重大变更
  4. 链接到相关问题和PR
  5. 包含升级指南
  6. 支持多种格式