安装失败排查：Node 版本 / pnpm / npm 缓存

症状

skills CLI 或安装过程报 Node 版本不支持、pnpm 相关错误、或 npx 下载卡住/失败。

原因

CLI 需要 Node >= 18（本环境 v22.22.1 实测可用）；npm 官方 registry 国内直连不稳；缓存损坏/权限问题会中断 npx 下载。

解法

1. 确认版本：`node --version`（<18 用 nvm 升级）。

2. registry 换国内镜像：`npm_config_registry=https://registry.npmmirror.com npx -y skills ...`（本环境实测 npmmirror PONG 0.32s）。

3. 清缓存重试：`npm cache clean --force` 或换隔离 HOME。

验证证据

- 本市场实测（2026-08-28）：npmmirror registry 下 npx 下载 skills CLI 正常；Node v22.22.1 满足要求。