📌 playwright-best-practices 是什么?

Playwright 测试写不好,又慢又脆——偶发失败、定位失效、等待靠猜。playwright-best-practices 是配套技能,让 AI 按最佳实践写稳定可靠的测试。

它把"写稳测试"的经验(稳定的定位策略、正确的等待机制、合理的组织)整理成规范。

🧩 核心功能

定位策略:用稳定的选择器定位元素。

等待机制:正确处理等待,避免 flaky。

测试组织:fixture、钩子、数据管理。

可维护性:写易维护的测试代码。

👍 优点

稳定:少偶发失败。

可维护:测试代码清晰。

高效:跑得快。

⚠️ 不足与局限

前期要花时间搭结构。

过度优化会增加复杂度。

需结合项目调整。

🙋 适合谁用

测试工程师:写稳定的端到端测试。

开发者:自测关键流程。

🛠️ 第一次安装

前提:电脑装了 Node.js(18+),有支持 Skill 的 AI 工具(如 Claude Code)。打开终端执行:

bash
npx skills add currents-dev/playwright-best-practices-skill --skill playwright-best-practices

CLI 会自动检测你装的 AI 助手,确认安装位置后即可使用。

✍️ 上手:几个真实例子

场景一:重构

提示词
帮我按最佳实践重构这组 Playwright 测试,减少偶发失败。

场景二:定位

提示词
帮我用稳定的 data-testid 定位重构这些选择器。

🎯 典型应用场景

端到端测试:写稳定测试。

重构:优化脆弱测试。

定位:稳定选择器。

⚖️ 和类似方案对比

和"随便写写能跑就行"相比,best-practices 的价值是"稳定"——测试最大的成本不是写,而是偶发失败后的排查。按最佳实践写,测试就少 flaky、好维护,长期看省大量时间。

💡 常见问题 FAQ

问:为什么用 data-testid?
它不受样式、文案变化影响,最稳定。

问:要写硬 sleep 吗?
不要,用自动等待,硬 sleep 又慢又脆。

问:测试数据怎么管?
用 fixture 或工厂,别在测试里硬编码。

问:多久跑一次?
提交时跑关键用例,完整套件进 CI。

🤖 适合哪些 AI 工具

Claude Code、Cursor、Codex 等支持 Skill 的工具都能装。