用途：把 Chief Agent Framework 升级到参数指定的版本。参数可为具体版本（如 v1.0.0）、canary（最新开发分支）或省略（默认取最高 semver 稳定标签，通过 git ls-remote --tags 查询）。
主要能力：先检测用户使用的编码代理（claude-code、opencode、codex、cursor、copilot、gemini-cli、amp、windsurf、kiro、aider）及安装模式（link 或 copy），再克隆目标版本到 .chief-agent-tmp，对比 AGENTS.md、.agents/agents/.md、.agents/skills//、.chief/MANUAL.md、.chief/project.md、.chief/_rules/、.chief/_template/ 等路径，将差异归类为框架更新、新文件、用户修改冲突、结构变更、删除，并输出升级计划。
使用方式：克隆命令为 git clone --depth 1 --branch <version> https://github.com/thaitype/chief-agent-framework.git .chief-agent-tmp；应用后按所选模式用 ln -s 或 cp 更新 .claude/、.github/agents/ 等目录，最后 rm -rf .chief-agent-tmp 清理。
限制：必须获得用户明确批准后才可应用变更；不得覆盖 .chief/ 中用户内容；不得未经批准删除用户文件；不确定是否被用户修改时归类为冲突；即使取消升级也要清理临时目录。