playwright-best-practices-skill
Playwright测试最佳实践指南库
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：playwright-best-practices-skill。 它的用途是：Playwright测试最佳实践指南库 完整的 Skill 内容见：https://321skill.com/skills/playwright-best-practices-skill/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我为这个登录页面写一个Playwright E2E测试，要包含错误状态和成功跳转的断言。”，它会自动应用技能中关于测试结构、定位器、断言等待等最佳实践，生成健壮且符合规范的测试代码。或者
对AI说：“我的测试在CI中不稳定，经常因为元素加载超时失败，怎么办？”，它会参考调试和等待策略的指南，提供具体的排查步骤和代码优化建议。
介绍
这是一个专为AI助手设计的Playwright测试最佳实践技能库，旨在解决开发者在编写、调试和维护Playwright（TypeScript）测试时缺乏标准化指导的问题。它通过提供结构化的最佳实践文档，帮助AI助手在用户进行相关任务时，自动提供针对性的建议，覆盖E2E、组件、API、视觉回归、无障碍测试等多种场景。
用户无需主动调用技能名称，只需在对话中描述与Playwright测试相关的任务（例如“修复这个不稳定的登录测试”或“添加无障碍测试”），AI助手便会自动激活此技能，并根据上下文从57份分类文档中提取最相关的指导。这使得建议更加聚焦，避免了信息过载。
该技能非常适合前端/全栈开发者、测试工程师以及任何在项目中集成Playwright进行自动化测试的团队成员。无论是编写新测试、重构旧代码、调试失败用例，还是配置CI/CD流水线，都能从中获得专业指导。
与市面上其他零散的Playwright教程或通用测试建议不同，此技能由currents.dev团队维护，内容系统、深入且紧跟官方最佳实践。它并非一个简单的命令集合，而是一个基于活动（activity-based）的智能导航系统，能根据用户当前的具体操作（如处理iframe、模拟地理位置、测试Electron应用等）精准匹配参考资料，提供“对症下药”式的帮助。
核心特点
核心区别在于其“基于活动”的智能触发机制和高度结构化的内容体系。它不像普通技能那样一次性加载所有信息，而是能根据用户当前任务（如“测试文件上传”或“处理OAuth弹窗”）动态匹配最相关的57份细分指南，提供精准、聚焦的建议，而非泛泛而谈。
注意事项
该技能主要专注于Playwright（TypeScript）测试的最佳实践，不适用于其他测试框架（如Cypress、Selenium）或非测试相关的开发任务。
常见问题
如何安装这个Playwright最佳实践技能？
在项目根目录下运行命令：npx skills add https://github.com/currents-dev/playwright-best-practices-skill
我需要每次都告诉AI使用这个技能吗？
不需要。你只需描述测试相关任务（如“修复这个flakey测试”），AI会自动判断并应用技能中的最佳实践。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/playwright-best-practices-skill/raw/index.md 读取 playwright-best-practices-skill 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/playwright-best-practices-skill/raw/index.md（查看排版版本）