用途：按可重复流程审计、dry-run 或升级本地 AI 与开发者 CLI，覆盖 codex、claude、Antigravity/agy、gemini（非消费者通道）、kimi、qwen、opencode、qodercli、cursor、mmx 等。若只需了解单个已知 CLI 的安装方式、无需版本审计或批量流程，则不宜使用。
主要能力：自动检测 native、brew formula/cask、npm 等安装来源并选择对应升级方式；输出新旧版本、状态（INSTALLED、UPDATED、ALREADY_LATEST、NOT_INSTALLED、SKIP_DRY_RUN、MANUAL、FAILED）与备注；写入带时间戳日志并轮转。
使用方式：安装技能可执行 npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-ai-cli-upgrade -y。默认先 dry-run：DRY_RUN=1 bash skills/soia-dev-ai-cli-upgrade/scripts/upgrade-ai-clis.sh；正式升级去掉 DRY_RUN=1。可用 TOOLS="codex,claude,agy" 限定范围；gemini 需显式 TOOLS="gemini"。缺少 agy 时仅当 AGY_INSTALL=1 才从 Google 官方 HTTPS 端点安装，且不执行登录。支持 LOG_DIR、NPM_PREFIX、AGY_INSTALL_DIR、CURSOR_UPGRADE_CMD 等环境变量，可写入私有 config.yml。
适用场景：需要在工单或日志中记录版本变更、批量升级多个 CLI、排查升级后行为变化。
限制：不自动修改 shell 配置或 PATH；不写入密钥、token、cookie 到日志；不检查或代表认证成功；需要交互登录或特权访问时应停止并报告阻塞（blocked_user_action）；cursor 默认仅审计，除非用户明确提供 CURSOR_UPGRADE_CMD；gemini 消费者 Google 登录已不再支持，应转向 agy，企业 Standard/Enterprise、API Key、Vertex 通道保留支持；其余细节以实际资料为准，暂未提供更多信息。