Playwright E2e

---
name: playwright-e2e
description: >-
  Use when a full-stack business delivery needs repeatable browser E2E evidence.
  This wrapper reuses the existing playwright skill for browser mechanics, but
  adds PACE delivery rules: start FE/BE/DB only from runtime-env, write
  rerunnable tests from requirements and contracts, capture evidence, and feed
  results into runtime-verify and delivery reports.
---

# playwright-e2e

全栈交付专用 Playwright 封装。职责是把需求、契约和运行环境声明转成可复跑 E2E 测试与证据。
本 skill **系统无关**：浏览器操作复用既有 `playwright` skill；应用命令、端口、账号、URL 全部来自
Convention Pack 或 `runtime-env`，不复制 Playwright 官方细节。

## 何时使用

- FE、BE、DB 已能按 `runtime-env` 启动，需要验证真实业务流。
- 需要把关键用户路径、权限路径和错误路径写成可复跑 E2E。
- 需要截图、trace、视频或测试报告进入 `runtime-verify` 和交付报告。

## 何时不使用

- 只需单元级行为验证；使用 `unit-test-gen`。
- 运行环境、测试账号或探活 URL 未声明。
- 需要学习 Playwright API 细节；调用既有 `playwright` skill 或官方文档。

## 输入

1. 需求验收标准、关键页面、API 契约和数据准备要求。
2. Convention Pack：E2E 目录、选择器约定、账号/角色声明、数据隔离和测试命令。
3. `runtime-env`：FE/BE/DB 命令、端口、探活 URL、teardown。

## 工作流

1. 定位 Convention Pack。通用规则读 `references/e2e-convention-pack.md`；若
   `scaffold_id=quantum` 或 pack 路径匹配 `quantum-front` / `quantum-backend`，再读
   `references/quantum-e2e-adapter.md`。
2. 运行 `python3 scripts/check_security_e2e_pack.py --frontend-pack <fe-pack> --backend-pack <be-pack> --profile e2e`。
   缺 runtime-env、页面挂载或测试报告约定时先停机补约定。
3. 读取 `runtime-env`，按声明顺序启动 DB、BE、FE，并等待探活 URL 成功。
4. 读取 Convention Pack，确认 E2E 文件位置、选择器约定和测试数据策略。
5. 使用既有 `playwright` skill 编写可复跑测试；测试来源必须是需求和契约。
6. 执行 E2E 命令，保存截图、trace、视频或报告路径；失败则读证据、修复、重跑。
7. 执行 teardown，释放端口、进程、容器或临时数据。
8. 把结果写入 `runtime-verify` 证据和交付报告输入。

## 输出

- 可复跑的 Playwright E2E 测试文件。
- 启停命令、探活结果、测试结果、截图/trace/报告路径。
- 覆盖需求清单和剩余未覆盖原因。

## 铁律

- 不猜环境；没有 `runtime-env` 不启动服务。
- 不复制 Playwright 官方细节；浏览器调试和 API 用法交给既有 `playwright` skill。
- E2E 必须可复跑，禁止只做一次性手工点击。
- 测试数据必须可隔离、可清理，不污染共享环境。

## PACE 集成

- runtime-verify stage：启动全栈环境，执行 E2E，保存证据。
- review stage：spec-compliance 核对 E2E 是否覆盖原始需求和契约。
- ship stage：交付报告引用 E2E 结果和人工未确认项。

## References

- `references/e2e-convention-pack.md`: E2E Convention Pack contract。
- `references/quantum-e2e-adapter.md`: quantum 前后端 E2E 适配器。
- `scripts/check_security_e2e_pack.py`: security/e2e pack 与 runtime-env 完整性校验脚本。