steelan9199/node-version-compatibility-tester

🎯 触发映射

| 用户输入触发词 | AI 执行动作 | | ---------------------------------------------------------- | ------------------------ | | "测试Node版本兼容性" / "多版本Node测试" / "技能兼容性测试" | 按【兼容性测试模式】执行 |

必须测试的三个nodejs版本号

• 20.20.1
• 22.22.1
• 24.14.0

【兼容性测试模式】

执行步骤

| 步骤 | 执行动作 | 具体命令/操作 | | ---- | ------------ | ------------------------------------------------------------------------------------------------ | | 1 | 检查环境 | 运行 RunCommand 执行 nvm list，确认已安装需要测试的Node.js版本 | | 2 | 确认测试范围 | 用户指定要测试的技能路径和Node.js版本列表（默认测试3个LTS版本：20.20.1, 22.22.1, 24.14.0） | | 3 | 切换Node版本 | 运行 RunCommand 执行 nvm use <version> 切换到对应Node.js版本 | | 4 | 执行测试 | 查看目标技能的文档, 统计有多少功能, 对每个功能执行实际运行测试, 参考下方的[如何进行实际运行测试] | | 5 | 记录测试结果 | 将每个版本的测试结果（成功/失败、错误信息）记录到临时文件 | | 6 | 生成报告 | 汇总所有版本的测试结果，生成兼容性测试报告 |

⚠️ 执行测试规范（强制遵守）

禁止使用 node --check 语法检查！必须进行实际功能测试！

| 判定 | 操作方式 | 说明 | | ------- | ---------------------------------------------- | ------------------------------ | | ✅ 正确 | 按照目标技能的文档，对每个功能执行实际运行测试 | 真实运行技能功能，验证实际效果 | | ❌ 错误 | 使用 node --check 对代码进行基础检查 | 仅做语法检查，不验证实际功能 |

如何进行实际运行测试

步骤 4 的详细执行流程：

第一步：动态分析目标技能

读取 {目标技能路径}/SKILL.md
    │
    ├─ 提取功能列表 → 从"触发映射"表或"操作接口"表中获取
    │
    ├─ 提取脚本路径 → 识别 scripts/ 目录下的所有可执行文件
    │
    └─ 分析凭证需求 → 检查是否需要 token、apiKey、secret 等外部凭证

第二步：分类处理功能

| 功能类型 | 识别特征 | 测试方式 | | -------------- | --------------------------- | -------------------------- | | 本地处理类 | URL解析、文件转换、格式处理 | 构造示例参数，直接执行测试 | | API调用类 | 需要 token、apiKey、secret | 询问用户是否提供凭证 | | 交互类 | 需要用户输入 | 使用模拟输入执行测试 |

第三步：阅读文档并执行测试

对于每个功能，AI 必须：

1. 仔细阅读目标技能的 SKILL.md 文档

   • 找到该功能的调用方式（命令格式、参数格式）
   • 理解该功能需要什么输入参数
   • 确认是否需要外部凭证

2. 按照文档说明构造测试参数

   • 参考文档中的示例
   • 对于需要凭证的功能，使用 AskUserQuestion 询问用户

3. 按照文档说明的方式执行脚本

   • 不要假设命令格式，必须从文档中学习
   • 不同技能可能有不同的调用方式：
     • node scripts/xxx.js --parameter-file-path params.json
     • python scripts/xxx.py --config config.yaml
     • node scripts/xxx.js --input "data"
     • 或其他文档中定义的方式

4. 记录实际输出：成功/失败 + 错误信息

第四步：处理凭证需求

功能需要凭证？
    │
    ├─ 是 → 使用 AskUserQuestion 询问：
    │       "测试 {功能名} 需要 {凭证类型}，是否提供测试凭证？"
    │       │
    │       ├─ 用户提供 → 使用凭证构造参数，执行测试
    │       │
    │       └─ 用户不提供 → 标记为"跳过（缺少凭证）"
    │
    └─ 否 → 直接构造测试参数并执行

测试参数构造指南

| 功能类型 | 测试参数构造方式 | | ---------- | --------------------------------------------------- | | URL解析类 | 使用示例 URL：{"url": "https://example.com/path"} | | 文件操作类 | 创建临时文件，传入文件路径 | | 格式转换类 | 使用示例数据：{"input": "test data"} | | API调用类 | 需要用户提供真实凭证 |

凭证处理策略

当目标技能需要外部 API 凭证时，按以下流程处理：

功能需要凭证？
    │
    ├─ 是 → 询问用户："测试 {功能名} 需要 {凭证类型}，是否提供测试凭证？"
    │       │
    │       ├─ 用户提供凭证 → 使用凭证执行测试
    │       │
    │       └─ 用户不提供 → 标记为"跳过（缺少凭证）"，继续测试其他功能
    │
    └─ 否 → 直接执行测试

