SuperAPI AI 工具集

sdk-release

通用与其它

查看项目

更新于 10-16 03:11

技能介绍

用途:该技能用于指导 software-agent-sdk 的版本发布流程,当用户提出“release the SDK”“prepare a release”“publish a new version”“cut a release”等请求时使用。

主要能力:按阶段引导完成发布,包括确定 SemVer 版本号(X.Y.Z)、触发 prepare-release.yml 工作流(可通过 GitHub UI 或 GitHub API)、验证自动创建的发布分支与 PR、处理弃用期限检查失败、等待三类测试套件(integration-test、behavior-test、test-examples)通过、可选运行 SWE-bench 评估、合并发布 PR,以及发布后验证 PyPI 包与撰写 Slack 通知。

使用方式:通过 GitHub UI 进入 prepare-release.yml 页面点击 Run workflow 并输入版本号;或使用 curl 调用 GitHub API 触发工作流。工作流会校验版本格式、创建 rel-<version> 分支、运行 make set-package-version version=<version>、更新 eval 工作流中的 sdk_ref 默认值,并创建标题为 Release v<version> 的 PR。之后用 gh pr checks 监控测试状态,用 gh run rerun 重跑失败任务,用 gh pr merge 合并 PR。

适用场景:适用于 OpenHands software-agent-sdk 仓库的正式版本发布,涉及 openhands-sdk、openhands-tools、openhands-workspace、openhands-agent-server 四个包发布到 PyPI 及下游版本升级 PR 的创建。

限制:资料明确强调,未经人工明确批准,绝不能合并发布 PR 或创建/发布 GitHub release;合并操作不可逆,会自动触发完整发布流水线。部分测试失败可能为既有或偶发问题,需团队判断是否阻塞发布。评估为可选但推荐。发布后需等待几分钟验证 PyPI 索引,所有包应返回 200。具体价格、平台支持范围等未提供。