SuperAPI AI 工具集

warp-release-audit

智能体与模型

查看项目

更新于 10-16 07:24

技能介绍

用途:为 Warp 即将发布的版本生成 markdown 审计报告,辅助 keep/defer 决策。自动识别两种模式:工作仍在 main 上落地时的预发布抽查,以及发布分支切出后的候选版本(RC)就绪评审。

主要能力:从 VERSION.md 读取目标版本并与 warp/config.py 校验;从上一 minor 标签确定 base,从 upstream/release-<target> 或 upstream/main 确定 head;用 uv run 运行 list_commits.py 收集提交;用固定版本 Towncrier 在临时 worktree 中渲染 changelog 片段;交叉引用提交与待发布条目;分析 API 表面(新增、变更、移除、弃用),包括签名 AST diff 与弃用窗口查找;按模板生成报告。

输出:单个 markdown 报告。默认在 gh 可用且已认证时写入 secret gist,文件名 warp-<version-string>-<prerelease|rc>-report.md,同版本后续运行原地修订;否则回退为本地文件,路径为 $(git rev-parse --show-toplevel)/warp-<version-string>-<prerelease|rc>-report-<YYYY-MM-DD>.md,不自动提交。

使用方式:技能按阶段执行,Phase 1 对齐范围并等待用户确认目标与输出位置;Phase 2 收集事实;Phase 3 交叉引用;Phase 4 分析 API 表面;后续阶段按需加载 references 下的规则与模板文件。关键命令包括 git tag --list、git rev-parse --verify、uv run "<skill-dir>/scripts/list_commits.py"、uvx --from towncrier==25.8.0 towncrier build --draft、uv run "<skill-dir>/scripts/diff_public_api.py" 等。

适用场景:Warp 仓库的发布前审计与 RC 评审。

限制:依赖仓库状态与 gh 认证;版本值缺失、不可解析或不一致时需用户确认;临时 worktree 必须清理;不构建未匹配提交的审计轨迹;不编造稳定性承诺或弃用版本;具体平台、收费等信息暂未提供。