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

debugger · voltagent/awesome-codex-subagents — субагент для Codex: что делает и как установить

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

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

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

Что делает debugger

Субагент локализует дефекты в кодовой базе и отделяет подтверждённые факты от догадок. Конфигурация запускается на модели gpt-5.6-sol. В работе агент сопоставляет трассировки стека с состоянием среды, проверяет расхождения в потоках данных и собирает минимальный сценарий воспроизведения сбоя.

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

После изменений агент валидирует успешный и ошибочный сценарии, а также граничные случаи интеграции. Если для проверки нужен запуск в тестовом окружении, он прямо об этом напишет.

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

  • локализовать причину падения тестов по трейсам стека
  • построить минимальный воспроизводимый пример для плавающего бага
  • выявить расхождения в потоках данных между ожидаемым и реальным поведением
  • подобрать точечное исправление вместо маскировки симптома

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

  • Изучи стек-трейс из логов сервиса платежей и найди место сбоя
  • Построй минимальный воспроизводимый пример для упавшего теста auth_spec.py
  • Проверь, почему метод падает только при высокой нагрузке, и предложи точечный фикс

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

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

.codex/agents/debugger.toml

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

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

Вопросы о debugger

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

Сохраните конфигурацию субагента в файл .codex/agents/debugger.toml внутри вашего проекта.

Что делает субагент debugger?

Он проводит изоляцию багов по стектрейсам, поведению рантайма и упавшим тестам, предлагая минимальные правки кода.

Назовёт ли субагент причину сбоя сразу?

Нет. Правила запрещают ему утверждать окончательную причину поломки без подтверждённых улик, пока этого не запросит родительский агент.

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

debugger.toml · MIT
# debugger

Use when a task needs deep bug isolation across code paths, stack traces, runtime behavior, or failing tests.

Own debugging and root-cause isolation 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:
- precise failure-surface mapping from trigger to observed symptom
- stack trace and runtime-state correlation to isolate likely fault origin
- control-flow and data-flow divergence between expected and actual behavior
- concurrency, timing, and ordering issues that produce intermittent failures
- environment/config differences that can explain non-reproducible bugs
- minimal reproducible case construction to shrink problem space
- fix strategy that removes cause rather than masking the symptom

Quality checks:
- verify hypothesis ranking includes confidence and disconfirming evidence needs
- confirm recommended fix addresses triggering condition and recurrence risk
- check one success path and one failure path after proposed change
- ensure unresolved uncertainty is explicit with next diagnostic step
- call out validations requiring runtime instrumentation or integration environment

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 claim definitive root cause without supporting evidence unless explicitly requested by the parent agent.

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

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →

Сначала — debugger от других авторов.

debugger VoltAgent Community Субагент debugger диагностирует сбои, разбирает логи и устраняет первопричины багов в проекте. Пригодится при падениях сервиса или плавающих ошибках. CX Codex 13 459установок debugger Rohit Ghumare Субагент debugger для Claude Code системно ищет причины сложных ошибок, падений тестов и сбоев во время выполнения. Подключается к задачам, где нужно сначала разобраться в баге, а потом предлагать исправление. CX Codex ★ 2 966звёзд репо debugger CloudAI-X Субагент debugger ищет первопричину падений тестов, утечек памяти и сбоев в коде. Субагент проверяет гипотезы через воспроизведение и логирование, избегая слепых правок. CX Codex ★ 1 424звёзд репо debugger qdhenry Субагент debugger отладки для Claude Code: ищет первопричины сбоев, разбирает упавшие тесты и готовит минимальный патч. CX Codex ★ 1 357звёзд репо debugger justxor Субагент debugger в Claude Code воспроизводит ошибки и падающие тесты, ищет первопричину и проверяет исправление. Разбирает стектрейсы и неожиданные результаты. CX Codex ★ 353звёзд репо llm-debugger patricio0312rev Скилл llm-debugger находит причины сбоев в ответах нейросетей, правит системные промпты и генерирует регрессионные тесты для фиксации ошибок. CX Codex +1 259установок gem-debugger официальный github Субагент gem-debugger для GitHub Copilot ищет причины сбоев, разбирает трассировки стека и помогает воспроизвести ошибки. Он подключается к диагностике регрессий и падений. CX Codex +1 ★ 41 430звёзд репо debugging-toolkit-debugger Seth Hobson Субагент debugging-toolkit-debugger разбирает ошибки, падения тестов и неожиданное поведение: ищет первопричину, предлагает небольшой фикс и проверяет результат. CX Codex ★ 42 780звёзд репо gsd-debugger davepoon Субагент gsd-debugger ищет первопричину багов через проверяемые гипотезы, ведёт журнал отладки и запрашивает подтверждения на контрольных точках. CX Codex ★ 3 785звёзд репо root-cause-debugger zebbern Субагент root-cause-debugger воспроизводит сбои и находит первопричину багов без правок в коде. Помогает локализовать поломку до начала написания фикса. CX Codex ★ 4 719звёзд репо node-inspect-debugger Hermes Agent Скилл node-inspect-debugger запускает отладчик Node.js с реальными брейкпоинтами, шагованием и доступом к переменным вместо console.log. Работает с любым Node-процессом: тесты, dev-сервер, Ink-компоненты. CX Codex +1 403установок

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

Весь набор →
performance-engineer Субагент performance-engineer для диагностики медленных запросов, критических путей и регрессий рендеринга. Находит узкие места в латентности, памяти и базах данных, даёт минимальные рекомендации с расчётом риска. CX Codex ★ 6 505звёзд репо penetration-tester Субагент penetration-tester проводит прикладной аудит безопасности кода, ищет сценарии злоупотреблений и уязвимые места до релиза. CX Codex ★ 6 505звёзд репо gdpr-ccpa-compliance Субагент gdpr-ccpa-compliance для Codex проверяет обработку персональных данных, согласия и права пользователей по GDPR и CCPA/CPRA. Проводит аудит перед изменениями или продажами. CX Codex ★ 6 505звёзд репо error-detective Субагент error-detective для быстрого разбора логов, исключений и stack-trace'ов. Находит вероятный источник сбоя, отделяя первичную ошибку от каскадных эффектов. 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звёзд репо browser-debugger Субагент browser-debugger воспроизводит ошибки в браузере, собирает UI- и сетевые свидетельства и помогает найти причину клиентского сбоя. CX Codex ★ 6 505звёзд репо

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

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