1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | cypress-skill-lambdatest-agent-skills |
| 作者/维护者 | TestMu AI（原 LambdaTest） |
| 来源链接 | https://github.com/LambdaTest/agent-skills/tree/main/cypress-skill |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 352（数据来自 GitHub API；为整个合集仓库总量，不代表本技能自身热度） |
| Forks | 69（数据来自 GitHub API，同为合集整体口径） |
| 最新版本 | 1.0（SKILL.md front matter 自述，仓库未发布正式 Release） |
| 安装方式 | 见第 10 章 |
2. 功能介绍与亮点
面向 Cypress（前端生态主流的 E2E 与组件测试框架）生成生产级测试代码的技能，把“命令链写错、选择器脆弱、乱用固定等待”这类常见踩坑变成一套可直接套用的规范写法。
- 核心语法与反模式对照：命令链式写法（
cy.get().type().click()）与“禁止 async/await 混用 cy 命令”“禁止把cy.get()结果赋值给变量”两条 Cypress 特有硬规则并列反例说明；选择器优先级表（data-cy>data-testid> 文本 > ID > class）指导写出不脆弱的定位器。 - 网络拦截与鉴权会话：
cy.intercept()桩数据/等待真实请求两种模式的完整示例，cy.session()跨测试复用登录态的标准写法，替代逐条重复登录的低效模式。 - 本地与云端双执行路径：本地
npx cypress open/run一键跑通；也给出 TestMu AI 云端矩阵（lambdatest-cypress-cli）的可选配置，云端凭据经环境变量注入（LT_USERNAME/LT_ACCESS_KEY），非核心路径必需。 - 一键脚手架脚本：
scripts/scaffold-project.sh一条命令生成可运行的 Cypress 项目骨架（含cypress.config.js、示例用例），已逐行核实，仅执行标准npm init/npm install cypress，无可疑行为。 - 深度 Playbook：
reference/playbook.md（13.0 KB，15 个专题）覆盖生产级配置、Page Object 模式、组件测试（React/Vue）、时间控制、iframe/Shadow DOM、可访问性测试（cypress-axe）、视觉回归（Percy）、CI/CD 矩阵等；另有 4 份聚焦参考文档（云端集成、组件测试、自定义命令、flaky 调试）。SKILL.md（6.9 KB）+ 5 份 reference（18.5 KB）+ 脚本与模板（1.3 KB）合计约 26.8 KB。
3. 适用场景
所属分类：工程效率与代码质量
前端项目（React/Vue/Angular 或原生 JS）中需要 AI 编码助手产出规范化 E2E 与组件测试代码的初中级开发者，尤其是已决定使用 Cypress（而非 Selenium/Playwright）作为测试框架的团队；也适用于需要跨浏览器云端矩阵测试、但不想手写 LambdaTest 云端配置细节的用户。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。SKILL.md 采用标准 Agent Skills 格式，仓库提供配套的官方安装工具。
- Codex：❓ 未验证——仓库 README 列出的受支持助手为 “Claude Code, GitHub Copilot, Cursor, Gemini CLI”，未点名 Codex。
- OpenClaw：❓ 未验证——已抓取材料未提及。
- Hermes Agent：❓ 未验证——已抓取材料未提及。
5. 推荐理由
一份把 Cypress 命令链特有的坑（禁止 async/await、禁止变量赋值 cy 命令）、选择器优先级、网络拦截桩数据与 cy.session() 鉴权复用讲透的技能，附一键脚手架脚本、组件测试与可访问性/视觉回归等进阶专题，核心本地路径零付费依赖、脚本内容已逐行核实无可疑行为，安全面干净。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | TestMu AI（原 LambdaTest）是该领域公认的一线测试云平台：累计融资 1.08 亿美元（8 轮，最近一轮 2024 年 Avataar Venture Partners 领投的 3800 万美元 C 轮），18,000+ 企业客户（含 Microsoft、OpenAI、Nvidia），Forbes 2026-01-12 有专文报道。合集仓库整体 352 stars 属整个合集，不代表本技能自身热度，未查到本技能自身的独立第三方评价 |
| 可用性 | 8 | 本地路径一条脚手架命令即可生成可运行项目（scaffold-project.sh 已核实内容安全），或 npx cypress open 直接起步；文档完整，5 份参考文档 + 15 专题 Playbook 覆盖从基础语法到 CI/CD 集成，内容量约 26.8 KB；子目录最后提交约 2026-02-23（约 5.7 个月前），未见归档或功能性问题；云端矩阵为可选付费增值项，不影响核心免费使用 |
| 安全性 | 9 | 唯一脚本 scaffold-project.sh 已逐行核实，仅执行标准 npm init/npm install，无可疑行为、无隐蔽外发；云端凭据通过环境变量注入、全程透明；License（MIT）明确 |
安全检查清单：① Shell 命令——仅 scaffold-project.sh 一个脚本，执行范围明确（创建目录、npm install cypress），已逐行核实无可疑行为；② 联网外发——本地路径无外发，云端路径为用户主动选择的 LambdaTest 官方测试云服务，目标透明；③ 凭据——云端可选功能需 LT_USERNAME/LT_ACCESS_KEY，经环境变量注入，未见明文硬编码；④ 可疑指令——未发现；⑤ 作者信誉——TestMu AI，融资/客户量/媒体报道均可查证，良好；⑥ License——MIT，明确；⑦ 最近维护——约 2026-02-23，约 5.7 个月前，未见归档。
7. 跟同类 Skills 相比的优势
| 同类项目 | 定位 | 与本技能的差异 |
|---|---|---|
| selenium-skill-lambdatest-agent-skills | 同池姊妹技能，面向 Selenium WebDriver，支持 6 种语言的浏览器自动化 | Selenium 走 WebDriver 协议、多语言绑定，适合跨语言团队与遗留浏览器矩阵；Cypress 仅限 JS/TS 但运行在浏览器内部，调试体验与自动重试机制是其相对优势，两者是并行独立维护的框架而非替代关系 |
| playwright-e2e-testing-fugazi-test-automation-skills-agents | 独立作者出品，面向 Playwright 的 E2E 测试技能 | Playwright 由微软维护、原生支持多浏览器引擎并行与自动等待；Cypress 生态更聚焦 Chromium 系且强调“运行在浏览器内”的调试可视化，两者是市场上并行流行的不同底层技术选型 |
| test-framework-migration-skill-lambdatest-agent-skills | 同池姊妹技能，专注不同测试框架间的迁移路径 | 提供框架间迁移的通用指导；本技能专注 Cypress 本身语法与最佳实践的原生产出，非迁移场景 |
核心差异化在“浏览器内运行 + 自动重试”的调试体验：Cypress 命令在浏览器进程内直接执行并自动重试断言，配合时间旅行调试（Time Travel）与内建截图/视频，比 WebDriver 协议类框架的排错链路更短；本技能把命令链反模式、网络拦截桩数据与 cy.session() 鉴权复用这三个 Cypress 特有的高频踩坑点整理成同一套可直接套用的规范，对已选定 Cypress 的前端团队针对性更强。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；LambdaTest/agent-skills 仓库整体在 GitHub 上有真实的多贡献者协作记录（近期合并的 PR 涉及 SmartUI CLI 版本更新、accessibility 技能新增、HyperExecute 技能更新等）。
9. 其他补充
- 支持语言：JavaScript、TypeScript。
- 组件测试（React/Vue）单列一份参考文档，覆盖挂载、stub 与变体测试，不与 E2E 测试正文混杂。
- 可访问性测试（cypress-axe）与视觉回归测试（Percy/cypress-image-snapshot）作为 Playbook 独立专题给出，多数入门教程不会覆盖。
10. 安装使用方式
方式一：官方 CLI（仓库推荐）
git clone https://github.com/LambdaTest/agent-skills && cd agent-skills
npx agentskillsforall add https://github.com/LambdaTest/agent-skills.git --skill cypress-skill方式二：手动复制
git clone https://github.com/LambdaTest/agent-skills
cp -r agent-skills/cypress-skill ~/.claude/skills/方式三：一键脚手架（在目标项目目录外运行，生成独立的 Cypress 示例项目）
bash agent-skills/cypress-skill/scripts/scaffold-project.sh my-cypress-project安装后注意事项：复制到位后无需重启，Agent 会在识别到 “Cypress”、“cy.”、“E2E test”、“component test” 等触发词时自动读取本技能内容；云端矩阵功能需自行注册 LambdaTest/TestMu AI 账号并配置 LT_USERNAME/LT_ACCESS_KEY，非本地测试的必需项。
11. 注意事项
- 本技能仅支持 JavaScript/TypeScript，不支持其他语言绑定（如需 Python/Java/C# 测试代码生成，需选用 Selenium 等多语言框架技能）。
- Cypress 架构上不支持跨域多标签页测试（如需测试多个不同源标签页交互，需评估 Playwright 等替代方案）。
- 云端矩阵测试（TestMu AI）为可选付费增值服务，核心本地测试功能完全免费。
- 子目录最后提交约在 2026-02-23，约 5.7 个月前，暂未发现功能性问题，但关注长期维护节奏的团队可留意后续更新频率。