SuperAPI AI 工具集

release-candidate-prep

编程与开发

查看项目

更新于 10-16 03:05

技能介绍

用途:该技能用于在专用 worktree 中准备本地 Python SDK 发布候选版本,是 GitHub Actions 发布工作流的手动回退方案。仅在用户显式调用 $release-candidate-prep 并提供不带前导 v 的版本号(如 VERSION=0.20.1)时使用;常规 Release Please 发布应改用 $final-release-review <release PR URL>,不要在 Actions 中调用此本地流程。

主要能力与边界:显式调用即视为授权拉取 origin/main、创建一个专用分离式发布 worktree、在其中运行无分支的发布就绪门禁、门禁通过后仅在该 worktree 内创建或替换本地 release/v<version>、更新五个发布归属文件并创建一个本地提交。绝不推送、创建或编辑 PR、添加标签或里程碑、创建 release 或改动 GitHub,绝不运行 gh。仅负责 pyproject.toml、uv.lock、.release-please-manifest.json、src/agents/version.py、tests/fixtures/released_api_contract.json 五个文件。

使用方式:先运行 prepare.py preflight 创建隔离的预检输入,再执行 make sync 引导依赖,随后运行 make check-prospective-released-api-contract 与 $final-release-review 规划门禁;两者通过后运行 prepare.py materialize 生成候选,检查 diff 后仅暂存五个文件并提交 release: <version>,再运行最终候选审查,最后重新检查 main 新鲜度并输出发布交接块。

限制:初始检出脏或不在 main、worktree 不干净或未处于刷新后的 origin/main、本地发布分支被其他 worktree 检出、门禁失败或 origin/main 在门禁后前进时,均须在创建分支前失败。需从所有子命令移除继承的 OPENAI_API_KEY。本地提交、最终审查与交接后即停止,推送与创建 PR 由用户负责。其他细节暂未提供。