一个简单适配个人电脑的node 版本切换 skill

aoi2026-02-28 11:33

以下是一个个人电脑的 node 版本切换 skill，当一些项目在运行的时候遇到了版本问题，让 AI agent 能够知道我的切换命令，避免 node 版本问题而重复对话浪费 token

发现 skill 就是把简单的操作文本化到markdown，让AI 能知道电脑环境、项目、口口相传的内容

很明显的它具有专属性质，每个人的电脑和项目都不一样：

markdown 复制代码

    ---
    name: fnm-node-version
    description: Resolves Node.js version issues by switching versions with fnm (Fast Node Manager). Use when encountering Node version errors, "engine" requirements, unsupported Node versions, or when the user mentions Node version problems. Available versions on this machine: 14, 16, 18, 20.
    ---

    # Node 版本与 fnm

    本机已安装 **fnm**（Fast Node Manager）。遇到 Node 版本相关问题时，用 fnm 切换到对应版本即可

    ## 何时使用

    - 报错提示 Node 版本不满足要求（如 `engine "node": ">=18"`）
    - `npm install` 或构建失败与 Node 版本有关
    - 用户提到「Node 版本」「需要换 Node」等

    ## 可用版本

    当前环境已安装的 Node 主版本：

    | 版本 | 使用场景示例 |
    |------|----------------|
    | 14   | 旧项目、Legacy 依赖 |
    | 16   | 常见 LTS 项目 |
    | 18   | 较新 LTS |
    | 20   | 最新 LTS，推荐新项目 |

    ## 操作步骤

    1. **查看当前版本**
       ```bash
       node -v
       ```

    2. **用 fnm 切换到指定版本**（在项目目录或任意目录执行）
       ```bash
       fnm use 18
       ```
       或指定主版本让 fnm 选该主版本下已安装的最新：
       ```bash
       fnm use 20
       ```

    3. **确认切换结果**
       ```bash
       node -v
       npm -v
       ```

    4. **若该版本未安装**，先安装再切换：
       ```bash
       fnm install 18
       fnm use 18
       ```

    ## 常用命令速查

    - `fnm list` --- 列出已安装的 Node 版本
    - `fnm use <version>` --- 当前 shell 使用指定版本（如 `fnm use 18`）
    - `fnm install <version>` --- 安装指定版本
    - 若项目根目录有 `.nvmrc` 或 `.node-version`，可执行 `fnm use`（无参数）自动使用文件中声明的版本

    在同一终端里执行 `fnm use` 后，该终端后续的 `node`/`npm` 都会使用切换后的版本；新开的终端需再次执行 `fnm use`，或在项目里配置 `.node-version` 以便自动切换