用途
test-playwright 用于对本次会话(session)的代码改动做 PDCA 闭环:Plan 是刚做的改动,Do 已在代码中,Check 是驱动真实应用(本技能),Act 是在同一轮内修复发现的每个痛点。技能明确:代码能编译不等于完成,只有以用户身份驱动真实应用、发现损坏或别扭之处并修复后,才算完成。
主要能力
- 以有头(headed)浏览器手动驱动应用,一次执行一个真实操作,不使用脚本、不使用 *.spec.ts、不运行 npx playwright test。
- 仅测试本次会话改动及其影响范围(blast radius),不做全应用爬取。
- 边测边修:Bug、500 错误、失效按钮、糟糕布局等,当场定位根因并修复,然后重新测试。
- 证据驱动:发现需附截图、控制台、网络请求;修复需针对真实后端做实时复测。
- 后端真实性核对:借助 Sentry、Supabase 等 MCP 检查生产错误、数据库表/日志/顾问建议。
- 红队式自测:假设改动存在细微错误,尝试破坏它,并记录增强建议。
使用方式
技能以 playwright-cli 为驱动(而非 Playwright MCP),命令形式为 PW="npx --yes @playwright/cli@latest",再执行 $PW -s=<session> <command>。
工作流分为七个阶段:
- 界定本次会话改动范围:通过 git status/diff 获取改动,映射文件到用户可见界面,写出测试计划。
- 环境验证:确认开发服务器运行、应用可加载、已认证;会话命名如
-s=qa-<feature>,使用open --headed打开,必要时加--persistent --profile。 - 以真实用户身份走查改动流程:每步执行 goto、snapshot、screenshot、click/type/fill 等,并查看 console 与 requests,判断 PASS 或 PAIN POINT。
- 边测边修:定位根因(前端组件/状态、4xx/5xx 后端、FE↔BE 不匹配、迁移未部署、RLS、配置/CORS 等),外科手术式修改,并实时复测。
- 后端真实性核对:检查 Sentry 问题、Supabase 表/日志/顾问、应用日志。
- 红队与批评:对改动界面做破坏性测试(重复提交、快速切换、特殊字符、慢/失败网络等),质疑 UX 与设计,记录增强想法。
- 重新测试并报告:端到端复测所有修复流程,清理测试数据,输出 PDCA 测试报告,给出 Ship / Ship after fixes / Not ready 结论。
常用命令包括:驱动类 open --headed、goto、click、type、fill、select、check、hover、drag、press、upload、dialog-accept、resize;观察类 snapshot、find、screenshot、console、requests、request;等待类 sleep(≤3s)或 run-code;仅用于检查的 eval、run-code。
适用场景
- 刚完成一处代码改动,想验证其在真实应用中的表现。
- 需要以用户视角走查改动流程并当场修复问题。
- 需要对改动做后端真实性核对与红队式自测。
- 需要一份包含范围、流程结果、修复记录、后端核对、红队发现与增强建议的测试报告。
限制
- 仅覆盖本次会话改动及其影响范围,全应用覆盖属于 test-qa,访客与登录态漫游属于 test-exploratory,像素基线属于 test-visual-regression,敌对功能矩阵属于 test-red-team。
- 必须手动、有头驱动,禁止脚本化与无头模式。
- 反停滞规则:等待不超过 3 秒,每个目标最多尝试 4 次,超时则标记 [TIMEOUT] 并跳过。
- 认证复用:登录一次并持久化,除非测试登出否则不登出;Google 账号无法从 Playwright 启动的浏览器登录。
- 修改真实数据前需询问;DDL 变更需保留版本化迁移文件并验证远端。
- 不在聊天中暴露密钥,仅以名称引用 .env* 文件。
- 报告需诚实:控制台有红色错误或存在未修复痛点时不得宣称完成。
暂未提供
该技能的收费、价格、平台支持范围、具体效果数据等事实,资料中暂未提供。