playwright-test-runner

Playwright Test Runner

做什么：读取 test-case-writer 产出的用例文档，自动生成 Playwright 可执行 spec、运行测试、产出报告、执行闸门检查、回填自测清单。

为什么：研发不需要知道 test-case-writer、Playwright MCP、playwright-test-runner 三个东西怎么配合。说一句话（/test 驳回功能），AI 走完：出用例→出清单→出脚本→执行→报告→闸门→提测决策。

要不要做：先判断。项目没有 @playwright/test→引导 npm init playwright。只有用例文档但没开发完→只生成 spec 骨架。没有用例文档→提示先跑 test-case-writer。只需要跑已有测试→直接 npx playwright test，不需要本 skill。

适用判断

用户要做什么？
    ├─ 已有用例文档 + 开发完成 → 本 skill（生成 spec → 跑测试 → 出报告）
    ├─ 只有用例文档，还没开发 → 提示先开发，只生成 spec 骨架
    ├─ 没有用例文档 → 提示先运行 test-case-writer
    ├─ 只需要设计用例 → 不是本 skill，用 test-case-writer
    └─ 只需要跑已有测试 → 不是本 skill，直接 npx playwright test

前置条件

1. 项目已有 @playwright/test 依赖 + playwright.config.ts
2. 存在测试用例文档（test-case-writer 产出，或用户提供）
3. 被测功能已开发完成（至少页面/API 可达）

如果项目还没有 Playwright → 引导用户执行 npm init playwright。

完整流程

用户: "用 Playwright 验证一下" / "跑端到端测试"
        ↓
Step 0: 项目探测 → 读取 config / 嗅探 UI 框架 / 扫描已有 spec → 汇报
        ↓
Step 1: 确认范围 → 找用例文档 → 分拣 UI/API/Skip → 等用户确认
        ↓
Step 2: 生成 .spec.ts → 按项目风格 + UI 框架策略 → 自检
        ↓
Step 3: 执行测试 → 检查环境 → npx playwright test → 等待结果
        ↓
Step 4: 报告+研发自测闸门 → 解析结果 → Markdown 报告 + 三闸门 + 回填自测清单
        ↓
        完成

---

Step 0: 项目探测（全自动）

探测 Playwright 项目的配置和使用模式。不假设任何默认值，全部从代码中读取。

0.1 检查 Playwright 依赖

检查 package.json → devDependencies 中是否有 @playwright/test
  ├─ 有 → 提取版本号，继续
  └─ 无 → "这不是 Playwright 项目。要初始化吗？(npm init playwright)"

0.2 读取 playwright.config.ts

解析配置，提取以下字段（如有）：

{
  testDir,          // spec 文件目录，默认 './tests'
  testMatch,        // 文件匹配模式，默认 '**/*.spec.ts'
  baseURL,          // use.baseURL
  projects,         // 浏览器列表
  timeout,          // 全局超时
  reporter,         // 报告器配置
  use: {
    screenshot,     // 'on' | 'off' | 'on-first-retry'
    video,          // 'on' | 'off' | 'retain-on-failure'
    storageState,   // 全局 auth 状态文件
    actionTimeout,  // 操作超时
  },
  globalSetup,      // 全局 setup 脚本
}

0.3 嗅探 UI 框架

从 package.json → dependencies 匹配已知框架。详见 references/ui-framework-adapters.md。