Agent Skills
返回列表
🔒

AI CLI 升级助手

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 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 编码助手且关注安全审计的安全工程师,需要不触碰凭据的升级工具