zvm —— Zig 版本管理技能
帮助编码代理正确安装、切换和运行指定版本的 Zig 工具链，避免污染全局环境。
技能明确要求先探测再询问用户才安装（不擅自 curl|bash）、默认使用作用域受限的 zvm run 而非改变全局的 zvm use、明确禁止 --skip-shasum 和未经提示的 zvm upgrade，权限最小化和确认机制意识强；扣分在于安装仍依赖 curl|bash 管道脚本这一透明度较低的模式，且来源归属仅为仓库声明，发布者未经注册处核验。
命令参考标注由 go test 生成、与 CLI 定义同步，SKILL.md 与 reference 内容一致，对 -- 分隔符错误、无 stdin 时 EOF 当作 no、颜色输出陷阱等异常路径有说明；扣分在于静态审阅无法执行验证关键路径，缺少可见的测试证据覆盖这些行为，错误反馈质量未经证实。
触发条件（安装 Zig、切换版本、配置 ZLS、版本不匹配）在 description 中清晰，非适用边界（不通过第二包管理器安装、不在 zvm 存在时叠加）明确；扣分在于核心下载依赖 zvm.app 与 ziglang.org 等海外源，对中国大陆网络可达性存在风险，虽有 --nomirror/自定义镜像作为缓解但未针对该环境说明。
文档分层良好（主文+生成式命令参考+README），许可证 MIT 明确，渐进披露和'Never do these'清单位置得当；扣分在于技能本身无独立版本/变更记录，维护责任仅在仓库层面间接体现，部分行为（如 --color=false 的坑）需要记住而非结构化披露。
任务（安装/切换/固定 Zig 版本、选择正确版本的决策顺序）覆盖完整、输出可直接使用，相比手动解包 tarball 有明显边际价值；扣分在于静态审阅无法验证示例输出真实可用，README 中部分示例（如 zvm i .14 输出 0.14.1）未经独立核对。
命令参考声称由 go test -run TestSkillReference -update 生成，且与 README、SKILL.md 三处互相印证；扣分在于未能看到实际测试文件或 CI 工作流针对该技能关键路径的证据，静态审阅无法独立复现，第三方佐证有限。
- 建议安装时优先使用 GitHub 上的安装脚本或 go install，而非直接 curl https://www.zvm.app/install.sh | bash，以便审查脚本内容。
- 技能文档假定可访问 zvm.app 与 ziglang.org，中国大陆用户可能需要配置自定义镜像（zvm vmu / mirrorlist）才能正常使用。
- 本评估为纯静态审阅，未执行任何命令；所有行为说明均来自文档自述。
这个 Skill 能做什么，适合哪些场景？
这个技能来自 zvm（Zig Version Manager）仓库，教会代理在需要安装 Zig、切换版本、配置 ZLS 或解决版本不匹配时优先使用 zvm，而不是发行版包管理器或手动解压 tarball。它详细说明了 zvm 的命令面：install、use、run、alias、vmu 等，并强调默认使用作用域受限的 zvm run 而非会改变全局符号链接的 zvm use。技能还教代理如何从 build.zig 的 //! zvm-lock 注释、build.zig.zon 的 .minimum_zig_version 或 CI 配置判断仓库真正需要的版本。命令参考由 zvm 自身 CLI 定义生成，不会与二进制漂移。
探测 zvm 是否已安装（command -v zvm），缺失时展示安装命令并征询用户而非擅自执行；通过 zvm install 下载指定 Zig 版本及配套 ZLS（--zls，可选 --full 兼容模式）；默认用 zvm run <version> <args> 以单命令作用域运行特定版本，只在用户明确要求时才用 zvm use 重指全局 ~/.zvm/bin 符号链接；按优先级读取 build.zig 中的 //! zvm-lock 注释（用 zvm use --sync 应用）、build.zig.zon 的 .minimum_zig_version、CI 配置来选择版本；用 zvm ls-remote -- 以机器可读方式选版本；解析版本缩写（0.15、.12）与别名（stable、master、自定义 alias）。
- 维护多个 Zig 项目的开发者，需要在不同版本间切换编译而不破坏其他项目
- 代理用户想让 AI 助手安全地测试代码在新版 Zig 上的表现，而不改变全局默认版本
- 使用 Mach 等 Zig 分叉或公司内部镜像的团队，需要通过 zvm vmu 切换版本源
- 跟随 master 分支的 Zig 贡献者，需要频繁更新 nightly 构建
- 新成员加入一个带 zvm-lock 注释的仓库，需要代理自动同步到锁定的版本
这个 Skill 有哪些优点和局限？
- 命令参考由 zvm 的 CLI 定义生成，与二进制保持同步
- 明确的安全规则：不擅自安装、不使用 --skip-shasum、不擅自升级 zvm
- 默认使用 zvm run，避免代理暗中改变用户的全局 Zig 版本
- 提供了判断仓库所需版本的明确优先级清单
- 要求用户机器上已安装或愿意安装 zvm；若用户拒绝安装，技能只能退回项目现有方式
- 无法替代发行版包管理器在锁定系统级 Zig 版本场景下的作用
- zvm run 不支持在版本后传 -- 分隔符，代理或用户需记住这一怪癖
- 技能本身不含自动化脚本，仅是指导文档，效果依赖代理遵循程度
如何安装这个 Skill？
Claude Code：运行 /plugin marketplace add tristanisham/zvm 然后 /plugin install zvm，或在 shell 中执行 claude plugin marketplace add tristanisham/zvm 和 claude plugin install zvm@zvm。Codex 及其他代理：仓库含 .codex-plugin/plugin. 清单，可直接加载 skills/zig-versions/ 目录。前提是本机已安装 zvm 本身（zvm.app 提供 install.sh / install.ps1 安装脚本）。
如何使用这个 Skill？
安装后代理会根据 SKILL.md 的描述自动触发，典型提示如“帮我用 Zig 0.14.0 跑一下测试”或“这个仓库该用哪个 Zig 版本”。代理会先探测 zvm 是否存在，再优先用 zvm run 0.14.0 build test 执行命令（注意 run 后不要加 -- 分隔符），只有用户要求切换全局版本时才使用 zvm use。
这个 Skill 与同类方案有什么区别？
技能明确建议用 zvm 取代 apt、brew、pacman 或从 ziglang.org 手动解压 tarball，因为发行版包滞后严重且无法并存多版本。