ce-test-browser

О ce-test-browser

Рабочий процесс для выполнения сквозных тестов браузера на страницах, затронутых пул-реквестом или изменениями в ветке, с использованием исключительно командной строки agent-browser. Он намеренно избегает использования любых альтернативных систем автоматизации браузеров или интеграции с MCP браузера; в Claude Code он не использует инструменты Chrome MCP, а в Codex не заменяет другие инструменты просмотра. agent-browser используется для открытия страниц, нажатия на элементы, заполнения форм, создания скриншотов и извлечения отображаемого контента. Он принимает аргумент, которым может быть номер PR, имя ветки, слово «current» или флаг --port.

Рабочий процесс сначала проверяет, установлен ли agent-browser, и, если его нет, останавливается с указанием запустить /ce-setup. Затем он спрашивает, запускать ли в режиме с интерфейсом (headed) или без него (headless), за исключением режима конвейера, где по умолчанию используется режим без интерфейса без блокировки. Объём тестирования определяется по изменённым файлам с помощью команды `gh pr view` для номера PR или `git diff` по отношению к ветке `main` для текущего состояния или другой ветки. Изменённые файлы сопоставляются с тестируемыми маршрутами через таблицу шаблонов, охватывающую представления Rails, контроллеры, контроллеры Stimulus, ViewComponents, макеты, таблицы стилей, хелперы, а также пути к приложению и компонентам Next.js, в результате чего формируется список URL-адресов для тестирования.

Обработка портов отличает ручной режим от режима конвейера. Она определяет предпочтительный порт на основе явного аргумента `--port`, контекстных инструкций проекта, скриптов `dev/start` в файле `package.json`, файлов настроек среды или значения по умолчанию 3000, при этом намеренно не ищет порт в тексте документации. В режиме конвейера он сканирует вверх в поисках свободного порта, поскольку несколько агентов могут работать параллельно, и запускает сервер разработки в фоновом режиме, если ни один из них не находится в режиме прослушивания, ожидая до 30 секунд; в ручном режиме он напрямую использует предпочтительный порт и просит пользователя запустить сервер, если тот не работает. Для каждого затронутого маршрута он переходит по нему и создаёт интерактивный снимок, используя флаг `--headed`, если пользователь выбрал режим просмотра, а затем проверяет ключевые элементы, такие как заголовок страницы или подзаголовок, а также основные интерактивные элементы. Используйте эту функцию, чтобы убедиться, что страницы, затронутые изменениями, по-прежнему корректно отображаются и работают.

Часто задаваемые вопросы

Какой инструмент автоматизации браузера использует этот навык?

Исключительно командную строку agent-browser. Он не использует инструменты Chrome MCP в Claude Code и не заменяет другие инструменты просмотра в Codex.

Что произойдет, если agent-browser не установлен?

Он предложит пользователю выполнить команду /ce-setup для текущей установки, установить agent-browser и повторить попытку, а затем остановится, поскольку навык не может работать без него.

Как он определяет, какие страницы тестировать?

Он получает измененные файлы из gh pr view (для PR) или git diff по отношению к main (для ветки или текущего состояния), затем сопоставляет эти файлы с маршрутами с помощью таблицы шаблонов файлов, чтобы составить список URL-адресов.

Как выбирается порт dev-server?

По приоритету: явно указанный аргумент --port, инструкции в контексте проекта, скрипты dev в package.json, файлы среды, такие как .env, затем по умолчанию — 3000. Он не ищет порт в тексте.

Чем отличается режим конвейера?

Он пропускает выбор между режимами с интерфейсом (headed) и без него (headless) и по умолчанию использует режим без интерфейса, сканирует сеть вверх в поисках действительно свободного порта, поскольку агенты могут работать параллельно, и автоматически запускает сервер разработки в фоновом режиме, если ни один из них не находится в режиме прослушивания.