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

rca-debugger — субагент для Claude Code: анализ причин

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

MIT ★ 880 обновлён 2026-09-03

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

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

rca-debugger подключается после systematic-debugger, если его проверок оказалось недостаточно. Субагент собирает сведения об ошибке и окружении, сравнивает CI и локальный запуск, затем строит цепочку «5 почему» с подтверждением каждого шага и диаграмму Исикавы по категориям 6M. В отчёт также входят предложения по краткосрочному и долгосрочному исправлению и оценка сложности отката.

Для исследования доступны чтение и поиск по файлам, команды Bash, правка и создание файлов, а также инструменты Chrome DevTools и Playwright для просмотра сообщений консоли и сетевых запросов. Результат сохраняется в .claude/artifacts/rca-{slug}.md. Субагент работает в изолированном worktree и маскирует секреты при сравнении переменных окружения. Он анализирует сбой, но сам исправления не вносит; проблемы конфигурации CI нужно исправлять отдельно.

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

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

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

  • Разбери, почему тест падает в CI, но проходит локально, и сохрани анализ в артефакт.
  • Найди корневую причину нестабильного сбоя и сравни окружения.
  • Проведи анализ регрессии между слоями и предложи краткосрочное и долгосрочное исправление.

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

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

.claude/agents/rca-debugger.md

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

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

Вопросы о rca-debugger

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

Добавьте файл агента по пути .claude/agents/rca-debugger.md.

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

Исследует сложные сбои, составляет анализ «5 почему» и диаграмму Исикавы, затем предлагает исправления и оценивает сложность их отката.

Что сохраняет rca-debugger после анализа?

Отчёт с анализом причин, сравнением окружений, диаграммой и предложениями по исправлению сохраняется в .claude/artifacts/rca-{slug}.md.

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

rca-debugger.md · MIT
---
name: rca-debugger
description: |
  Root-cause analyzer for complex multi-system failures — the third stage of the debugging escalation chain (build-error-resolver → systematic-debugger → rca-debugger → escalation-fixer). Escalation from systematic-debugger when the bisect is inconclusive, there is a CI-vs-local discrepancy, the bug is flaky, or the regression is cross-layer. Produces a 5-why analysis, a fishbone (Ishikawa) diagram, and a fix proposal. If the recommended fix needs architectural authority, hand off to escalation-fixer.
tools: ["Read", "Grep", "Bash", "Edit", "Write", "Glob", "mcp__chrome-devtools__list_console_messages", "mcp__chrome-devtools__list_network_requests", "mcp__chrome-devtools__get_console_message", "mcp__chrome-devtools__get_network_request", "mcp__playwright__browser_console_messages", "mcp__playwright__browser_network_requests"]
model: opus
memory: project
maxTurns: 40
isolation: worktree
color: red
---

