SuperAPI AI 工具集

final-release-review

通用与其它

查看项目

更新于 10-16 03:05

技能介绍

用途:审计 BASE_TAG...TARGET 之间的差异,判断 JS SDK 候选版本或发布计划是否可发布。支持两种模式:预发布规划(针对 origin/main,尚未生成 Changesets 版本 PR)与最终候选(TARGET 含 Changesets 生成的版本提交)。

主要能力:以 Changesets 为补丁/次版本判定依据,识别发布类型(patch/minor/none/invalid);审计运行时兼容性、回归、打包与发布风险;检查公开 API、依赖、Node/TypeScript 版本、持久化状态与配置的向后兼容;审查文档覆盖情况;对 minor 发布生成 Key Changes 草稿;输出固定格式的发布就绪报告,含 ship/block 结论、风险等级与解除阻止清单。

使用方式:在 openai-agents-js 仓库根目录运行。先同步远端标签并选取上一发布标签,例如 BASE_TAG="$(.agents/skills/final-release-review/scripts/find_latest_release_tag.sh origin 'v*')";再刷新并解析目标,默认 origin/main:git fetch origin main --prune 与 TARGET="$(git rev-parse origin/main)"。随后用 git diff --stat、--dirstat、git log、--name-status 快照差异,并依据 references/review-checklist.md 审计。

限制:默认假定目标已通过仓库 CI,不重复运行常规单元、lint、格式、类型、覆盖率或 changeset 检查;文档缺失本身不阻止发布,但真实破坏性变更且无迁移路径可阻止;不得使用 gh 或修改 GitHub;报告默认放在一个可复制的 markdown 代码块中,使用固定 compare URL 与原生 PR 引用。