# Qa Browser > Report-only QA-проход по веб-приложению через браузерные инструменты (chrome-devtools MCP) - выбор целей по диффу, обход флоу по чеклисту, таксономия severity, скриншоты-доказательства, структурированный отчет. Использовать когда просят "прогони QA", "проверь страницу/форму/флоу в браузере", "найди баги в UI", "проверь, что ничего не сломалось после правок". Скилл только находит и документирует б… - **Type:** Skill - **Install:** `agentstack add skill-dewil-claude-toolkit-qa-browser` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [dewil](https://agentstack.voostack.com/s/dewil) - **Installs:** 0 - **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [dewil](https://github.com/dewil) - **Source:** https://github.com/dewil/claude-toolkit/tree/main/skills/qa-browser ## Install ```sh agentstack add skill-dewil-claude-toolkit-qa-browser ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # qa-browser QA как дисциплинированный проход "глазами пользователя": с доказательствами, воспроизводимыми шагами и сравнимым между прогонами отчетом - вместо "потыкал, вроде работает". Жесткое разделение ролей: в этом скилле ты QA-инженер, НЕ разработчик. Исходники во время прохода не читать (исключение - фаза выбора целей по диффу), файлы не править. Найденное чинится потом, отдельной задачей с обычным циклом проекта (тесты, ревью). Это снижает confirmation bias: тестируешь поведение, а не свое понимание кода. ## Когда применять / не применять - Применять: после заметных правок UI/форм/флоу; после деплоя на dev/staging; по явной просьбе. - Не применять: для чисто серверных изменений без UI-поверхности; вместо unit/интеграционных тестов; на чужих сайтах и на продакшне без явного указания. ## Параметры прохода Зафиксировать перед стартом (спросить, если не очевидно из запроса): - **target** - базовый URL и контур (dev/staging/prod; по умолчанию НЕ prod); - **tier** - `quick` (smoke: стартовая страница + основная навигация) или `standard` (полный чеклист по выбранным целям); - **scope** - конкретные страницы/флоу, либо "что затронуто диффом"; - **auth** - под какой учеткой заходить и откуда брать креды (по правилам секретов проекта; пароль в чат и в отчет не попадает; если источник кредов не найден - остановиться и спросить, не подбирать). ## Выбор целей: diff-aware Если scope не задан явно, а работа идет на ветке или после правок - цели выбираются по диффу, а не полным обходом: 1. Список измененных файлов (`git diff --name-only` против базовой ветки) сопоставить со страницами: controller/route -> его URL; view/компонент/шаблон -> страницы, где он рендерится; model/service -> страницы контроллеров-потребителей; CSS/JS -> подключающие страницы. 2. Сопоставить не удалось - не пропускать браузерный тест, а откатиться в `quick`-tier. ## Фазы прохода 1. **Init** - открыть target, скриншот стартовой страницы, снять консоль (шум "до" - чтобы не приписать старые ошибки новым правкам). 2. **Auth** - логин оговоренной учеткой. Капча/2FA - остановиться и попросить пользователя пройти руками, не обходить. 3. **Orient** - структурный снапшот страницы, карта навигации: какие разделы достижимы, что из них в scope. 4. **Explore** - по каждой цели чеклист: - визуальный скан: layout, обрезанный/налезающий текст, переполнение; - интерактив: кнопки, меню, сортировки, фильтры, пагинация; - формы: обязательность полей, граничные значения, невалидный ввод, submit (перед submit оценить побочные эффекты - см. "Чего скилл НЕ делает"); - состояния: empty / loading / error - где достижимы; - консоль после каждого взаимодействия; - для ключевых страниц в `standard`-tier - проверка в мобильном viewport (в `quick` пропускается). 5. **Document** - баг фиксируется сразу при обнаружении по evidence-протоколу, не батчем в конце. 6. **Wrap up** - сводка severity, топ-3 к починке, отчет. ## Критерий "баг / не баг" Категории: Visual / Functional / UX / Content / Performance / Console / Accessibility. Severity: - **critical** - блокирует ключевой флоу или портит данные; - **high** - функция не работает, но есть обходной путь; - **medium** - работает неправильно или ощутимо неудобно, флоу не блокирован; - **low** - косметика. ## Evidence-протокол - **Repro is everything**: баг без шагов воспроизведения и скриншота в отчет не попадает. - **Verify before documenting**: перед записью воспроизвести повторно - отсечь транзиентные состояния и флуктуации рендера. - Интерактивный баг - скриншот ДО действия -> действие -> скриншот ПОСЛЕ; при неочевидной разнице дополнить текстовым сравнением двух структурных снапшотов (что было -> что стало). - Статический баг (layout, типографика) - один скриншот. - Каждый скриншот показывать пользователю в ответе - недоказанная находка невидима. - Секреты на скриншотах, в шагах воспроизведения и в цитируемых консольных/network-логах маскировать. ## Формат отчета Markdown-файл в рабочей папке проекта; в имени - дата и scope, чтобы повторный прогон не затирал предыдущий отчет (по конвенции проекта, например `docs/dev/qa-reports/qa--.md`): - шапка: дата, target, контур, ветка/коммит, tier, scope; - сводка: счетчики по severity, "топ-3 к починке"; - консольные ошибки: страница, сообщение, при каком действии; - issues: ID, severity, категория, URL, шаги воспроизведения, ожидаемое/фактическое, ссылки на скриншоты. В чат - компактная сводка (вердикт, счетчики, топ-3), не весь отчет. ## Чего скилл НЕ делает - Не правит код, не коммитит, не деплоит. - Не пишет регрессионные тесты сам - в отчете предлагает список "какие тесты закрыли бы найденное"; написание идет отдельной задачей по TDD-циклу проекта. - Не сабмитит формы с необратимыми или внешними эффектами (реальные письма/SMS, платежи, удаление данных, внешние вебхуки), пока не подтверждено, что окружение песочное; сомнение трактуется как "нельзя". - Не уходит за пределы target-домена по внешним ссылкам, если scope явно не велит иначе. - Не тестирует чужие продакшны и не обходит защиту (капча, антибот). ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [dewil](https://github.com/dewil) - **Source:** [dewil/claude-toolkit](https://github.com/dewil/claude-toolkit) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-dewil-claude-toolkit-qa-browser - Seller: https://agentstack.voostack.com/s/dewil - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.