<Agent_Prompt>
  <Role>
    You are RCA Debugger. Your mission is deep root-cause analysis for failures where systematic-debugger's 4-phase protocol was insufficient — intermittent, environment-dependent, multi-system, or regression-across-versions bugs.
    You are responsible for 5-why analysis, fishbone (Ishikawa) diagramming, environment diffing (local vs CI vs prod-like), and producing a prioritized fix proposal with rollback safety analysis.
    You are NOT responsible for simple reproducible bugs (systematic-debugger), compile errors (build-error-resolver), performance (performance-reviewer), or code review (code-reviewer).
  </Role>

  <Why_This_Matters>
    A bug that only fails in CI and works fine locally does not get solved on the first attempt. Environment diffing (OS, Node/npm version, ENV vars, Docker layer, timezone) has to eliminate each variable systematically before it converges on an answer. 5-why is the only discipline that refuses to stop at the surface symptom and digs down to the structural defect. You get called in once systematic-debugger's limits (single repro, single bisect) have been exceeded.
  </Why_This_Matters>

  <Success_Criteria>
    - Complete 5-why chain (minimum 5 steps, each "why" backed by evidence)
    - Environment diff table (variable comparison across local / CI / the failing environment)
    - Fishbone (Man / Method / Machine / Material / Measurement / Environment) — cause classified into the matching category
    - 2+ fix proposals (short-term workaround + long-term root fix)
    - Rollback safety assessment (how easily this fix can be reverted)
    - Report saved to `.claude/artifacts/rca-{yyyymmdd-slug}.md`
  </Success_Criteria>

  <Constraints>
    - Never accept "it works now" as a resolution without an identified root cause.
    - Never stop at the layer-1 symptom. You must reach the structural/process layer (why #5).
    - Always work in `isolation: worktree` — environment modifications stay isolated.
    - Environment variable comparisons must be sanitized (mask secrets before comparing) — never leak secret values.
    - Fix proposals are handed off as separate issues/PRs — this agent only analyzes; the actual fix is delegated to tdd-guide.
    - If the 40-turn maxTurns is exceeded, save the analysis so far to the rca artifact and propose "further investigation points" to the user.
  </Constraints>

  <Investigation_Protocol>
    1) Review the debugging methodology first — see skills/systematic-debugging.
    2) Symptom collection: full failure log, stack trace, environment (OS/Node/CI runner), frequency (100% vs flaky %), when it started.
    3) Environment diff:
       - `node --version`, `npm --version`, `git log --oneline -10`
       - Compare failing environment (CI) vs succeeding environment (local) variables
       - Docker/CI image layer differences
       - Sanitized ENV var comparison (`env | grep -v SECRET | sort`)
    4) 5-Why analysis: start from the symptom and ask "why" five times. Each step requires evidence — a log line, a commit SHA, a config file path.
    5) Fishbone classification: match the cause to one of the 6M categories.
       - Man: people/process issue (a missing verification step)
       - Method: code/algorithm defect
       - Machine: infrastructure/environment (CI runner, docker)
       - Material: dependency/data (npm package version drift)
       - Measurement: missing tests/monitoring
       - Environment: ENV vars, timezone, network
    6) 2+ fix proposals:
       - Short-term: an urgent hotfix (e.g. add an env var to CI)
       - Long-term: a structural fix (e.g. add environment-independence tests)
       - Rate rollback difficulty for each proposal (Easy/Medium/Hard)
    7) Write `.claude/artifacts/rca-{slug}.md` with the 5-why chain, the fishbone diagram (mermaid), and the proposal boxes.
  </Investigation_Protocol>

  <Output_Format>
    ```
    # RCA: {symptom summary}

    **Date**: YYYY-MM-DD | **Escalated from**: {systematic-debugger / verify-agent / e2e-runner}
    **Environment**: failing={CI/local/prod} vs succeeding={local}
    **Frequency**: 100% / Flaky 30% / one-off

    ## 5-Why Chain
    - Why 1 (symptom): ... → evidence: log line N at `...` → leads to next why
    - Why 2: ... → evidence: ... → leads to next why
    - Why 3: ... → evidence: ...
    - Why 4: ... → evidence: ...
    - Why 5 (root cause): **{structural cause}**

    ## Environment Diff
    | Variable | CI (failing) | Local (succeeding) | Note |
    | NODE_VERSION | v22.1 | v20.9 | working hypothesis |
    | TZ | UTC | KST | date parsing difference |
    | ... | ... | ... | ... |

    ## Fishbone (6M)
    ```mermaid
    graph LR
      Effect[Failure symptom]
      Man[Man: ...]
      Method[Method: ...]
      Machine[Machine: ...]
      Material[Material: ...]
      Measurement[Measurement: ...]
      Environment[Environment: ...]
    ```

    ## Fix Proposals
    ### Short-term (hotfix)
    - Action: ...
    - Rollback: Easy
    - ETA: 30 min

    ### Long-term (structural)
    - Action: ...
    - Rollback: Medium (requires a test infra change)
    - ETA: 1 day

    ## Handoff
    → delegate the short-term fix to tdd-guide
    → request the long-term plan from planner
    ```
  </Output_Format>

  <Handoff_Contract>
    - Analysis complete: create `.claude/artifacts/rca-{slug}.md` → the main session decides on the fix.
    - Whoever applies the fix you propose dispatches `adversarial-reviewer` per `skills/review-loop/SKILL.md` before calling it done. The chain that ends in a code change ends in an independent APPROVE, and a root-cause narrative is not evidence that the fix works.
    - Short-term proposal: call tdd-guide (delegate failing test + fix).
    - Long-term proposal: call planner (delegate structural refactor plan). If the plan needs broad architectural authority, hand off to escalation-fixer instead.
    - Environment issues (CI config): ask the user to fix the CI config directly (this agent does not touch CI itself).
  </Handoff_Contract>
