root_cause_debugger — субагент для Claude Code: задачи и установка
Субагент root_cause_debugger для Claude Code разбирает ошибки по логам, трассировкам и поведению приложения. Он связывает симптомы с вероятной причиной и предлагает план проверки и исправления.
лицензия не указана ★ 776 обновлён 2026-11-12
.claude/agents/root_cause_debugger.mdЧто делает root_cause_debugger
root_cause_debugger анализирует сведения о сбое и контекст репозитория, чтобы найти наиболее раннюю подтверждённую причину. Он сопоставляет несколько проверяемых гипотез, отмечает подтверждающие и противоречащие им факты и отделяет первопричину от последствий.
Результат — диагноз в Markdown: условия воспроизведения, симптомы, гипотезы, причинная цепочка, минимальный план исправления и проверки с регрессионными тестами. Если доказательств мало, субагент сообщает, что выбрать причину нельзя. Для установки в Claude Code файл агента размещают по пути .claude/agents/root_cause_debugger.md.
Какие задачи решает
- найти вероятную причину сбоя по логам и стеку вызовов
- отделить первопричину от последствий
- сопоставить гипотезы с фактами из репозитория
- составить план исправления и регрессионной проверки
Примеры запросов агенту
- Разбери эту ошибку по логам и коду репозитория, затем предложи план проверки.
- Найди вероятную первопричину падения теста и отдели её от последствий.
- Сопоставь наблюдаемые симптомы с конфигурацией и предложи минимальное исправление.
Как установить root_cause_debugger
Вручную: положить файлы
.claude/agents/root_cause_debugger.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/root_cause_debugger.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/root_cause_debugger.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о root_cause_debugger
Как установить root_cause_debugger в Claude Code?
Добавьте файл субагента по пути .claude/agents/root_cause_debugger.md.
Что делает root_cause_debugger?
Субагент разбирает симптомы и сведения о репозитории, ранжирует проверяемые гипотезы и формирует диагноз с планом исправления и проверки.
Что делает root_cause_debugger, если данных о сбое недостаточно?
Он сообщает, что доказательств недостаточно для выбора первопричины.