playwright
Playwright — скилл для управления настоящим браузером из терминала через playwright-cli. Он подходит для задач, где нужно открыть страницу, пройти пользовательский сценарий, заполнить форму, получить снимок доступных элементов, сделать скриншот, извлечь данные или разобраться в поведении интерфейса. Источник описывает именно CLI-first подход: сначала используется командная оболочка и предоставленный wrapper, а переход к @playwright/test имеет смысл только тогда, когда явно нужны тестовые файлы. Поэтому карточка полезна как инструкция к ручной и диагностической автоматизации, а не как обещание готового набора тестов для любого проекта. Перед работой скилл требует проверить наличие npx. Его wrapper запускает playwright-cli через npx с пакетом @playwright/cli, поэтому глобальная установка CLI не обязательна. Глобальная установка остаётся допустимым вариантом, но не является условием workflow. Базовый цикл короткий: открыть URL, получить snapshot, обратиться к устойчивой ссылке элемента, выполнить действие и снова получить snapshot после навигации или заметного изменения DOM. В качестве действий источник показывает клик, ввод текста, нажатие клавиши и screenshot. Для исследовательского сценария можно включить tracing-start, выполнить шаги и завершить запись tracing-stop; результат помогает разбирать UI-flow, а не заменяет проверку содержимого страницы. Главное практическое правило — не угадывать идентификаторы элементов. Сначала нужен свежий snapshot, затем ссылка вроде e12, а после перехода, меню, модального окна или другого крупного изменения нужно обновить снимок: старые refs могут стать недействительными. Если команда сообщает, что ref пропал, правильное восстановление — новый snapshot, а не обход механизма через произвольный eval. Скилл также рекомендует явные CLI-команды вместо run-code, когда специальная логика не нужна. Такой режим делает последовательность действий читаемой и уменьшает зависимость от внутренней структуры страницы. Для нескольких вкладок предусмотрены отдельные команды создания, просмотра списка и выбора вкладки; после выбора снова нужен snapshot. Визуальную проверку можно проводить в headed-режиме. Артефакты, которые сохраняются в репозитории, следует складывать в output/playwright, чтобы не создавать новые каталоги верхнего уровня. Это удобно для снимков, PDF или трасс, когда их действительно нужно передать на проверку. Ограничения скилла важны. Он не обещает, что любой сайт будет доступен без авторизации, что каждый элемент получит стабильный ref или что браузерный сценарий автоматически станет регрессионным тестом. Наличие npx — обязательная предпосылка wrapper-режима; при его отсутствии сначала нужно установить Node.js/npm. Headed-режим полезен для визуальной отладки, но не требуется для каждого запуска. Скилл не требует добавлять новую зависимость в приложение: его задача — дать воспроизводимый терминальный путь к browser automation, snapshots, извлечению данных и диагностике интерфейса.
Для чего подходит
- Проверка пользовательских browser-сценариев
- Диагностика UI в локальном приложении
- Автоматизация Playwright через CLI
Установка
Сначала прочитайте SKILL.md и scripts в исходном репозитории. Затем выполните команду в каталоге проекта:
npx skills add https://github.com/openai/skills/tree/main/skills/.curated/playwright