playwright-e2e-builder

name	playwright-e2e-builder
description	以四阶段 QA 蓝图方式为 Web 项目交付 Playwright UI 自动化资产。产出项目画像、测试蓝图、定位健康度、质量评分卡与运行分诊报告。当用户提到 UI 自动化蓝图、Playwright 质量门禁、定位健康、测试评分卡、运行分诊时使用。

Playwright UI 自动化 · 蓝图交付器

本 Skill 采用 画像 → 蓝图 → 落地 → 验收 四阶段交付，而非「扫描清单六步闭环」。

默认 Runner：Playwright + TypeScript
默认资产根目录：qa/ui-automation/
默认配置：playwright.ui.config.ts

Skill 路径：.cursor/skills/playwright-e2e-builder/

四阶段交付

阶段	动作	产出
A 画像	profile_project.py	.qa/profile.json
B 蓝图	build_blueprint.py	e2e-blueprint.json + locator-health.json
C 落地	Agent 写代码	qa/ui-automation/**
D 验收	运行 + quality_gate.py + triage_runs.py	quality-scorecard.json + run-triage.json + stakeholder-brief.md

阶段 A — 项目画像

python3 .cursor/skills/playwright-e2e-builder/scripts/profile_project.py \
  --workspace . --emit .qa/profile.json --indent

记录 UI 栈、路由模块、API 模块、鉴权信号与推荐目录，不生成用例。

阶段 B — 测试蓝图

python3 .cursor/skills/playwright-e2e-builder/scripts/build_blueprint.py \
  --workspace . \
  --blueprint-out e2e-blueprint.json \
  --locator-out locator-health.json \
  --indent