Playwright Trace CLI
在命令行中解析 Playwright 测试追踪，快速定位操作、网络和页面错误。
技能仅声明可使用 Bash(npx:*)，权限范围相对收敛，并提供 trace close 清理提取数据；但未要求用户确认，未说明 trace 中请求、响应、控制台和附件可能包含敏感信息，也未披露 npx 包解析与网络数据流风险，因此扣分。
工作流和命令命名基本一致，覆盖打开、查询、快照和关闭；但依赖未固定版本，未说明无效 ZIP、缺失 action、浏览器不可用或命令失败时的诊断与恢复，且仅凭静态文件无法确认命令实际存在或可运行，因此扣分。
目标场景、输入 trace ZIP、主要查询类型和快照输出形式较清楚；但未定义不适用范围、触发边界、环境要求或中文使用支持，且 npx 依赖网络可达性，面向中国大陆用户的可用性证据不足，因此扣分。
文档结构清晰，包含参数示例、典型调查流程和清理命令；仓库提供 Apache-2.0、版本、Microsoft 归属、README 和发布资源线索，但技能本身缺少安装说明、版本兼容矩阵、已知限制、FAQ、变更记录和维护更新路径，因此扣分。
命令覆盖动作、请求、控制台、错误、快照和附件等核心排查任务，预期输出可直接用于调查；但静态材料未验证这些命令的实际结果、边界行为或相对手工/Trace Viewer 的收益，且错误场景仍需人工处理，因此未给满分。
技能提供了具体命令和可复查的仓库修订背景，README 也证明 Playwright 具备 tracing 相关能力；但未提供针对该 CLI 关键路径的提交测试、CI 执行结果或第三方复现证据，故仅给有限分数。
- trace 文件可能包含请求头、请求体、页面内容、控制台信息、截图和附件；使用前应确认数据敏感性并避免将输出暴露给不可信环境。
- npx 未固定版本且可能需要联网解析包；在中国大陆或受限网络环境中可能无法可靠启动，建议使用已安装且版本匹配的 Playwright CLI 并核对版本。
- 文档未说明失败处理、浏览器依赖和快照 eval 的限制，异常输入或复杂 trace 可能需要回退到 Trace Viewer 或人工排查。
这个 Skill 能做什么，适合哪些场景？
Playwright Trace CLI 用于检查 Playwright 测试生成的 ZIP 追踪文件，无需打开浏览器。它可以展示追踪元数据、操作树、请求、控制台消息、错误、DOM 快照、截图和附件。使用 `open` 打开追踪后，后续命令会作用于当前追踪；打开新追踪会替换当前追踪。该技能适合已经使用 Playwright 并需要命令行调查测试失败的开发者。
通过 npx playwright trace 打开并提取 .zip 追踪文件，显示浏览器、视口、耗时及操作或错误数量；列出和筛选操作；查看单个操作的参数、日志、源码位置和快照；列出或筛选网络请求、控制台输出和错误；加载指定操作的 DOM 快照并获取无障碍快照、执行 DOM 查询或生成截图；列出和提取附件；最后删除已提取的追踪数据。
- 负责端到端测试的开发者在测试失败后，用 `actions --errors-only` 找出失败操作。
- 调试接口问题的工程师用 `requests --failed` 或按 URL、HTTP 方法筛选请求。
- 排查浏览器报错的测试人员用 `console --errors-only` 和 `errors` 查看控制台信息及堆栈。
- 需要还原失败时页面状态的开发者用 `snapshot <action-id>` 查看指定操作前后的 DOM 或截图。
- 需要检查测试产物的自动化工程师用 `attachments` 和 `attachment` 提取追踪附件。
这个 Skill 有哪些优点和局限？
- 覆盖操作、请求、控制台、错误、DOM 快照、截图和附件等多种追踪信息。
- 支持按操作标题、失败状态、URL、HTTP 方法和错误状态筛选。
- 通过 `eval` 查询冻结快照中的 DOM，便于定位具体页面内容。
- 命令行工作流适合测试失败排查和自动化环境。
- 只能处理 Playwright 生成的追踪 ZIP 文件，不能替代完整的浏览器自动化或测试运行器。
- 每次只维护一个当前打开的追踪，打开新追踪会替换之前的追踪。
- 技能只明确允许 `Bash(npx:*)`，其他客户端可能需要调整工具权限配置。
- 源材料没有提供该技能自身的测试套件、独立版本信息或跨平台验证证据。
如何安装这个 Skill？
README 说明，Playwright CLI 可通过 npm install -g @playwright/cli@latest 安装，并可用 playwright-cli install --skills 安装技能。该仓库未说明如何将此单个 SKILL.md 独立放置或安装。
如何使用这个 Skill？
先打开追踪文件：npx playwright trace open test-results/my-test/trace.zip。然后运行 npx playwright trace actions 查看操作，必要时使用 npx playwright trace action 12、npx playwright trace requests --failed、npx playwright trace console --errors-only 或 npx playwright trace snapshot 12 深入调查。完成后运行 npx playwright trace close 清理提取数据。
这个 Skill 与同类方案有什么区别？
README 将 npx playwright show-trace trace.zip 和 Trace Viewer 作为图形化追踪查看方式；本技能则提供命令行调查流程，重点是可筛选的操作、请求、控制台、错误、快照和附件。