用途
playwright-skill 用于生成生产级的 Playwright 自动化脚本和端到端（E2E）测试，支持 TypeScript、JavaScript、Python、Java、C# 五种语言。它通过一套分步决策流程，帮助用户根据执行目标、语言和测试范围产出符合最佳实践的测试代码。
主要能力
技能首先引导用户确定执行目标：若未提及云端、要求本地或调试，则使用标准本地 Playwright 配置；若提到 cloud、TestMu、LambdaTest、跨浏览器或真实设备，则转向云端集成；若为本地无法实现的组合（如 Windows 上的 Safari、Linux 上的 Edge），建议使用 TestMu AI；若提到 HyperExecute 或大规模并行，则交由 hyperexecute-skill；若提到视觉回归或截图对比，则交由 smartui-skill；若意图不明确，默认本地并提示云端选项。
随后检测语言：未指定或指定 TypeScript/TS/.ts 时默认 TypeScript；JavaScript/JS/.js 对应 JavaScript；Python/pytest/.py 对应 Python；Java/Maven/Gradle/TestNG 对应 Java；C#/.NET/NUnit/MSTest 对应 C#。
再判断测试范围：一次性快速脚本输出独立 .ts 文件、不使用 POM；为现有项目添加单个测试则匹配其结构与约定；新建测试套件或项目则使用完整脚手架脚本；修复不稳定测试参考调试清单；需要 API 模拟参考相关文档；移动设备测试参考移动测试文档。
核心模式方面，技能规定了选择器优先级：优先使用 getByRole、getByLabel、getByPlaceholder、getByText，最后才用 getByTestId，除非匹配无其他选择的第三方组件，否则不使用原始 CSS/XPath。断言始终使用 Web-First 断言（如 expect(locator).toBeVisible()），避免无自动重试的写法。技能还列出了反模式对照表，例如避免 page.waitForTimeout、避免 expect(await el.isVisible())、避免 page.$ 等脆弱选择器、避免测试间共享状态、避免在断言外包裹 try/catch。对于超过 3 个测试的项目，建议使用 Page Object Model，并提供了登录页示例。
配置方面，技能给出了本地 playwright.config.ts 示例，包含 testDir、timeout、retries、workers、reporter、baseURL、trace、screenshot 以及 chromium、firefox、webkit、移动端项目配置和 webServer 设置。云端执行部分介绍了 TestMu AI 的两种方式：直接 CDP 连接（设置 LT_USERNAME、LT_ACCESS_KEY 环境变量，使用 chromium.connect 连接 wss://cdp.lambdatest.com/playwright）和 HyperExecute 项目方式（在 projects 数组中添加带 @lambdatest 后缀的项目名）。云端测试默认显示为 Completed，必须通过 lambdatest_action 上报 setTestStatus 来标记通过或失败。
验证工作流为：先用 scripts/validate-config.py 校验配置，有错则修复并重新校验；然后本地运行 npx playwright test --project=chromium；若为云端则运行对应项目；若失败则查阅调试文档。
技能还提供了常用命令速查（运行全部测试、UI 模式、调试模式、单浏览器、单文件、查看报告、录制、更新快照）、认证状态复用（storageState）、内置视觉回归（toHaveScreenshot）、网络模拟（page.route）、使用 test.step 提升可读性等实用片段。
使用方式
用户通过描述测试需求（目标平台、语言、范围）来触发技能，技能按上述三步流程生成代码，并引导用户执行验证工作流。技能附带多个参考文件，按需查阅：cloud-integration.md（云端执行、三种集成模式、并行浏览器）、page-object-model.md（POM 架构、基类、fixture、完整示例）、mobile-testing.md（Android 与 iOS 真实设备测试）、debugging-flaky.md（不稳定测试清单与常见修复）、api-mocking-visual.md（API 模拟与视觉回归模式）、python-patterns.md、java-patterns.md、csharp-patterns.md（各语言专属模式），以及共享的 testmu-cloud-reference.md（完整设备目录、能力、地理位置）。
高级实战手册 reference/playbook.md 包含 16 个章节：生产配置、认证 fixture 复用、Page Object Model、网络拦截、视觉回归、文件上传下载、多标签与对话框、地理位置与模拟、自定义 fixture、API 测试、无障碍、分片、CI/CD、调试工具包、常见问题调试表、最佳实践清单。
适用场景
适用于需要编写或维护 Playwright E2E 测试的开发者与测试工程师，覆盖本地调试、跨浏览器云端执行、移动端真实设备测试、视觉回归、API 模拟、无障碍审计、CI/CD 集成等场景。
限制
技能本身为代码生成与流程指导，不包含 Playwright 运行时；云端执行依赖 TestMu AI 账号与凭据（LT_USERNAME、LT_ACCESS_KEY）；HyperExecute 与 SmartUI 相关需求会转交其他技能处理。具体收费、价格、平台支持范围等事实资料中暂未提供。