用途:审计 BASE_TAG...TARGET 之间的差异,判断发布候选或发布计划是否可发布。支持两种模式:预发布规划(目标尚未声明发布候选,如 origin/main,可给出建议版本类型)和最终候选(目标是发布分支或包元数据已递增,需给出发布或阻止结论)。
主要能力:快照并审查发布差异,独立判断最低所需版本类型(patch/minor,1.0 前保留 major);检查公共 API、签名、默认值、枚举、包依赖、Python 版本、持久化状态与迁移路径;识别具体回归、数据丢失或安全影响;审查文档覆盖并检查当前打开的文档 PR;生成可供人工审批的发布报告与 Key Changes 草稿。
使用方式:确保仓库根为 openai-agents-python。可运行 find_latest_release_tag.sh 获取 BASE_TAG,使用 git fetch origin main --prune 与 git rev-parse origin/main 解析目标;再执行 git diff --stat、git diff --dirstat、git log --oneline --reverse、git diff --name-status 进行审查。常规发布应通过 Release Please PR 调用,不手动改版本、建发布分支或打标签;最终候选需在隔离检出中审查,并移除 OPENAI_API_KEY、GH_TOKEN、GITHUB_TOKEN 等环境变量,无需实时 API 调用。
适用场景:发布前风险门禁、版本兼容判断、发布说明草稿与文档覆盖核对。
限制:默认在无确凿阻塞证据时给绿灯,只有确认回归、版本不一致、无迁移路径的破坏性变更等才阻止;文档缺失、未合并或过期本身不阻塞;不要求本地重跑 CI;报告模板完整不等于通过,必须实际审查;目标、基线或候选内容变化会使结论失效。