AI CLI 升级助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_eee31b03/soia-env-ai-cli-upgrade。
技能介绍
问题背景
不少人会在一台机器上同时装着 codex、Claude Code、Kimi、Qwen、OpenCode 等多套 AI CLI。它们各自通过 Homebrew cask/formula、npm 全局包或官方 curl 脚本安装,升级通道并不统一,也没有一个现成的命令能“把它们都升到最新”。结果是手动逐条跑升级、再逐条核对版本,既耗时又容易漏。
更麻烦的是版本审计本身也会出错:像 ~/.opencode/bin 这类安装目录不一定在当前 shell 的 PATH 上,你看到一个工具“不在”,很可能只是没探测到路径;反过来,不同工具的升级方式也需要识别当前安装通道才行。
这个技能做了什么
核心是一个纯 Python 标准库实现的单文件工具 scripts/upgrade_ai_clis.py,它只做两件事:安全地审计版本,然后在你确认后执行升级。
- 统一探测:对每个受支持的 CLI 自动识别当前安装方式(Homebrew cask / formula、npm 全局、curl 原生),输出一张结构化表格,包含
TOOL、OLD、NEW、STATUS、NOTE等列。例如知道你的 codex 是 Homebrew 装的,就不会让它走 npm 通道升级。 - 默认 dry-run:默认不执行任何升级,只报告当前版本与推荐升级方式;只有你显式要求时才真正动手。
- 可筛选范围:通过环境变量
TOOLS或NPM_PACKAGES指定要处理的子集,例如TOOLS="codex,claude,agy"。 - 保护现有安装:对 Claude Code,默认保留你已装的 Homebrew cask;只有在你显式允许
CLAUDE_CHANNEL=latest时,才安全迁移到@latest并支持失败回滚。 - 安全安装:仅当你显式授权
AGY_INSTALL=1时才会安装 Antigravity CLI,且不会让厂商安装器改动你的 shell 配置——它会下载官方安装器、语法校验后再执行,并隔离真实HOME。 - 日志与回执:每次执行完成都会生成结构化结论,告诉你哪些工具
UPDATED、ALREADY_LATEST、MANUAL或FAILED,并附带日志文件位置。
适用边界与注意事项
这个工具不做首次安装:缺失的 CLI 会被报告为 NOT_INSTALLED 而不是自动装上(agy 需要你先授权)。它也不会判断新版本是否“更好”,升级和回滚的决策仍然由你负责。
对 macOS 和 Linux(含 WSL)支持完整;原生 Windows 自 v2.3.0 起为实验性支持,且 agy 在原生 Windows 下可能报 MANUAL,需要你自行走 WSL。日志默认落在系统临时目录,是一次性的;如果你需要审计追溯,可以显式指定持久化日志目录。
一句话:它把这些杂七杂八的升级入口收敛成一个可重复的流程,但前提是你知道自己在升级什么、允许它改什么。
使用场景
- 本地装了好几套 AI CLI,想一次性确认各自的最新版本,而不是逐条手动检查
- 担心直接升级会打断当前工具链,希望先看到 dry-run 报告再决定是否执行
- 不确定某个 CLI 是通过哪种渠道安装的,需要在不改动 PATH 的情况下得知真实路径和版本
- 团队有多台开发机,想用同一脚本批量核对 AI CLI 版本,方便统一升级前先清点
适合人员
- 日常同时使用多个 AI CLI 的开发者,希望用自动化替代逐条手动升级的繁琐流程
- 负责维护团队开发环境一致性的技术运维,需要在多台机器上批量排查工具版本
- 担心 PATH 或迁移风险的技术负责人,要求所有升级附带可追溯的日志与回执
- 使用 AI 编码助手且关注安全审计的安全工程师,需要不触碰凭据的升级工具