Agentic Playwright CLI
Шаблон проекта Playwright на TypeScript с правилами и 17 скиллами, чтобы Claude Code, Codex и Cursor писали тесты по стандарту
- 262 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Установщик скачивает зависимости и браузер, а хук Claude Code исполняет `python3` на каждую запись
- Тесты могут ходить на сайты и API по указанным адресам и учетным данным из `env/.env.*`
Установка
- Работает в
Ручная установка
npm create agentic-playwright@latest . -- --demoВыполняется в пустом каталоге. Вариант без демо: `npm create agentic-playwright@latest . -- --bare`. Нужны Node.js 22, npm 10 и `python3`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установщик скачивает зависимости и браузер, а хук Claude Code исполняет `python3` на каждую запись
- Тесты могут ходить на сайты и API по указанным адресам и учетным данным из `env/.env.*`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Команда `npm create agentic-playwright@latest` создает рабочий каркас автотестов на Playwright и TypeScript вместе с набором правил для ИИ-агента. В проекте есть объекты страниц с внедрением зависимостей, контракты API с проверкой схем Zod, фабрики данных, мультибраузерная конфигурация, ESLint, Prettier, хуки Husky и CI. Режим `--demo` без вопросов доводит дело до зеленого дымового теста на живом демо-приложении. Главный артефакт для агента — файл `AGENTS.md`. В нем записаны «Конституция» из 36 однострочных правил, порядок работы «проверить, закоммитить, идти дальше» и индекс из 17 скиллов. Codex, Cursor и Copilot читают `AGENTS.md` напрямую, Claude Code подключает его через `CLAUDE.md`. Скиллы лежат в `.claude/skills/` и копируются в `.agents/skills/` командой `npm run skills:sync`. Правила проверяются механически. В Claude Code хук `PreToolUse` блокирует запись запрещенных конструкций: XPath, жесткие ожидания, тип `any`. Во всех инструментах те же правила сканируются перед коммитом и в CI, а скилл `pr-reviewer` проверяет изменения при ревью. В платной версии Pro добавлены полный набор хуков и правила AST для ESLint.
Для кого. QA-инженерам и разработчикам, которые строят автотесты на Playwright с помощью ИИ-агента и хотят единых правил вместо ручных поправок каждого теста.
Подходит, если
- Тестовый проект с нуля, и агенту нужны готовые объекты страниц, фабрики данных и структура вместо импровизации
- Агент пишет тесты с жесткими ожиданиями и XPath, и такие конструкции надо блокировать на записи
- Команда использует Claude Code, Codex и Cursor одновременно, а правила должны быть одинаковыми для всех
- В репозитории нужно проверять каждое изменение на соблюдение правил перед коммитом и в CI
Не подходит, если
- Тесты уже есть в большом проекте: шаблон пишет свою структуру в пустой каталог, а существующую не мигрирует
- Нужен фреймворк на Python или Java: каркас построен на TypeScript и Playwright
- На машине нет `python3`: хук Конституции работает на нем, и без него Claude Code блокирует все записи
- Требуется полный комплект хуков и правил AST: он есть только в платной версии Pro
Пример запроса к агенту
Создай в этой пустой папке проект Agentic Playwright в демо-режиме, а потом напиши тест поиска товара по правилам из AGENTS.mdОграничения
- Нужны Node.js 22 или новее, npm 10 и `python3`. На Windows установщик python.org дает только `python` и `py`, и тогда хук блокирует все записи Claude Code, поэтому берут Dev Container или WSL.
- Каталог для запуска должен быть пустым, кроме служебных файлов вроде `.git`.
- В Codex нет хука на запись, защиту дают проверки перед коммитом и в CI. В песочнице macOS он не запускает Chromium без `--sandbox danger-full-access`.
- Это шаблон: примеры страниц и тестов заменяют своими.
- Платная версия Pro содержит дополнительные хуки и правила.
Как отключить. Шаблон попадает в проект обычными файлами, поэтому удалите `AGENTS.md`, `CLAUDE.md`, папки `.claude/` и `.agents/`, хуки Husky и лишние скрипты из `package.json`. Для отключения только хука в Claude Code уберите запись `PreToolUse` из `.claude/settings.json`.
Частые вопросы
Как создать проект Agentic Playwright?
Выполните в пустом каталоге `npm create agentic-playwright@latest . -- --demo`. Установщик развернет каркас, поставит зависимости и браузер и запустит дымовой тест на демо-приложении.
Какие агенты поддерживаются?
Claude Code, Codex, Cursor и GitHub Copilot. Codex, Cursor и Copilot читают `AGENTS.md` напрямую, Claude Code подключает его через `CLAUDE.md`. Флаги `--no-claude` и `--no-agents` убирают лишнее.
Что запрещает Конституция?
Среди правил: XPath, жесткие ожидания, `any`, магические таймауты, больше одного тега на тест. Тесты пишутся с объектами страниц, шагами Given, When, Then и ожиданиями, которые ждут состояния страницы.
Чем отличается бесплатная версия от Pro?
Бесплатная включает каркас, `AGENTS.md`, 17 скиллов, хук записи для Claude Code и сканирование перед коммитом. В Pro добавлены полный набор хуков, правила AST для ESLint, проверка соответствия и непрерывная оценка скиллов.
Зачем нужен python3?
На нем работают хук Конституции, его сканирование перед коммитом и три проверки скиллов. Без `python3` хук в Claude Code блокирует любые записи и правки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструменты57 справочных файлов по тестам Playwright на TypeScript: агент берет из них нужный по задаче, от локаторов до шардирования в CI
Семь QA-агентов и десять скиллов для автотестов: Playwright на TypeScript, Selenium на Java, API, доступность и ISTQB.
Playwright CLI
playwright-cli
Официальный CLI Playwright со скиллом для агентов: управление браузером короткими командами без тяжелых MCP-схем
Скилл, с которым агент пишет и запускает скрипты Playwright: тесты страниц, формы, скриншоты, проверки ссылок
Руководства для агента, который пишет и чинит тесты Playwright: выбор локаторов, ожидания и диагностика сбоев в CI
Скилл проверки кода агента в настоящем браузере: читает ваши изменения, составляет план теста и прогоняет его через Playwright с вашими куки
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Agentic Playwright (эта карточка) | нет | 262 | |
| Playwright Best Practices Skill | нет | 417 | один скилл с советами по Playwright, без каркаса проекта, хуков и проверки на коммите |
| Playwright Skill | нет | 3 266 | учит агента писать сценарии Playwright, но не создает проект и не следит за правилами |
Коротко о README
README показывает разницу между тестом, который агент пишет без правил, и тестом по Конституции, объясняет быстрый старт через npm, Dev Container и скрипт установки, описывает структуру проекта, теги, работу с API и данными. Отдельные разделы — про архитектуру правил для ИИ и платную версию Pro.