SuperAPI AI 工具集

update-changelog

写作与研究

查看项目

更新于 10-16 07:13

技能介绍

用途:为 XerahS 生成或整合 docs/CHANGELOG.md 的发布说明,产出面向人类的更新日志而非 git log。

主要能力:提供 PowerShell 主脚本 .ai/skills/update-changelog/scripts/update-changelog.ps1 与 Bash 包装脚本 update-changelog.sh,可按提交范围生成草稿、写入指定文件或直接更新 docs/CHANGELOG.md;默认跳过噪声提交(如每小时审查跟踪、纯版本号提升、CI 发布提交),按类别与组件合并同类条目,省略提交哈希,仅在本地或 origin 存在对应 tag 时链接版本标题,并在每个版本块后追加分隔线。

使用方式:预览草稿执行 powershell -NoProfile -ExecutionPolicy Bypass -File .ai/skills/update-changelog/scripts/update-changelog.ps1,或 ./.ai/skills/update-changelog/scripts/update-changelog.sh;应用时加 -FromTag v0.23.128 -Version 0.23.129 -Apply,或 --from-tag v0.23.128 --version 0.23.129 --apply。可选参数包括 --output-path、-NoConsolidation、-IncludeHashes。脚本产出草稿后必须由代理进一步压缩改写为发布说明文风,目标比原始提交输出减少约 50–80% 行数。分类遵循 Keep a Changelog 的 Features、Fixes、Changed、Refactor、Build、Documentation、Testing、Performance,并按提交前缀映射。

适用场景:未发布版本聚合、历史噪声区块重建、平台改进(XIP0078 macOS、XIP0079 Linux)归类、外部贡献者署名。

限制:helper 脚本仅生成草稿,不能直接发布;不编造功能或价格信息;写入 Markdown 时不得用 [System.Text.Encoding]::UTF8(会产生 BOM 导致 Markdown Hygiene 失败),需用 UTF8Encoding($false) 并做 mojibake 清理;PowerShell 脚本内字符串使用 ASCII 标点,避免 Unicode 破折号导致解析问题。