playwright-validation — скилл для Claude Code
Скилл playwright-validation гоняет UI-изменения ветки через Playwright MCP и дописывает недостающие E2E-тесты в стиле репозитория OpenMetadata.
Apache-2.0 ★ 15 831 обновлён 2026-10-24
npx skills add open-metadata/OpenMetadata --skill playwright-validation -a claude-codeЧто делает playwright-validation
Скилл ведёт агента по четырём фазам проверки UI-изменений. Сначала тот сравнивает ветку с main (git diff main --stat), отбирает изменённые .tsx, .less, .css, .scss и читает сами компоненты. Потом ищет готовые спеки в playwright/e2e/Pages/ и playwright/e2e/Features/, смотрит хелперы в playwright/utils/ и playwright/support/ и отмечает, каких сценариев не хватает.
Третья фаза — живой прогон через Playwright MCP: mcp__playwright__browser_navigate на http://localhost:8585, вход под [email protected] / admin, клики и снимки страницы. Приложение должно быть уже запущено: без поднятого сервера на этом порту фаза не начнётся. В четвёртой фазе агент дописывает недостающие тесты — фикстуры в beforeAll, уборка в afterAll, шаги через test.step.
В конце прогоняется yarn lint:playwright. Правила ESLint здесь строгие: networkidle, page.pause() и test.only() в тестах не пройдут. Таймауты ставятся через test.slow() или test.setTimeout().
Какие задачи решает
- посмотреть, какие UI-компоненты задела ветка
- найти пробелы в покрытии существующих Playwright-тестов
- пройти основной сценарий в браузере через Playwright MCP
- дописать фикстуры и уборку для нового теста
- поймать запрещённые приёмы вроде
networkidleдо ревью
Примеры запросов агенту
- Проверь UI-изменения в текущей ветке и скажи, каких E2E-тестов не хватает
- Открой
http://localhost:8585через Playwright MCP и пройди сценарий создания Data Product - Допиши недостающий тест в
playwright/e2e/Pages/и прогониyarn lint:playwright
Как установить playwright-validation
1Через Skills CLI (Vercel)
npx skills add open-metadata/OpenMetadata --skill playwright-validation -a claude-code2Вручную: положить файлы
~/.claude/skills/playwright-validation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/playwright-validation/
1Через Skills CLI (Vercel)
npx skills add open-metadata/OpenMetadata --skill playwright-validation -a codex2Вручную: положить файлы
.agents/skills/playwright-validation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add open-metadata/OpenMetadata --skill playwright-validation -a cursor2Вручную: положить файлы
.cursor/skills/playwright-validation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install open-metadata/OpenMetadata skills/playwright-validation2Вручную: положить файлы
.github/skills/playwright-validation/SKILL.md1Через Skills CLI (Vercel)
npx skills add open-metadata/OpenMetadata --skill playwright-validation -a gemini-cli2Командой платформы
gemini skills install https://github.com/open-metadata/OpenMetadata --path skills/playwright-validationВручную: положить файлы
.devin/skills/playwright-validation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add open-metadata/OpenMetadata --skill playwright-validation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о playwright-validation
Как установить playwright-validation в Claude Code?
Выполните npx skills add open-metadata/OpenMetadata --skill playwright-validation -a claude-code. Скилл появится по пути ~/.claude/skills/playwright-validation/SKILL.md.
Что делает playwright-validation?
Проводит агента по проверке UI-изменений: дифф ветки, разбор существующих E2E-тестов, живой прогон в браузере и дописывание недостающих кейсов.
Что нужно для фазы проверки в браузере?
Запущенное приложение на http://localhost:8585 и настроенный Playwright MCP. Вход по умолчанию — [email protected] / admin.
Исходный текст
SKILL.md · Apache-2.0
--- name: playwright-validation description: Use when validating UI changes in a branch require Playwright E2E testing. Reviews branch changes, validates UI with Playwright MCP, and adds missing test cases. --- # Playwright Validation Skill This skill guides you through validating UI changes and ensuring comprehensive Playwright E2E test coverage. ## When to Use - After completing UI feature development - Before creating a PR for UI changes - When reviewing UI-related branches - To verify existing Playwright tests cover all scenarios ## Workflow ### Phase 1: Review Branch Changes 1. **Identify changed files vs main:** ```bash git diff main --stat git diff main --name-only | grep -E "\.(tsx?|less|css|scss)$" ``` 2. **Focus on UI component changes:** ```bash git diff main -- "openmetadata-ui/src/main/resources/ui/src/components/**" --stat ``` 3. **Check for existing Playwright tests:** ```bash git diff main --name-only | grep -E "playwright.*\.spec\.ts$" ``` 4. **Read the changed component files** to understand the UI modifications ### Phase 2: Review Existing Playwright Tests 1. **Locate relevant test files:** - Check `playwright/e2e/Pages/` for page-level tests - Check `playwright/e2e/Features/` for feature-specific tests - Use Glob/Grep to find tests related to the feature 2. **Analyze test coverage:** - Read the existing test file(s) - Identify the test scenarios already covered - Note any gaps in coverage based on the UI changes 3. **Review test utilities:** - Check `playwright/utils/` for helper functions - Check `playwright/support/` for entity classes and fixtures ### Phase 3: Validate with Playwright MCP 1. **Start the browser and navigate:** ``` mcp__playwright__browser_navigate to http://localhost:8585 ``` 2. **Authenticate if needed:** - Use `mcp__playwright__browser_fill_form` for login - Default admin: `[email protected]` / `admin` 3. **Navigate to the feature area:** - Use `mcp__playwright__browser_click` for navigation - Use `mcp__playwright__browser_snapshot` to inspect page state 4. **Validate UI behavior:** - Test the main user flows - Verify visual elements (icons, badges, labels) - Check interactive elements (buttons, dropdowns, forms) - Verify state changes and API calls 5. **Document findings:** - Note what works correctly - Identify any issues or missing functionality - List scenarios not covered by existing tests ### Phase 4: Add Missing Test Cases 1. **Create a TodoWrite checklist** of missing test scenarios 2. **For each missing test case:** a. **Add necessary test fixtures** in `beforeAll`: - Create new entity instances (TableClass, DataProduct, etc.) - Set up required relationships (domains, assets) b. **Add cleanup** in `afterAll`: - Delete created entities in reverse order c. **Write the test** following the pattern: ```typescript test('Descriptive Test Name - What it validates', async ({ page }) => { test.setTimeout(300000); await test.step('Step description', async () => { // Test actions and assertions }); await test.step('Next step', async () => { // More actions and assertions }); }); ``` 3. **Test patterns to cover:** - Happy path (expected behavior) - Edge cases (empty states, max values) - Error handling (invalid inputs, failed requests) - State transitions (before/after actions) - UI feedback (loading states, success/error messages) - Permissions (disabled buttons, restricted actions) 4. **Run Playwright lint check:** ```bash yarn lint:playwright ``` Every `playwright/*` and `om-playwright/*` guardrail rule is `error` severity. Repo-wide `openmetadata-playwright/*` rules set their own, and may sit at `warn` while their call sites migrate — read the severity column in the handbook's **ESLint Enforcement** table rather than assuming. ## Common Test Utilities ### Navigation ```typescript import { sidebarClick } from '../../utils/sidebar'; import { redirectToHomePage } from '../../utils/common'; import { selectDataProduct, selectDomain } from '../../utils/domain'; ``` ### Waiting ```typescript import { waitForAllLoadersToDisappear } from '../../utils/entity'; await waitForAllLoadersToDisappear(page); await expect(page.getByTestId('content')).toBeVisible(); // NEVER use: page.waitForLoadState('networkidle') — blocked by ESLint ``` ### API Responses ```typescript const response = page.waitForResponse('/api/v1/endpoint*'); await someAction(); await response; expect((await response).status()).toBe(200); ``` ### Assertions ```typescript await expect(page.getByTestId('element')).toBeVisible(); await expect(page.getByTestId('element')).toContainText('text'); await expect(page.locator('.class')).not.toBeVisible(); ``` ## Checklist Before Completion - [ ] All UI changes have corresponding test coverage - [ ] Tests cover both positive and negative scenarios - [ ] Tests verify visual indicators (icons, badges, states) - [ ] Tests validate API interactions - [ ] `yarn lint:playwright` passes with zero errors - [ ] No `networkidle`, `page.pause()`, or `test.only()` usage (blocked by ESLint) - [ ] Test fixtures are properly created and cleaned up - [ ] Test timeouts use `test.slow()` (preferred) or `test.setTimeout()` ## Example: Data Contract Inheritance Tests For reference, see the comprehensive test coverage in: `playwright/e2e/Pages/DataContractInheritance.spec.ts` This file demonstrates: - Multiple entity setup in beforeAll - Domain assignment patches - Contract creation and validation - Inheritance icon verification - Action button state verification (disabled/enabled) - API response validation (POST vs PATCH) - Fallback behavior testing
© open-metadata · Apache-2.0 · open-metadata/OpenMetadata