用途:在完成 UI 功能开发后、为 UI 变更创建 PR 前,或审查 UI 相关分支时,验证界面改动并确保 Playwright E2E 测试覆盖完整。
主要能力:分四个阶段工作。一是审查分支改动,用 git diff main --stat、git diff main --name-only | grep -E ".(tsx?|less|css|scss)$" 等命令识别变更文件,重点关注 UI 组件与已有测试。二是审查现有 Playwright 测试,在 playwright/e2e/Pages/ 与 playwright/e2e/Features/ 中定位相关测试,分析已覆盖场景与缺口,并查看 playwright/utils/、playwright/support/ 中的工具与夹具。三是用 Playwright MCP 验证,通过 mcp__playwright__browser_navigate 打开 http://localhost:8585,必要时用 mcp__playwright__browser_fill_form 登录(默认 admin@open-metadata.org / admin),再用 browser_click、browser_snapshot 检查页面状态,验证主流程、视觉元素、交互元素、状态变化与 API 调用。四是补充缺失测试,在 beforeAll 创建实体夹具、afterAll 逆序清理,按 test.step 模式编写用例,覆盖正常路径、边界、错误处理、状态转换、UI 反馈与权限。完成后运行 yarn lint:playwright。
限制:禁止使用 page.waitForLoadState('networkidle')、page.pause() 与 test.only(),会被 ESLint 拦截;超时优先用 test.slow() 或 test.setTimeout()。playwright/* 与 om-playwright/* 规则为 error 级别,openmetadata-playwright/* 规则可能为 warn,需查看手册 ESLint Enforcement 表的严重级别。具体安装与运行环境要求资料未提供。