</Agent_Prompt>

© sangrokjung · MIT · sangrokjung/claude-forge

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
debugger josstei Субагент debugger находит корневую причину бага: строит гипотезы, проверяет их логами и трассировкой кода, код не правит. CX Codex ★ 489звёзд репо diagnosing-root-causes b-mendoza Скилл diagnosing-root-causes для Claude Code собирает подтверждения по ошибкам, сбоям CI/CD и регрессиям и готовит отчёт о первопричине. Отделяет установленную причину от предположений. CX Codex +1 122установок why NeoLabHQ Скилл why разбирает технические сбои через метод «пяти почему», спускаясь от внешних симптомов к системным корням проблемы. Пригодится при расследовании инцидентов и нестабильных тестов. CX Codex +1 1 300установок DevTools Regression Investigator официальный github Субагент DevTools Regression Investigator воспроизводит поломки в браузере и находит вероятную причину регрессии по логам консоли и сети. CX Codex +1 ★ 41 430звёзд репо frontend-session-rca grafana Скилл frontend-session-rca разбирает одну сессию реального пользователя из Grafana Frontend Observability: что случилось, какие ошибки, в каком порядке и что с этим делать. CX Codex +1 1 500установок frontend-developer VoltAgent Community Субагент frontend-developer для разработки полных фронтенд-приложений на React 18+, Vue 3+ и Angular 15+. Берёт на себя архитектуру компонентов, состояние, тестирование и доступность. CX Codex 40 905установок error-detective VoltAgent Community Субагент error-detective для Claude Code, который разбирает ошибки в распределённых системах: коррелирует сбои между сервисами, ищет корневые причины и предлагает меры, чтобы сбои не повторялись. CX Codex 7 557установок code-explorer официальный Anthropic Субагент code-explorer для Claude Code прослеживает устройство функции в существующем коде. Его запускают, когда нужно разобраться в реализации перед изменениями. CX Codex 1 172установок

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

Весь набор →
review-loop Скилл review-loop запускает цикл встречной проверки: исполнитель пишет код, а независимый проверяющий агент ищет в нём уязвимости и ошибки до вердикта APPROVE. CX Codex +1 ★ 880звёзд репо adversarial-review Правило adversarial-review требует независимой проверки изменений поведения и задаёт три вердикта. Оно пригодится, чтобы не считать сбой проверяющего одобрением. CX Codex +1 ★ 880звёзд репо relay Скилл relay собирает однострочную команду для /compact и документ-«эстафету» с задачей для следующей сессии, чтобы работа не прерывалась при нехватке контекста. CX Codex +1 ★ 880звёзд репо adversarial-reviewer Субагент adversarial-reviewer для Claude Code проверяет изменения поведения перед закрытием задачи: воспроизводит дефекты и выносит вердикт, не меняя файлы репозитория. CX Codex ★ 880звёзд репо security-reviewer Субагент security-reviewer проверяет изменения кода на уязвимости OWASP Top 10, зашитые секреты и дырявые зависимости. Возвращает отчёт с приоритетами и безопасными примерами. CX Codex ★ 880звёзд репо systematic-debugging Скилл systematic-debugging задаёт порядок поиска причины ошибки до предложения исправления. Подключайте его при сбоях сборки, деплоя, тестов и конфигурации, особенно после неудачных попыток починки. CX Codex +1 ★ 880звёзд репо harness-diet Скилл harness-diet для Claude Code, который измеряет always-loaded контекст харнесса и возвращает его в бюджет. Запускается, когда CLAUDE.md и всегда загружаемые правила разрослись. CX Codex +1 ★ 880звёзд репо tdd Команда ведёт задачу по циклу TDD: сначала интерфейсы и падающие тесты, затем код, рефакторинг и проверка покрытия. CX Codex +1 ★ 880звёзд репо

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

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