К основному содержанию
скилл CX Codex

playwright-validation — скилл для Claude Code

Скилл playwright-validation гоняет UI-изменения ветки через Playwright MCP и дописывает недостающие E2E-тесты в стиле репозитория OpenMetadata.

Apache-2.0 ★ 15 831 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add open-metadata/OpenMetadata --skill playwright-validation -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/playwright-validation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/playwright-validation/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
playwright-best-practices currents.dev Скилл playwright-best-practices для Claude Code — справочник по архитектуре Playwright-тестов, селекторам и Page Object Model. Помогает разбирать флакующие тесты, мокировать API и проверять доступность. CX Codex +1 107 500установок playwright-skill lackeyjb Скилл для написания и запуска Playwright-скриптов прямо в редакторе. Автоматически находит dev-серверы, делает скриншоты, проверяет адаптивность, тестирует логины и валидирует работу сайта. CX Codex +1 8 000установок playwright-cursor-rules Mindrally Скилл учит агента писать end-to-end тесты на Playwright по стандартам QA-автоматизации: стабильные локаторы, изоляция, параллельный запуск. CX Codex +1 738установок playwright-e2e-testing fugazi Скилл playwright-e2e-testing для написания и поддержки E2E-тестов на Playwright с TypeScript: пользовательские сценарии, формы, авторизация, моки и визуальные сравнения. CX Codex +1 642установок playwright PyModel С правилами по Playwright для Next.js. Включается при написании новых тестов, поиске плавающих падений и настройке CI. CX Codex +1 623установок playwright-typescript официальный github Правило playwright-typescript для GitHub Copilot стандартизирует написание тестов, задавая требования к локаторам, структуре и именованию файлов. Активируется при генерации E2E-тестов в проектах на Playwright. CX Codex +1 ★ 41 430звёзд репо

Из того же набора4

Спонсоры проекта

Компании, которые помогают держать аналитику открытой