SuperAPI AI 工具集

release-audit

部署与运维

查看项目

更新于 10-16 02:34

技能介绍

用途:为即将发布的 Warp 生成 markdown 审计报告,供发布管理员做 keep/defer 决策。它有两种模式,由版本串与 head 分支自动判断:版本含 dev 且 head 为 main 时生成预发布抽查报告;版本含 rc 或已切出 release 分支时生成候选发布就绪评审。

主要能力:从仓库状态推断目标版本、基线 tag 与 head ref;用脚本提取提交清单;读取 head ref 上的 CHANGELOG.md 的 Unreleased 段落,解析 Added/Removed/Deprecated/Changed/Fixed/Documentation 各小节,提取 GH 引用与 Breaking 标记;做提交与 CHANGELOG 的交叉引用,标出无对应提交的孤儿条目;分析公共 API 变化,区分真正新增 API 与既有 API 的扩展,为新增符号提取签名和 docstring,为变更/移除项生成签名 diff,并检查移除项此前是否经历过弃用窗口;还会独立比对 base 与 head 的公共 API 表面,发现未标注的破坏性变更。

使用方式:技能以 SKILL.md 形式加载,按 Phase 1 到 6 依次执行。Phase 1 会先在对话中给出报告模式、base/head、提交数与输出目的地建议,并强制等待用户明确确认 refs 与目的地后才继续。输出目的地默认是 secret gist(gh 可用且已认证时),文件名与描述固定为 Warp <version-string> <Pre-Release|Release Candidate> Report 形式,同一版本后续运行会就地修订同一 gist;gh 不可用或用户选择时回退为仓库根目录下带日期的本地 markdown 文件。提交清单通过 uv run 调用脚本获取,日期使用 $(date +%F) 由 shell 提供。

适用场景:Warp 发布流程中的预发布抽查与候选发布就绪评审。

限制:依赖仓库内的脚本与参考文档(报告模板、渲染规则、分类规则等),需在包含该技能目录的仓库环境中运行;gh 不可用时只能输出本地文件;若基线 ref 过旧或缺少公共 API 导出、文件无法解析,签名 diff 检查会跳过并给出提示。其余平台支持、费用与具体运行环境要求暂未提供。