用途
setup-node 用于为当前用户安装一套可用的 Node.js LTS 环境,包含 npm 和 npx,使 npx、npm install -g 以及依赖它们的命令行工具能够运行。它适用于当 node、npm 或 npx 不可用或版本过低时的场景。
主要能力
- 先做检查:如果
node --version输出 v20 或更高,且npm --version可用,则直接说明并停止。 - 识别操作系统:用
uname -s判断(Darwin 为 macOS,Linux 为 Linux);如果该命令失败或由 PowerShell 响应,则视为 Windows。 - macOS 上确保 Homebrew 存在:查找
/opt/homebrew/bin/brew(Apple Silicon)或/usr/local/bin/brew(Intel)。若两者都不存在,需要用户手动运行安装命令,因为安装 Homebrew 需要一次 Mac 密码。 - 安装 Node:macOS 和 Linux 运行
scripts/install-node.sh;macOS 上使用brew install node并把 Homebrew 写入 shell 配置;Linux 或使用--no-brew时,将官方 Node LTS 下载到~/.local/node,无需管理员密码。Windows 使用winget install --id OpenJS.NodeJS.LTS -e --accept-source-agreements --accept-package-agreements,然后请用户关闭并重新打开 Claude 会话。 - 处理当前会话:macOS 上用
eval "$(/opt/homebrew/bin/brew shellenv)"(Intel 为/usr/local/bin/brew),或对~/.local安装使用export PATH="$HOME/.local/node/bin:$PATH"。 - 确保全局安装无需管理员权限:运行
npm config get prefix;若npm install -g因 EACCES 失败,运行npm config set prefix ~/.local并确保~/.local/bin在 shell 配置中。明确不使用sudo npm。 - 验证:运行
node --version && npm --version && npx --version,再用npx -y cowsay ok输出一头牛;并用$SHELL -lic 'node --version'确认新会话也能找到相同版本,否则先修复 shell 配置。
使用方式
该技能以脚本和命令步骤的形式执行。若从链接而非本地文件夹获取此技能,不要从仓库安装其他内容:仅在某个步骤需要时,用 curl -fsSL https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/setup-node/<path> -o <scratch>/<file> 下载其链接的文件(例如 scripts/install-node.sh),并且只在执行到某一步时才读取它提到的其他技能,地址为 https://raw.githubusercontent.com/Melvynx/ai-maxxing-skills/main/skills/<skill-name>/SKILL.md。
与用户交流时使用对方语言,消息简短,避免术语(不要对用户说 “PATH”、“prefix” 或 “LTS”)。
适用场景
- 需要 npx、npm install -g 或依赖它们的 CLI 工具正常工作。
- 在 macOS、Linux 或 Windows 上为当前用户配置 Node.js 环境。
- 需要避免管理员权限进行全局安装。
限制
- macOS 上安装 Homebrew 需要用户手动操作并输入一次 Mac 密码,无法由技能自行完成。
- 如果 Mac 账户不是管理员且安装被拒绝,则跳过 Homebrew,并对每个 setup 技能的安装脚本传入
--no-brew。 - 当前会话不会立即看到新安装,需要按上述方式调整环境变量。
- 资料未提供其他平台细节、收费信息或额外功能说明。