test-framework-migration-skill-lambdatest-agent-skills

1. 基本信息

2. 功能介绍与亮点

这是一个专门做测试自动化框架互相迁移的技能：在 Selenium、Playwright、Puppeteer、Cypress 四个主流框架之间，覆盖两两互转的全部 10 个方向，每个方向都配一份独立的迁移参考文档。

• 五维度映射表：每份迁移文档都按 Locator（定位器）、Wait（等待策略）、Action（操作）、Assertion（断言）、Lifecycle（生命周期）五个维度给出源框架 API 与目标框架 API 的一一对照表。
• 真实前后代码对照：每个方向都附完整的 Before/After 代码片段，而不是只给映射表。
• 语义级迁移，不是文本替换：官方博客举例说明，迁移到 Playwright 时，该技能会主动去掉源代码里所有 WebDriverWait/ExpectedConditions 显式等待调用，因为 Playwright 对每个操作都自带自动等待——这是理解目标框架语义后的改写，不是简单的关键词替换。
• 常见坑清单：每份文档末尾列出该迁移方向的典型陷阱（如 Selenium 转 Playwright 后语言习惯从 Java/Python/C# 切到 TypeScript/JavaScript、多窗口切换 API 差异等）。
• 纯参考文档形态：技能子目录内只有 Markdown 参考文件，不含任何脚本或可执行代码。
• 出自 TestMu AI（原 LambdaTest）官方仓库，与该公司同仓库内的 playwright-skill、selenium-skill、cypress-skill、puppeteer-skill 等姊妹技能共享同一套云集成参考资料。

3. 适用场景

所属分类：工程效率与代码质量

典型场景是团队要把已有的自动化测试套件从一个框架搬到另一个框架——例如把遗留的 Selenium 测试迁移为 Playwright，这是当前 QA 行业里相当常见的现代化诉求；也适用于在正式动手迁移前，先评估两个框架之间的 API 差异与工作量。受益人群是负责维护自动化测试套件的 QA 工程师、SDET，以及需要顺手处理测试代码的前后端工程师。

4. 跨 Agent 兼容性

• Claude Code：✅ 原生支持。官方博客给出的安装路径为 .claude/skills/。
• Codex：✅ 官方材料确认支持。官方博客原文列出 “Claude Code, GitHub Copilot, Cursor, OpenAI Codex, Gemini CLI, and 20+ other agents”，但未单独给出 Codex 专属安装路径细节。
• OpenClaw：❓ 未验证——已抓取材料未提及。
• Hermes Agent：❓ 未验证——已抓取材料未提及。

5. 推荐理由

省去手工逐行翻 API 文档做框架迁移的功夫：10 份迁移文档把 Locator/Wait/Action/Assertion/Lifecycle 五个维度的映射关系、真实前后代码对照、常见坑一次性配齐，比零散的迁移博客更系统。技能本身零代码执行、零外部依赖，装上即用，不需要额外账号或付费服务就能直接产生价值。

6. 评分

安全检查清单： ① Shell 命令执行——无，该子目录不含 scripts/ 或 templates/，没有任何可执行文件； ② 联网外发数据——无，纯静态参考文档； ③ API key/凭据——不需要（涉及云端执行的姊妹技能才需要，本技能自身不需要）； ④ 可疑指令——未发现，内容为标准 Markdown 表格与代码示例，无隐藏指令或混淆内容； ⑤ 作者/组织信誉——TestMu AI（原 LambdaTest），累计融资 1.08 亿美元、获 TechCrunch 报道、15,000+ 企业客户，信誉良好； ⑥ License——MIT，明确； ⑦ 最近维护——本子目录 2026-04-19 有最后一次实质提交，仓库整体在 2026-07-24 仍有其他文件的推送，未见归档迹象。

7. 跟同类 Skills 相比的优势

同类的单框架测试生成技能（如专注“从零写好一份 Playwright 测试”的独立作者出品）解决的是编写场景，不覆盖“把已有测试从一个框架搬到另一个框架”这条路径，二者服务的诉求不同。

社区里另有不少一次性的框架迁移博客或个人转换脚本，通常只覆盖单一方向（比如只讲 Selenium→Playwright），缺少 Puppeteer、Cypress 方向的对称覆盖，也没有统一的常见坑清单，且往往做的是关键词级替换而非理解目标框架语义后的改写。本技能一次覆盖 4 个框架两两之间共 10 个方向，每个方向都配 Locator/Wait/Action/Assertion/Lifecycle 五维度映射表与真实前后代码对照，颗粒度和覆盖面在同类参考资料里少见。

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。

9. 其他补充

• 支持语言：Java、Python、JavaScript、TypeScript、C#（覆盖四个源框架各自的主流语言绑定）。
• 该技能与同仓库的 playwright-skill、selenium-skill、puppeteer-skill、cypress-skill 互为姊妹技能，迁移文档中会交叉引用对方的云集成参考，但迁移本身的核心映射内容是自包含的，不依赖姊妹技能即可使用。
• 仓库内含 CONTRIBUTING.md，接受社区提交新的迁移方向（如补充 WebdriverIO）。

10. 安装使用方式

方式一：官方 CLI（仓库推荐）

git clone https://github.com/LambdaTest/agent-skills && cd agent-skills
npx agentskillsforall add https://github.com/LambdaTest/agent-skills.git --skill test-framework-migration-skill

方式二：手动复制（本技能不含任何脚本，直接复制目录即可，无需安装依赖）

git clone https://github.com/LambdaTest/agent-skills
cp -r agent-skills/test-framework-migration-skill ~/.claude/skills/

安装后注意事项：本技能纯粹是参考文档，复制到位后 Agent 会在识别到“migrate”“convert”“selenium to playwright”等触发词时自动读取，无需重启、无需额外配置。若用户提到目标框架涉及云端执行（TestMu AI cloud），Agent 会引导去看姊妹技能（如 playwright-skill）里的云集成文档——这部分才需要 LT_USERNAME/LT_ACCESS_KEY 环境变量，与本技能自身的迁移功能无关。

11. 注意事项

• 本技能只覆盖 Selenium、Playwright、Puppeteer、Cypress 四个框架之间的迁移；其他框架（如 WebdriverIO、TestCafe）不在当前 10 个方向之内。
• 若源测试用 Java/Python/C# 写的 Selenium，迁移到 Playwright 时官方建议改用 TypeScript/JavaScript（Playwright 生态更成熟的语言），这意味着语言也会跟着换，不是纯框架层面的转换。
• 复杂测试（涉及大量自定义等待逻辑、第三方插件）迁移后仍建议人工复核，文档本身也在 Gotchas 部分提示不能全自动信任转换结果。