用途:解决 Mergify CLI 与 Mergify 技能版本不匹配的问题。技能通常跟随最新 CLI 发布,当 mergify 拒绝技能中列出的命令或参数时,很可能已安装的 CLI 版本过旧。
主要能力:提供版本比较、升级前询问用户、按安装渠道执行升级、升级后验证的完整流程。
使用方式:
- 比较版本:运行 mergify --version 查看已安装版本,结合发布说明确定最新版本及引入该命令的版本;较新的 CLI 可通过 mergify self-update --check 同时显示两个版本。
- 询问用户:升级会替换用户机器上的二进制文件,执行前必须先征得用户同意。
- 按原渠道升级:Homebrew 使用 brew upgrade mergify-cli;uv 使用 uv tool upgrade mergify-cli;pipx 使用 pipx upgrade mergify-cli;pip 使用 pip install --upgrade mergify-cli;通过安装脚本或手动下载的使用 mergify self-update。
- 重新运行命令:若升级后仍被拒绝,说明技能引用了尚未发布的命令,应告知用户,不要猜测其他命令。
适用场景:技能命令报错、需要检查或更新 Mergify CLI、需要确认 CLI 版本与技能兼容性时。
限制:升级前需用户确认;仅覆盖资料中列出的安装渠道;未提供其他平台或方式的具体支持说明。