Playwright 开发指南
指导开发者为 Playwright 添加 API、MCP 工具、CLI 命令及浏览器相关依赖。
内容主要指导代码修改、依赖安装、浏览器下载、直接编辑已发布包以及向 GitHub 发布评论；虽未发现恶意代码、凭据窃取或隐蔽外传，并提示不要未经检查删除目录，但缺少统一的用户确认、权限边界、敏感数据处理、外部副作用说明和可验证回滚流程，因此扣分。
文档覆盖架构、API、MCP/CLI、测试和依赖流程，包含具体路径、命令及错误用例；但本次未执行验证，且部分内容可能过时或存在脆弱假设，例如 trace_system_guide 使用绝对本地路径、内容不完整，多个指南依赖未提供的仓库文件，因此未超过静态上限并扣分。
目标受众和主要场景较清楚，包括新增 API、MCP 工具、CLI、依赖和回归二分；但没有明确触发条件、非适用边界或输入输出契约，主要面向英文开发者并假设可访问 npm、GitHub、浏览器下载服务和完整 monorepo 环境，未证明对中文或中国大陆网络环境的适配，因此扣分。
信息按主题拆分，具备目录、步骤、示例、测试位置和部分限制说明；但缺少该技能自身的版本、变更记录、维护责任和更新路径，存在重复内容及潜在陈旧/不一致的 trace 文档，许可证和出版者信息仅由外部元数据提供，故未给高分。
针对 Playwright 内部开发任务提供了较直接的实施路径、代码模式、测试模板和命令，核心任务大概率可据此推进；但静态阅读没有验证代表性输出，部分步骤依赖隐含仓库状态或外部服务，仍需用户自行核对和修正，因此按静态上限保守扣分。
文档包含具体文件路径、协议格式、测试样例和命令，提供一定审计线索；但选定技能材料没有提交的 CI 结果、测试套件执行证据或独立复核记录，关键结论主要是作者说明，因此仅给有限静态可验证性。
- 执行 npm install、npx playwright install、浏览器启动、后台服务器或 gh issue comment 前，应明确确认网络访问、下载内容和外部发布范围。
- 不要把 trace_system_guide 中的绝对本地路径、版本信息或未完整内容视为已验证事实；应回到当前修订版仓库核对。
- 该技能默认面向 Playwright monorepo 开发，不能直接替代面向普通用户的 Playwright 使用指南；npm、GitHub 和浏览器下载可受中国大陆网络限制影响。
这个 Skill 能做什么，适合哪些场景？
这是 Playwright 单仓库中的一个开发型 Agent Skill，专门指导 Playwright 本身的工程开发，而不是通用的网页测试操作。它覆盖客户端、服务端、调度器和协议层架构，以及 API、MCP 工具、CLI 命令和依赖打包的修改流程。指南还涉及 WebKit Safari 版本、iOS Safari WebView 后端、已发布版本回溯和 Dashboard。它适合需要维护或扩展 Playwright 源码的工程师。
读取并引用 Playwright 仓库中的 CLAUDE.md 和多个专题指南，帮助规划和实施 API、MCP 工具、CLI 命令、配置选项、供应商依赖、WebKit 版本、WebView 后端、版本回溯及 Dashboard 的开发工作。SKILL.md 本身没有展示具体脚本、命令或测试执行步骤。
- Playwright 维护者需要新增浏览器自动化 API，并同时处理客户端、服务端、协议层和测试。
- 工程师需要向 Playwright 添加 MCP 工具或 CLI 命令及相关配置选项。
- 贡献者需要引入或更新打包的 npm 依赖，并遵循 DEPS.list 和 check_deps 规则。
- WebKit 相关开发者需要更新 Safari 版本字符串或调整 iOS Safari WebView 后端。
- 维护者需要在多个已发布 npm 版本之间复现并定位回归问题。
这个 Skill 有哪些优点和局限？
- 覆盖 Playwright 核心架构、API、MCP、CLI、依赖和多个专项维护场景。
- 明确将实现、文档、测试及依赖规则关联起来。
- 适合 Playwright 仓库贡献和维护工作，而非泛化描述。
- SKILL.md 只提供指南索引，具体规则依赖未提供的 CLAUDE.md 和专题文档。
- 没有证据表明它能独立执行构建、测试或代码修改。
- 范围集中于 Playwright 源码开发，不适合仅使用 Playwright 编写测试或自动化脚本的用户。
如何安装这个 Skill？
该 Skill 位于 https://github.com/microsoft/playwright 的 .claude/skills/playwright-dev/SKILL.md。使用时保留该文件及其相对路径，以便访问同目录引用的开发指南。README 说明的 Playwright 集合安装方式包括 npm init playwright@latest、npm i -D @playwright/test 后运行 npx playwright install，以及 npm i playwright；这些是 Playwright 产品的安装方式，不是该开发 Skill 的独立安装命令。
如何使用这个 Skill？
在包含 Playwright 源码的工作区中启用该 Skill，并提出具体开发任务，例如：“为 Playwright 添加一个 API，按照 playwright-dev 指南完成客户端、服务端、协议层和测试的修改。”随后根据任务阅读对应的 library.md、api.md、tools.md、vendor.md、webkit-safari-version.md、webview.md、bisect-published-versions.md 或 dashboard.md。