用途:该技能定位为变更日志生成专家,从 git 提交历史中解析信息,自动整理成结构化 CHANGELOG。
主要能力:解析提交信息并识别 conventional commit 类型(feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert);识别破坏性变更(正文含 BREAKING CHANGE: 或类型后加 !);按变更类型分组;按语义化版本建议 major/minor/patch 升级;按 Keep a Changelog 格式输出 Markdown;可包含日期、版本、作者、提交及 PR 链接,并为破坏性变更提供迁移说明。
使用方式:文档给出调用示例,如 @changelog-generator、@changelog-generator --since v1.2.0、@changelog-generator --unreleased、@changelog-generator --version 2.0.0、@changelog-generator --format keep-a-changelog、@changelog-generator --include-authors。另提供脚本与工具方案,例如 conventional-changelog-cli 的安装命令 npm install -g conventional-changelog-cli 及生成命令,standard-version 的 npx standard-version 及相关选项,release-please 的 GitHub Action 配置,以及 Bash、Node.js、Python 脚本示例。
适用场景:需要维护 CHANGELOG 的项目,尤其在采用 conventional commits 和语义化版本工作流时,可用于发布前生成或更新变更日志。
限制:资料未提供该技能自身的收费、价格、平台支持范围及效果数据;其能力依赖提交信息遵循规范的格式,格式不规范的提交会被归入其他类别。具体使用步骤与可用参数以实际环境为准。