upgrade-engines 是 OpenSteer 项目中用于引擎升级与验收的技能，适用于三类场景：提升引擎版本锁定；在真实账号上验收已发布或已安装的引擎；接入新可用的模型。
使用前需阅读 docs/ai-engines.md 以及受影响的 packages/harness-* 驱动。每次变更只升级一个引擎，主要命令包括：
- pnpm engines
- pnpm engines update <kind>
- pnpm engines verify
- pnpm check:changed --base origin/main
- pnpm test:engines -- -t 'shipped Codex'
其中 Codex 应替换为对应套件的引擎标签。对于声明了已安装运行时的引擎，还需运行已安装 <label> 的选择测试。验收时应使用专用的、有限额的 OPENAI_API_KEY/ANTHROPIC_API_KEY 凭据或机器上已有的登录；已发布引擎的验收会把已发布字节放在 PATH 首位。缺少登录或配额会阻塞验收。可检查 OPENSTEER_ENGINE_E2E_OUTPUT 下或打印目录中的 JSON 产物。跳过的验收不得记为通过。
Antigravity 通过下载而非已发布或 PATH 查找获得。版本锁定提升时必须在其驱动中更新并重新验证每个平台的归档大小、SHA-256 和完整成员清单，然后针对临时 Runner 运行时缓存运行下载版 Antigravity 验收。
接入新模型时，先检查账号的真实引擎目录；必要时更新其引擎，不得硬编码引擎无法描述的模型。检查受影响驱动测试中的原生 ID 路由、上下文/输出限制和选项，并审查协议与沙箱变更，包括 Codex 的已批准特性列表。发布后重新连接 Runner 以刷新账号。
对于运行中的本地 oMLX 服务器，可验收适配该机器的模型：
OPENSTEER_LOCAL_ENDPOINT_QUALIFY=1
OPENSTEER_LOCAL_ENDPOINT_OMLX_SETTINGS="$HOME/.omlx/settings.json"
OPENSTEER_LOCAL_ENDPOINT_MODEL_ID=<native-model-id>
pnpm test:engines -- -t 'local endpoint qualification'
其他端点可使用 OPENSTEER_LOCAL_ENDPOINT_BASE_URL、OPENSTEER_LOCAL_ENDPOINT_API_KEY 和 OPENSTEER_LOCAL_ENDPOINT_CONTEXT_WINDOW；可选设置 OPENSTEER_LOCAL_ENDPOINT_RUNTIME 和 OPENSTEER_LOCAL_ENDPOINT_MODEL_ID。检查临时记录/产物记录（可用 OPENSTEER_LOCAL_ENDPOINT_ARTIFACT_DIR 覆盖）。脚本化补全只能证明接线，每个受支持的引擎/服务器组合需用真实模型验收。