用途:为新手安装、验证或按授权更新 Node.js 与 npm,触发说法包括「安装 Node.js」「更新 Node.js」「node 命令不存在」「安装 npm」「npm 超时」。纯网络故障优先交给 soia-env-network-diagnose。
主要能力:识别系统与架构、选择官方 LTS 安装并验证;检查更新时只比较项目约束与最新 Active LTS,不自动更新;npm 不可用时检查 PATH、npm prefix 和权限;为 Codex 准备环境时先验证 Node/npm 再交给相关技能。
使用方式:先说明目标项目、操作系统和是否需要特定 Node 大版本;不确定时默认最新官方 Active LTS。Agent 先检查现有 node、npm 和项目配置,读取 .nvmrc、package.json 的 engines、CI 配置和项目文档,项目约束优先。发现新版本只汇报;只说「更新 Node」时先询问是否更新到最新,客户明确选择后才执行。已安装且满足约束时提示无需重复安装。Homebrew 管理下仅在明确要求后执行 brew update && brew upgrade node;nvm 管理下仅在明确要求后执行 nvm install --lts && nvm alias default 'lts/*' && nvm use --lts;官方安装器则从官方下载页取得目标 LTS 覆盖更新。更新后重新加载 shell,验证 node --version、npm --version、npm config get prefix 和项目版本约束。
适用场景:新机环境搭建、版本检查、npm 阻塞排查、Codex 环境准备。
限制:不混用多个版本管理器,不自动卸载旧版本,不主动使用 sudo,不删除旧 Node,不改项目锁文件,不全局安装业务依赖;禁止未知镜像、修改 TLS 校验或 curl | bash。安装或授权更新时用 scripts/record_install_progress.py 按阶段记录进度,只读检查不落盘。安装命令:claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-env@soia;单技能安装:npx skills add soia-team/soia-open-env-skills -g -a '*' -s soia-env-node-install -y。WorkBuddy 需单独安装,见 docs/install/workbuddy.md。