用途:按 keepachangelog.com 约定创建 CHANGELOG.md,并从 GitHub releases 或 git tags 回填历史版本记录。
主要能力:先加载共享的 changelog 规范;检查仓库中是否已有变更日志文件,若存在则询问是否覆盖;优先从 GitHub releases 收集发布历史,无 releases 时回退到 git tags,并按标准变更类型分类、筛选值得记录的条目;最后按规范结构写出文件并汇报回填的版本数量与数据来源。
使用方式:依次执行以下步骤。第一步运行 /changelog-rules 技能加载约定。第二步用 git rev-parse --show-toplevel 定位仓库根目录并查找变更日志文件,若已存在则用 AskUserQuestion 确认是否覆盖,用户拒绝则停止。第三步回填历史:优先运行 gh release list --limit 100 --json tagName,name,publishedAt 列出发布,再用 gh release view <tag> --json body --jq .body 读取说明并解析为条目;若无 GitHub releases,则运行 git tag --sort=-v:refname 列出标签,并对相邻标签对运行 git log <older-tag>..<newer-tag> --oneline 收集提交摘要。第四步按规范写出变更日志。第五步简要总结回填版本数与所用来源。
适用场景:需要为项目生成或补全符合 keepachangelog 规范的变更日志,尤其是希望从既有发布记录或标签历史自动回填版本条目时。
限制:依赖 git 仓库环境;GitHub releases 方式需要可用的 gh CLI 与相应访问权限;回填质量取决于 releases 说明或提交摘要的完整程度;覆盖已有文件需用户确认。其他细节暂未提供。