gsd-browser

gsd-browser — навык для управления браузером через native Rust CLI, когда AI-агенту нужно не просто прочитать HTML, а выполнить и проверить последовательность действий на сайте. В исходном SKILL.md перечислены навигация, заполнение форм, нажатия, снимки состояния, assertions, скриншоты, визуальное сравнение, сетевые моки, структурированное извлечение данных и тестирование веб-приложений. В область применения также входят открытие сайта, просмотр общей картины браузера, пошаговое выполнение сценария, сбор данных, вход на сайт, visual regression и другие программные действия с веб-интерфейсом. Это делает карточку полезной для QA-проверок, smoke-сценариев, повторяемого извлечения данных и задач, где результатом должен быть проверенный state страницы, а не только текстовый ответ. Главное правило рабочего цикла — после изменения страницы заново получить snapshot. Навык использует версионируемые ссылки на элементы вроде @v1:e1; после перехода, отправки формы или динамической загрузки старые refs считаются устаревшими. Поэтому безопасная последовательность выглядит так: navigate, snapshot, найти актуальные элементы, выполнить действие через ref, дождаться network_idle или другого условия и снова сделать snapshot. Такой порядок снижает риск кликнуть по уже изменённому элементу и делает последующий шаг наблюдаемым. Для обработки вывода программой предусмотрен флаг --json, а для ручного чтения можно оставить текстовый режим. В командах click, type и hover позиционный аргумент передаётся без префикса флага: например, click "button.submit"; форма с --selector в исходном примере отмечена как неправильная. Доступны общие параметры --browser-path для пути к Chrome или Chromium, --cdp-url для подключения к уже работающему Chrome, --session для именованной сессии, а также --no-narration-delay для отключения задержки повествования при сохранении истории и событий. Демон auto-starts на браузерных командах; команда daemon health только сообщает состояние и не запускает сессию, тогда как daemon start предназначена для явного предварительного запуска или проверки жизненного цикла. Для пользователя, которому нужно наблюдать работу, предусмотрен live viewer: он показывает живые кадры, историю действий, подписи и ref-оверлеи, а также позволяет pause, step, resume и abort. При этом сами действия продолжают выполняться CLI-командами. SKILL.md направляет к отдельным workflow для навигации, live viewer, scrape-and-extract, test-and-assert, диагностики, настройки и конфигурации; подробные команды и обработка ошибок находятся в связанных references, а не заменяются одной универсальной командой. Практический сценарий начинается с выбора workflow под намерение, затем выполняется навигация и snapshot, после каждого изменения повторяется snapshot, а программные значения извлекаются в JSON. Для теста важно завершить работу проверкой целевого состояния через assertion или визуальное подтверждение; для извлечения — вернуть данные в ожидаемом формате; после окончания браузерной работы daemon следует остановить, если дальнейшая работа с браузером не требуется. Эти критерии ограничивают навык проверяемым результатом и не превращают факт запуска команды в доказательство успешного сценария.