skillhub-147-playwright-skill/ci/SKILL.md

name, description

name	description
playwright-ci	Playwright 的生产级 CI/CD 配置——GitHub Actions、GitLab CI、CircleCI、Azure DevOps、Jenkins、Docker、并行分片、报告、代码覆盖率以及全局 setup/teardown。

Playwright CI/CD

在每个流水线中交付可靠的测试——针对 CI 的特定模式，用于提升速度、稳定性以及可操作的报告。

9 篇指南，涵盖 CI/CD 设置、并行执行、容器化运行、报告以及所有主流 CI 提供商的基础设施模式。

黄金法则

1. 仅在 CI 中使用 retries: 2 ——在流水线中暴露不稳定测试，而非本地
2. 使用 traces: 'on-first-retry' ——在不拖慢每次运行的前提下捕获丰富的调试产物
3. 跨运行器分片 ——--shard=N/M 将测试均匀拆分；横向扩展，而非纵向扩展
4. 缓存浏览器二进制文件 ——以 Playwright 版本为键，缓存 ~/.cache/ms-playwright
5. 在失败时上传产物 ——将 trace、截图和 HTML 报告作为 CI 产物上传
6. 使用官方 Docker 镜像 ——mcr.microsoft.com/playwright:v* 已预装所有操作系统依赖
7. 全局设置用于认证 ——在 globalSetup 中运行一次登录，跨 worker 复用 storageState
8. 快速失败，稍后调试 ——保持 CI 运行时间短；使用 trace 查看器和 HTML 报告进行调查

指南索引

CI 提供商

提供商	指南
GitHub Actions	ci-github-actions.md
GitLab CI	ci-gitlab.md
CircleCI / Azure DevOps / Jenkins	ci-other.md

执行与扩展

主题	指南
并行执行与分片	parallel-and-sharding.md
Docker 与容器	docker-and-containers.md
多项目配置	projects-and-dependencies.md

报告与设置

主题	指南
报告与产物	reporting-and-artifacts.md
代码覆盖率	test-coverage.md
全局 setup/teardown	global-setup-teardown.md