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

root-cause-debugger — субагент для Claude Code: обзор и запуск

Субагент root-cause-debugger воспроизводит сбои и находит первопричину багов без правок в коде. Помогает локализовать поломку до начала написания фикса.

MIT ★ 4 719 обновлён 2026-10-30

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/root-cause-debugger.md
Открыть на GitHub

Что делает root-cause-debugger

Субагент воспроизводит системные ошибки, собирает точный путь падения и изолирует первопричину до написания кода. Он запускает реальные команды падения в терминале через Bash, проверяет симптомы, ищет файлы через Glob, изучает код с помощью Read и Grep. По умолчанию настроен на модель opus с максимальным уровнем рассуждений (effort: max).

Править исходники субагент не станет: по регламенту ему запрещено изменять файлы проекта, накладывать патчи, коммитить или ставить глобальные пакеты. Его задача — составить цепочку «причина-следствие» с указанием строк path:line и отсечь ложные гипотезы. Если для воспроизведения не хватает доступов или данных, агент завершает работу со статусом blocked.

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

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

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

  • Запусти субагента root-cause-debugger, чтобы локализовать падение тестов в платёжном шлюзе
  • Разбери причину сбоя сборки после обновления зависимостей, но сам код не меняй

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

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

.claude/agents/root-cause-debugger.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о root-cause-debugger

Как установить root-cause-debugger в Claude Code?

Сохраните конфигурацию субагента в файл .claude/agents/root-cause-debugger.md в корне вашего проекта.

Что делает root-cause-debugger?

Субагент воспроизводит сбой в изолированном цикле, находит первопричину проблемы и выдаёт структурированный отчёт с номерами строк path:line.

Исправляет ли субагент найденный баг?

Нет. Субагенту явно запрещено вносить правки в код, создавать коммиты или изменять постоянное состояние окружения.

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

root-cause-debugger.md · MIT
---
name: root-cause-debugger
description: "Use proactively when a failure must be reproduced, isolated, and causally explained before a fix is written. Do not use when the cause is already established and implementation is authorized."
tools:
  - Read
  - Grep
  - Glob
  - Bash
  - PowerShell
  - LSP
model: opus
permissionMode: default
effort: max
---

# Mission

Reproduce and explain the root cause of the assigned failure. Own diagnosis; do not implement the fix.

## Method

1. Capture the reported symptom, environment, expected behavior, and exact reproduction path.
2. Run the real failing path when safe and preserve commands, exit status, output, and side effects.
3. Narrow the first incorrect boundary and trace backward from effect to cause.
4. Test competing hypotheses with the smallest discriminating checks.
5. Search for sibling occurrences sharing the same causal pattern and define the smallest credible fix boundary.

## Constraints

- Do not edit source, apply a fix, commit, install globally, or change durable external state.
- Runtime caches and build artifacts are allowed only when reproduction requires them; remove session-only artifacts when safe.
- Do not treat an empty result, skipped test, mock-only success, or changed symptom as reproduction.
- State whether relevant mutable state is per-session, per-channel, or global.

## Output

Begin with:

ROLE: root-cause-debugger
STATUS: complete|blocked|inconclusive

Then provide: reproduced symptom, command and exit status, causal chain, precise `path:line` evidence, ruled-out hypotheses, sibling occurrences, fix constraints, and remaining unknowns. Distinguish the root cause from downstream effects.

## Stop conditions

Return `blocked` when safe reproduction needs unavailable credentials, authority, environment, or user data. Return `inconclusive` when the symptom cannot be reproduced or evidence does not distinguish the remaining hypotheses.

© zebbern · MIT · zebbern/claude-code-guide

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

Все субагенты по теме «Тесты и QA» →
root-cause-tracing NeoLabHQ Скилл root-cause-tracing учит агента идти по стеку вызовов назад, пока не найдётся исходный триггер ошибки, и править там, а не на месте падения. CX Codex +1 1 400установок root_cause_debugger AgenticOrgLab Субагент root_cause_debugger для Claude Code разбирает ошибки по логам, трассировкам и поведению приложения. Он связывает симптомы с вероятной причиной и предлагает план проверки и исправления. CX Codex ★ 776звёзд репо root-cause-analyst SuperClaude-Org Субагент root-cause-analyst для Claude Code систематически расследует сбои и системные ошибки, собирая логи и проверяя гипотезы. Помогает найти первопричины сложных багов вместо борьбы с симптомами. CX Codex ★ 23 950звёзд репо causal-inference-root-cause lyndonkl Скилл causal-inference-root-cause ведёт агента по пяти шагам от симптома к первопричине: строит конкурирующие гипотезы, проверяет их и отделяет причину от корреляции. CX Codex +1 110установок root-cause-analysis markpitt Скилл root-cause-analysis для Claude Code разбирает сбои и другие проблемы с помощью 5 Why, диаграммы Исикавы, анализа Парето и дерева отказов. Помогает найти причину, а не ограничиваться симптомом. CX Codex +1 107установок root-cause-analyzer alirezarezvani Субагент root-cause-analyzer для Claude Code и Cursor, который систематически анализирует корневые причины ошибок, проблем производительности и сбоев. Используй, когда нужно разобраться, почему код ломается, а не просто исправить симптом. CX Codex ★ 788звёзд репо

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

Весь набор →
server-auth-actions Правило server-auth-actions требует проверять аутентификацию и права внутри каждой Server Action. Оно защищает серверные мутации, которые можно вызвать напрямую. CX Codex +1 ★ 4 719звёзд репо setup-use-import-maps Правило setup-use-import-maps требует подключать Three.js через import map с модулями и точной версией, а не старым тегом <script src> с CDN. CX Codex +1 ★ 4 719звёзд репо render-delta-time Правило render-delta-time предписывает использовать delta time в циклах анимации, чтобы скорость движения не зависела от частоты кадров. CX Codex +1 ★ 4 719звёзд репо memory-dispose-geometry Правило memory-dispose-geometry для Claude Code напоминает освобождать геометрию при удалении объектов из сцены. Оно срабатывает при работе с ресурсами Three.js. CX Codex +1 ★ 4 719звёзд репо code-reviewer Субагент code-reviewer для Claude Code проверяет готовые изменения на ошибки и регрессии. Запускается после реализации или при проверке существующего diff. CX Codex ★ 4 719звёзд репо perf-visibility-toggle Правило perf-visibility-toggle учит ассистента скрывать Three.js-компоненты через свойство visible, а не удалять их из дерева React, чтобы видеокарта не пересобирала шейдеры. CX Codex +1 ★ 4 719звёзд репо perf-r3f-perf Правило perf-r3f-perf добавляет в Claude Code знания о r3f-perf — библиотеке для отслеживания производительности Three.js сцен в реальном времени. Помогает находить узкие места: низкий FPS, утечки памяти, лишние пересчёты матриц. CX Codex +1 ★ 4 719звёзд репо codebase-mapper Субагент codebase-mapper исследует структуру репозитория, потоки данных и точки входа перед внесением правок, не меняя рабочий код. CX Codex ★ 4 719звёзд репо

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

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