用途：帮助新手安装、检查更新或按明确授权更新 OpenAI Codex CLI，并把依赖缺失、命令不在 PATH、登录未完成分开处理。适用触发说法包括「安装 Codex CLI」「更新 Codex CLI」「Codex 命令不存在」。
主要能力：检查系统与已有 CLI 来源，识别独立 Codex CLI 的版本、安装方式、安装目录、命令路径和配置目录；协助官方独立安装或 npm 渠道安装 @openai/codex；执行版本审计并询问是否更新；更新后验证 --version、--help 和 login status；协助启动官方登录流程。
使用方式：可先执行 python3 scripts/inspect_installation.py --json；版本审计执行 TOOLS=codex DRY_RUN=1 bash ~/.agents/skills/soia-env-ai-cli-upgrade/scripts/upgrade-ai-clis.sh。已存在的 CLI 默认只做 dry-run 审计；只有客户明确要求更新到最新，才去掉 DRY_RUN=1 执行升级。未登录时用同一绝对路径执行 codex --login，客户在官方页面点击「Sign in with ChatGPT」授权，无需粘贴 API key。缺少升级技能时可安装 claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-env@soia，或使用 npx skills add soia-team/soia-open-env-skills -g -a '*' -s soia-env-ai-cli-upgrade -y。
限制：ChatGPT.app 内部 codex 不视为独立 CLI；Node.js/npm 仅 npm 渠道需要；管理员权限、切换来源或修改 PATH 需单独确认；失败时保留现有版本与错误证据，不自动卸载或降级；不读取或回显密钥。缺失事实暂未提供。