输出结果

成功时输出示例：

✅ Node.js版本兼容性测试完成

📊 测试结果汇总：
| Node.js版本 | 功能1 | 功能2 | 功能3 | 状态 |
|------------|-------|-------|-------|------|
| 20.20.1    | ✅ 通过 | ✅ 通过 | ✅ 通过 | 完全兼容 |
| 22.22.1    | ✅ 通过 | ✅ 通过 | ✅ 通过 | 完全兼容 |
| 24.14.0    | ✅ 通过 | ✅ 通过 | ✅ 通过 | 完全兼容 |

✅ 结论：该技能完美支持所有测试的Node.js LTS版本

📝 下一步：可以根据测试结果更新技能的环境要求说明

失败时输出示例：

❌ Node.js版本兼容性测试发现问题

📊 测试结果汇总：
| Node.js版本 | 功能1 | 功能2 | 功能3 | 状态 |
|------------|-------|-------|-------|------|
| 20.20.1    | ❌ 失败 | -     | -     | 不兼容 |
| 22.22.1    | ✅ 通过 | ✅ 通过 | ✅ 通过 | 完全兼容 |
| 24.14.0    | ✅ 通过 | ✅ 通过 | ✅ 通过 | 完全兼容 |

❌ 问题说明：Node.js 20.20.1版本下功能1失败，错误信息：模块找不到
解决建议：检查技能依赖是否兼容Node.js 20.x版本，或者更新依赖配置

错误处理

| 错误场景 | 错误表现 | 处理方式 | | ---------------- | --------------------------------- | ------------------------------------------ | | nvm未安装 | 执行nvm list报错 | 提示用户安装nvm Node版本管理工具 | | 测试版本未安装 | nvm list中没有用户指定的Node版本 | 询问用户是否安装对应版本，或者更换测试版本 | | Node版本切换失败 | nvm use <version>返回非零退出码 | 检查nvm配置，重试切换，或跳过该版本 | | 技能运行报错 | 测试过程中技能执行失败 | 记录完整错误信息，继续测试其他版本 |

如何使用这个 Skill

本技能是一个通用测试工具，可以测试任意用户指定的技能在不同 Node.js 版本下的兼容性。

通用使用模板

用户输入格式：

对技能 {目标技能路径} 进行 Node.js 版本兼容性测试

AI 执行流程：

| 步骤 | AI 行为 | 具体操作 | | ---- | ---------------------- | ----------------------------------------------------- | | 1 | 读取目标技能文档 | 读取 {目标技能路径}/SKILL.md | | 2 | 提取功能列表 | 从文档中识别所有功能模块和对应的脚本/命令 | | 3 | 分析凭证需求 | 判断每个功能是否需要外部 API 凭证 | | 4 | 询问用户（如需要凭证） | "测试 {技能名} 需要 {凭证类型}，是否提供测试凭证？" | | 5 | 执行测试 | 对每个功能执行实际运行测试（禁止使用 node --check） | | 6 | 生成报告 | 汇总各 Node.js 版本的测试结果 |

测试执行要点

对于每个目标技能，AI 必须：

1. 阅读目标技能的 SKILL.md 文档

   • 提取功能列表和脚本路径
   • 学习每个功能的调用方式（命令格式、参数格式）

2. 不要假设命令格式

   • 不同技能有不同的调用方式
   • 必须从目标技能的文档中学习正确的调用方式

3. 构造测试参数

   • 根据目标技能文档中的示例构造参数
   • 对于需要凭证的功能，询问用户

4. 执行真实测试

   • 按照文档说明的方式运行脚本
   • 记录实际输出（成功/失败 + 错误信息）

示例：测试任意技能

用户输入：

对技能 skills\wechat-publisher-yashu 进行 Node.js 版本兼容性测试

AI 执行：

1. 读取 skills\wechat-publisher-yashu\SKILL.md
2. 从文档中学习每个功能的调用方式
3. 切换 Node 版本，按文档说明执行测试
4. 记录结果，切换下一个版本继续测试

示例：测试需要凭证的技能

用户输入：

对技能 skills\feishu-bitable 进行 Node.js 版本兼容性测试

AI 执行：

1. 读取 skills\feishu-bitable\SKILL.md，学习调用方式
2. 发现需要飞书 API 凭证，使用 AskUserQuestion 询问用户
3. 根据用户选择执行测试或跳过需要凭证的功能

用户可以使用类似下面的提示词使用该技能

使用当前项目中的技能skills\node-version-compatibility-tester, 对当前项目中的技能 skills\feishu-bitable 进行 Node.js 版本兼容性测试