Playwright Enterprise Skills
shuaishuaiASDF/playwright-skills
Skills Playwright para testes UI enterprise com auditoria e dados reais
Ver no GitHubConjunto de skills para Claude Code/Codex focado em automação de testes UI de nível empresarial com Playwright. Cobre inicialização de projetos, desenvolvimento de scripts e planejamento de matrizes de teste, com suporte a dados reais, auditoria completa e esperas inteligentes.
Instalação
npx convez-ai shuaishuaiASDF/playwright-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Inicializar e estruturar projetos de testes UI com Playwright
- Desenvolver e manter suites de testes com dados reais e sem mocks
- Planejar estratégias de teste e matrizes de cobertura
- Gerar relatórios de auditoria com screenshots e snapshots de API
- Implementar esperas inteligentes e assertions de banco de dados
Veredito

Solução robusta para equipes que precisam automatizar testes UI em contextos corporativos com requisitos de conformidade e rastreabilidade. A arquitetura em camadas (Spec/Capability/Comum) promove reutilização e a ênfase em dados reais elimina fragilidades típicas de testes com mocks.
README
A tradução para o português deste README ainda está na fila.
Playwright Enterprise Skills for Claude Code / Codex
面向企业级 UI 自动化测试的 Claude Code / Codex Skill 套件,从框架初始化到测试矩阵规划,覆盖 Playwright 项目全生命周期。
Skills 概览
| Skill | 用途 | 触发场景 |
|---|---|---|
playwright-bootstrap | 新项目首次初始化 Playwright ui-test 基础框架 | 新仓库搭框架、补齐缺失骨架 |
playwright-common | 日常 Playwright 脚本开发与维护的通用知识库 | 写 spec、补能力、调试、重构、补矩阵 |
playwright-matrix-plan | 测试矩阵分析与场景规划 | 新模块评估、测试策略制定、用例规划 |
设计理念
真实数据优先
不依赖 Mock,直接对接真实后端 API 和真实数据库,确保测试结果反映系统真实状态。
审计驱动
每条测试步骤产出完整证据链:截图 + API 快照 + DB 查询结果,自动生成 Markdown/JSON 审计报告,满足金融/政务/合规场景的可追溯要求。
分层可复用
- Spec 层:只组织场景、断言和报告记录
- Capability 层:沉淀可复用的页面操作、接口封装、数据库断言
- 公共能力层:跨项目可复制的审计报告、数据库查询、智能等待
智能等待
禁用 waitForTimeout,采用两阶段策略:先尝试快速超时,检测到 loading 状态后自动进入轮询,兼顾速度与稳定性。
安装
前置条件
- Claude Code 或 OpenAI Codex CLI 已安装并可用
- Git
Claude Code
# macOS / Linux
git clone https://github.com/shuaishuaiASDF/playwright-skills.git /tmp/playwright-skills && \
mkdir -p ~/.claude/skills && \
cp -r /tmp/playwright-skills/playwright-bootstrap ~/.claude/skills/ && \
cp -r /tmp/playwright-skills/playwright-common ~/.claude/skills/ && \
cp -r /tmp/playwright-skills/playwright-matrix-plan ~/.claude/skills/ && \
rm -rf /tmp/playwright-skills && \
echo "✅ 安装完成"
# Windows (PowerShell)
git clone https://github.com/shuaishuaiASDF/playwright-skills.git $env:TEMP\playwright-skills
Copy-Item -Recurse $env:TEMP\playwright-skills\playwright-bootstrap $env:USERPROFILE\.claude\skills\
Copy-Item -Recurse $env:TEMP\playwright-skills\playwright-common $env:USERPROFILE\.claude\skills\
Copy-Item -Recurse $env:TEMP\playwright-skills\playwright-matrix-plan $env:USERPROFILE\.claude\skills\
Remove-Item -Recurse $env:TEMP\playwright-skills
Write-Host "✅ 安装完成"
git clone https://github.com/shuaishuaiASDF/playwright-skills.git
cp -r playwright-skills/playwright-bootstrap ~/.claude/skills/
cp -r playwright-skills/playwright-common ~/.claude/skills/
cp -r playwright-skills/playwright-matrix-plan ~/.claude/skills/
仅当前项目可用,适合团队统一版本:
# 在项目根目录执行
git clone https://github.com/shuaishuaiASDF/playwright-skills.git /tmp/playwright-skills
mkdir -p .claude/skills
cp -r /tmp/playwright-skills/playwright-bootstrap .claude/skills/
cp -r /tmp/playwright-skills/playwright-common .claude/skills/
cp -r /tmp/playwright-skills/playwright-matrix-plan .claude/skills/
rm -rf /tmp/playwright-skills
Codex CLI
# macOS / Linux
git clone https://github.com/shuaishuaiASDF/playwright-skills.git /tmp/playwright-skills && \
mkdir -p ~/.codex/skills && \
cp -r /tmp/playwright-skills/playwright-bootstrap ~/.codex/skills/ && \
cp -r /tmp/playwright-skills/playwright-common ~/.codex/skills/ && \
cp -r /tmp/playwright-skills/playwright-matrix-plan ~/.codex/skills/ && \
rm -rf /tmp/playwright-skills && \
echo "✅ 安装完成"
# Windows (PowerShell)
git clone https://github.com/shuaishuaiASDF/playwright-skills.git $env:TEMP\playwright-skills
Copy-Item -Recurse $env:TEMP\playwright-skills\playwright-bootstrap $env:USERPROFILE\.codex\skills\
Copy-Item -Recurse $env:TEMP\playwright-skills\playwright-common $env:USERPROFILE\.codex\skills\
Copy-Item -Recurse $env:TEMP\playwright-skills\playwright-matrix-plan $env:USERPROFILE\.codex\skills\
Remove-Item -Recurse $env:TEMP\playwright-skills
Write-Host "✅ 安装完成"
验证安装
重启 Claude Code / Codex,确认 Skill 已加载:
# Claude Code — 查看可用命令
/help
# Codex — 确认 skills 目录存在
ls ~/.codex/skills/
预期输出:
playwright-bootstrap — 初始化 Playwright ui-test 框架
playwright-common — 日常 Playwright 脚本开发
playwright-matrix-plan — 测试矩阵分析与规划
如果未出现,确认目录结构正确:
# Claude Code
~/.claude/skills/
├── playwright-bootstrap/SKILL.md
├── playwright-common/SKILL.md
└── playwright-matrix-plan/SKILL.md
# Codex
~/.codex/skills/
├── playwright-bootstrap/SKILL.md
├── playwright-common/SKILL.md
└── playwright-matrix-plan/SKILL.md
使用
框架初始化(新项目)
在 Claude Code 中输入:
$playwright-bootstrap
或直接用自然语言:
请初始化 Playwright ui-test 基础框架
项目根目录: D:\my-project
是否启用数据库能力: 是
是否启用审计报告: 是
Skill 会自动检查项目现状,只补齐缺失文件,不覆盖已有内容。
日常脚本开发(已有框架)
$playwright-common
适用场景:新增 spec、补充页面能力、调试测试失败、修复选择器、补充数据库断言。
测试矩阵规划
$playwright-matrix-plan
适用场景:新模块测试策略评估、用例矩阵规划、场景覆盖分析。
目录结构
├── playwright-bootstrap/ # 框架初始化 Skill
│ ├── SKILL.md # Skill 指令文件
│ ├── agents/openai.yaml # Codex Agent 配置
│ └── assets/templates/ui-test/ # 可复制的框架模板
│ ├── package.json
│ ├── playwright.config.ts
│ ├── tsconfig.json
│ ├── README.md
│ └── code/
│ ├── test.config.ts
│ └── base/capabilities/
│ ├── db/ # 数据库查询能力
│ └── reporters/ # 审计报告能力
│
├── playwright-common/ # 日常开发 Skill
│ ├── SKILL.md # Skill 指令文件
│ ├── agents/openai.yaml # Codex Agent 配置
│ ├── references/ # 实现参考文档
│ ├── examples/ # 代码示例
│ └── templates/ # 输出模板
│
└── playwright-matrix-plan/ # 测试矩阵 Skill
├── SKILL.md # Skill 指令文件
├── agents/openai.yaml # Codex Agent 配置
└── references/ # 映射规则与矩阵模板
适用场景
- 企业级中后台系统的 UI 自动化测试
- 金融/政务/合规等需要审计证据链的项目
- 使用 Ant Design Vue / Element Plus 等 UI 框架的 Vue 3 项目
- 需要真实后端 + 真实数据库验证的集成测试
兼容性
- Claude Code(Skill 直接加载)
- OpenAI Codex(通过
agents/openai.yaml配置) - 支持 Windows / macOS / Linux
License
MIT