SuperAPI AI 工具集

changelog-audit

通用与其它

查看项目

更新于 10-16 02:34

技能介绍

用途:在 Warp 发布前审计 CHANGELOG.md,自动识别 main 或 release-* 两种模式。release-branch 模式下完成全部清理、将 [Unreleased] 提升为 [X.Y.Z] 并更新底部对比链接;main 模式下就地整理 [Unreleased],并在主分支落后于已发布标签时回补该标签章节、去重并轮换对比链接。

主要能力(按顺序执行):Phase 1.5 发布后同步(仅 main,触发后不可跳过,回补缺失标签章节并去重);Phase 2 丢失条目恢复(修复 merge=union 导致的条目滞留);Phase 3 校验、合并同类条目、检索缺失 GH 引用并修正错误分类;Phase 4 按用户影响排序;Phase 5 语言润色与删除无用户影响条目;Phase 6 折行(120 字符上限)并生成合并差异;Phase 7 仅 release 分支执行重命名与链接引用更新。

使用方式:以任意 git ref 作为可选位置参数,省略时默认 HEAD,且不假设当前工作树分支等于待审计对象,ref 是内容读取的唯一依据。技能会解析引用名判断模式,读取 VERSION.md 与 warp/config.py 确定目标版本,确定丢失条目对比的基准标签,选择编辑所用工作目录(必要时建议 git worktree add ../warp-changelog-audit-<ref-slug> <ref>),并在任何修改前要求用户确认。所有改动先暂存于内存缓冲区,仅在 Phase 6 展示合并差异且用户确认后才写入 CHANGELOG.md;部分阶段会逐条征询决定。

适用场景:Warp 项目的发布前变更日志审校,尤其是使用 merge=union 且需在 main 与 release 分支间保持一致性的仓库。

限制与注意:需要 git 环境与可写工作树;main 模式下若主分支未同步已发布标签,同步流程不可跳过,且不允许直接向 main/master 提交,需先切到特性分支;参考资料 references/sorting-rubric.md 与 references/language-conventions.md 按需加载;其他平台或价格信息暂未提供。