用途：这是 ariadoss/superskills 提供的升级技能，用于把 superskills 升到最新版本。它会定位安装目录、记录当前版本、从远端同步最新代码并重跑 setup，最后报告版本变化。
主要能力：支持两种安装形态——规范安装（仓库克隆在 ~/.claude/skills/superskills 或 OpenCode 对应目录，并在该处运行过 ./setup）与开发仓库安装（仓库在其他位置，如 ~/Sites/superskills，通过 ./setup 把技能软链接回工具目录）。会读取 VERSION 文件对比本地与远端的 origin/main 版本，判断是否已是最新。
使用方式：触发升级（如要求“upgrade superskills”）后，技能先确定 INSTALL_DIR 与 INSTALL_KIND，再记录旧版本，然后 git fetch origin 并对比 origin/main:VERSION。若版本相同，仍会重跑 ./setup -q 以链接可能新增的技能。若需升级：规范安装会先尝试 git pull --ff-only origin main，失败则 git reset --hard origin/main 强制对齐，能处理历史被重写/强推的情况；开发仓库安装则不做硬重置、不丢弃提交，仅在有未提交改动时 stash，分支分叉则停止并提示用户手动处理。随后重跑 ./setup -q，读取 NEW_VERSION 并汇报。
适用场景：需要在 Claude 或 OpenCode 等工具环境中更新 superskills 技能集时。
限制与注意事项：仅适用于 git 安装；未找到安装目录时会报错并给出重新克隆安装命令。规范安装下升级可能丢弃本地提交，只有未提交改动会被自动 stash 保留；若 stash pop 冲突，改动会留在 git stash 中需手动恢复；开发仓库分叉时不自动解决，需用户自行 rebase 或 merge 后重跑 setup。