SuperAPI AI 工具集

test

测试与质量

查看项目

更新于 10-16 02:31

技能介绍

用途:对已完成的前端实现做端到端测试,按验收标准逐条验证,并在 docs/testing/{ID}-{task-name}.md 生成测试报告,同时更新 TASKS.md 状态。

前置配置:交互模式需在项目根目录(非 .claude/ 或子目录)创建 .mcp.json,配置 playwright 服务(command 为 npx,args 为 @playwright/mcp@latest),添加或修改后需重启 Claude Code,并确认出现 mcp__playwright__browser_* 工具。CI 模式无需 MCP,需执行 npm install -D @playwright/test 和 npx playwright install。

模式判定:先解析是否有 --ci。无 --ci 时检查 Playwright MCP 工具:可用即进入交互模式,且绝不创建测试脚本;不可用时查看 Automation 字段——auto 则静默回退 CI 模式并通知用户,manual 则停止并只显示前置条件,不回退不继续。带 --ci 即 CI 模式,不要求 MCP。

交互模式:读取任务文档中的实现说明与验收标准,将每条标准映射为 Playwright 动作,直接用 mcp__playwright__browser_* 工具执行(如 navigate、snapshot、click、type、fill_form、take_screenshot、console_messages、network_requests、wait_for,以及 resize 做响应式测试),不创建 .ts/.js 或 .spec 文件,不运行 npx playwright test,不生成根目录测试文件或截图目录,只把最终报告写入 docs/testing/。

CI 模式:在 tests/e2e/{task-name}/ 生成 Playwright 脚本,执行 npx playwright test,可用子代理并行执行,报告写入 docs/testing/{ID}-{task-name}.md;默认保留测试脚本,加 --cleanup 则删除 tests/e2e/{task-name}/。临时产物(TEST_REPORT.md、TEST_SUMMARY.txt、TEST_CASES.md、test-screenshots/、playwright-report/、test-results/、*.spec.ts 等)须在结束时清理。

执行顺序:happy path → 错误状态 → 边界用例。PASS 时把任务移入 Approved(状态 PASS - Awaiting approval);FAIL 时保留在 Testing(FAIL - See report),并向任务文档实现说明写入失败块(失败标准、根因、待查文件),同时输出 SIGNAL 块。无法自动化的视觉精度、动画等需在报告中记录人工测试的步骤与预期结果。资料未提供收费、平台支持范围等信息。