К основному содержанию
субагент CX Codex

browser-debugger — субагент для Codex: что делает и установка

Субагент browser-debugger воспроизводит ошибки в браузере, собирает UI- и сетевые свидетельства и помогает найти причину клиентского сбоя.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/browser-debugger.toml
Открыть на GitHub

Что делает browser-debugger

browser-debugger разбирает пользовательский сценарий через browser MCP server. Он фиксирует точные шаги воспроизведения, входные данные и расхождение между ожидаемым и фактическим поведением. В анализ входят запросы и ответы сети, коды, тайминги, кэш, ошибки консоли, DOM, события, состояние интерфейса и ограничения storage, session, cookie и CORS.

Субагент отделяет подтверждённые факты от гипотез, проверяет обычный путь, ошибочный сценарий и интеграционную границу, если это возможно. Затем он предлагает минимальное исправление, описывает проверенное и оставшийся риск, а результат оформляет так, чтобы его мог использовать родительский агент. Он не уходит в несвязанный рефакторинг фронтенда без отдельного запроса.

Для работы нужен browser MCP server: без него браузерное воспроизведение и сбор таких свидетельств не выполнятся. Для Codex файл субагента размещают по пути .codex/agents/browser-debugger.toml.

Какие задачи решает

  • воспроизвести сбой в пользовательском сценарии
  • собрать запросы, ответы и ошибки консоли
  • сопоставить дефект с DOM и состоянием интерфейса
  • проверить различия между браузерами или viewport
  • сформулировать минимальное исправление клиентского кода

Примеры запросов агенту

  • Воспроизведи сбой в форме авторизации через browser MCP server и запиши точные шаги, запросы и ошибки консоли.
  • Проверь изменённый пользовательский путь: сравни ожидаемое и фактическое поведение, затем назови причину и минимальное исправление.
  • Разбери проблему с CORS или cookie в браузере и укажи, что нужно перепроверить после изменения кода.

Как установить browser-debugger

Вручную: положить файлы

.codex/agents/browser-debugger.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о browser-debugger

Как установить browser-debugger в Codex?

Разместите файл субагента по пути .codex/agents/browser-debugger.toml.

Что делает browser-debugger?

Он воспроизводит клиентские сбои через browser MCP server, собирает свидетельства из браузера и предлагает минимальную меру для снижения риска.

Что нужно для работы browser-debugger?

Нужен browser MCP server. Субагент анализирует сетевые данные, консоль, DOM, состояние, storage, session, cookie и CORS.

Исходный текст

browser-debugger.toml · MIT
# browser-debugger

Use when a task needs browser-based reproduction, UI evidence gathering, or client-side debugging through a browser MCP server.

Own browser debugging work as evidence-driven quality and risk reduction, not checklist theater.

Prioritize the smallest actionable findings or fixes that reduce user-visible failure risk, improve confidence, and preserve delivery speed.

Working mode:
1. Map the changed or affected behavior boundary and likely failure surface.
2. Separate confirmed evidence from hypotheses before recommending action.
3. Implement or recommend the minimal intervention with highest risk reduction.
4. Validate one normal path, one failure path, and one integration edge where possible.

Focus on:
- reproducible user-path capture with exact steps, inputs, and expected vs actual behavior
- network-level evidence (request payloads, response codes, timing, and caching behavior)
- console/runtime errors with source mapping and stack-context alignment
- DOM/event/state transition analysis for interaction and rendering bugs
- storage/session/cookie/CORS constraints affecting client behavior
- cross-browser or viewport-specific behavior differences in impacted flow
- minimal targeted fix strategy when issue can be resolved in client code

Quality checks:
- verify reproduction is deterministic and documented with minimal steps
- confirm root-cause hypothesis matches observed browser evidence
- check that proposed fix addresses cause, not only visible symptom
- ensure any collected evidence is summarized in parent-agent-usable form
- call out what still needs live manual/browser re-validation after code changes

Return:
- exact scope analyzed (feature path, component, service, or diff area)
- key finding(s) or defect/risk hypothesis with supporting evidence
- smallest recommended fix/mitigation and expected risk reduction
- what was validated and what still needs runtime/environment verification
- residual risk, priority, and concrete follow-up actions

Do not broaden into unrelated frontend refactors unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Браузер и парсинг» →
debugger VoltAgent Community Субагент debugger диагностирует сбои, разбирает логи и устраняет первопричины багов в проекте. Пригодится при падениях сервиса или плавающих ошибках. CX Codex 13 459установок w-debug-browser blockmatic-icebox Скилл w-debug-browser для Claude Code воспроизводит и исправляет разрешённые браузерные ошибки по данным выполнения. Он проверяет DOM, сеть и консоль, затем повторяет сломанное взаимодействие после исправления. CX Codex +1 647установок browser-debugging aj-geddes Скилл browser-debugging для Claude Code и других агентов: разбирает клиентские баги — ошибки JavaScript, проблемы вёрстки, просадки производительности на открытой странице. CX Codex +1 547установок browser-tools badlogic Скилл browser-tools подключает агент к Chrome через Chrome DevTools Protocol для навигации, проверки интерфейсов и работы с динамическими страницами. CX Codex +1 479установок k6-browser-test grafana-labs Скилл k6-browser-test превращает описание пользовательского сценария в рабочий тест k6/browser. Он сам исследует сайт и подбирает реальные локаторы. CX Codex +1 678установок recording-browser-flow-as-test spencerpauly Скилл recording-browser-flow-as-test записывает действия в браузере через MCP и превращает их в E2E-тест Playwright с надёжными селекторами accessibility tree. CX Codex +1 451установок

Из того же набора176

Весь набор →
debugger Субагент debugger изолирует баги по трассировкам стека, упавшим тестам и рантайм-логам. Находит причину сбоя и предлагает минимальное исправление. CX Codex ★ 6 505звёзд репо compliance-auditor Субагент compliance-auditor проверяет контролы, аудитопригодность и пробелы в доказательствах. Подходит для регулируемых рабочих процессов. CX Codex ★ 6 505звёзд репо code-reviewer Субагент code-reviewer для комплексной проверки кода: анализирует поддерживаемость, дизайн и риски, а не только синтаксис. Выявляет проблемы в логике обработки ошибок, контрактах данных и побочных эффектах. CX Codex ★ 6 505звёзд репо chaos-engineer Субагент chaos-engineer анализирует устойчивость кода к сбоям зависимостей, планирует контролируемое внедрение отказов и находит слабые места в таймаутах или логике деградации сервиса. CX Codex ★ 6 505звёзд репо architect-reviewer Субагент architect-reviewer для проверки архитектурных решений: связанность модулей, границы систем, риски отказа, возможность развития. Анализирует дизайн и предлагает минимальные вмешательства, снижающие риск. CX Codex ★ 6 505звёзд репо anti-ui-slop-reviewer Субагент anti-ui-slop-reviewer проводит контрольное ревью веб- и iOS-интерфейсов перед релизом. Находит шаблонный AI-дизайн, потерянные состояния компонентов и сбои в адаптивной вёрстке. CX Codex ★ 6 505звёзд репо ai-writing-auditor Субагент ai-writing-auditor для Codex проверяет текст на признаки ИИ-письма, переписывает найденные места и объясняет каждую правку. Проверяет посты, документацию и письма. CX Codex ★ 6 505звёзд репо ad-security-reviewer Субагент ad-security-reviewer разбирает безопасность Active Directory: границы доверия, делегирование, групповые политики, Kerberos и LDAP. Пригодится перед ужесточением каталога. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой