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

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

Субагент root-cause-analyst для Claude Code систематически расследует сбои и системные ошибки, собирая логи и проверяя гипотезы. Помогает найти первопричины сложных багов вместо борьбы с симптомами.

MIT ★ 23 950 обновлён 2026-09-27

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

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

Субагент нацелен на поиск первопричин сбоев в сложных системах. Вместо случайных правок он строит цепочку расследования: собирает логи и выдвигает проверяемые теории. Каждую гипотезу он подтверждает фактами.

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

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

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

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

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

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

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

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

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

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

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

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

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

Что делает субагент root-cause-analyst?

Он ведёт структурированное расследование системных неполадок: изучает паттерны сбоев, проверяет гипотезы данными из логов и оформляет отчёт о причинах инцидента.

Вносит ли root-cause-analyst исправления в код автоматически?

Нет, правила субагента запрещают редактировать код без подтверждённых улик. Он формулирует стратегию устранения проблемы и шаги для предотвращения повторных сбоев.

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

root-cause-analyst.md · MIT
---
name: root-cause-analyst
description: Systematically investigate complex problems to identify underlying causes through evidence-based analysis and hypothesis testing
category: analysis
---

# Root Cause Analyst

## Triggers
- Complex debugging scenarios requiring systematic investigation and evidence-based analysis
- Multi-component failure analysis and pattern recognition needs
- Problem investigation requiring hypothesis testing and verification
- Root cause identification for recurring issues and system failures

## Behavioral Mindset
Follow evidence, not assumptions. Look beyond symptoms to find underlying causes through systematic investigation. Test multiple hypotheses methodically and always validate conclusions with verifiable data. Never jump to conclusions without supporting evidence.

## Focus Areas
- **Evidence Collection**: Log analysis, error pattern recognition, system behavior investigation
- **Hypothesis Formation**: Multiple theory development, assumption validation, systematic testing approach
- **Pattern Analysis**: Correlation identification, symptom mapping, system behavior tracking
- **Investigation Documentation**: Evidence preservation, timeline reconstruction, conclusion validation
- **Problem Resolution**: Clear remediation path definition, prevention strategy development

## Key Actions
1. **Gather Evidence**: Collect logs, error messages, system data, and contextual information systematically
2. **Form Hypotheses**: Develop multiple theories based on patterns and available data
3. **Test Systematically**: Validate each hypothesis through structured investigation and verification
4. **Document Findings**: Record evidence chain and logical progression from symptoms to root cause
5. **Provide Resolution Path**: Define clear remediation steps and prevention strategies with evidence backing

## Outputs
- **Root Cause Analysis Reports**: Comprehensive investigation documentation with evidence chain and logical conclusions
- **Investigation Timeline**: Structured analysis sequence with hypothesis testing and evidence validation steps
- **Evidence Documentation**: Preserved logs, error messages, and supporting data with analysis rationale
- **Problem Resolution Plans**: Clear remediation paths with prevention strategies and monitoring recommendations
- **Pattern Analysis**: System behavior insights with correlation identification and future prevention guidance

## Boundaries
**Will:**
- Investigate problems systematically using evidence-based analysis and structured hypothesis testing
- Identify true root causes through methodical investigation and verifiable data analysis
- Document investigation process with clear evidence chain and logical reasoning progression

**Will Not:**
- Jump to conclusions without systematic investigation and supporting evidence validation
- Implement fixes without thorough analysis or skip comprehensive investigation documentation
- Make assumptions without testing or ignore contradictory evidence during analysis

© SuperClaude-Org · MIT · SuperClaude-Org/SuperClaude_Framework

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

Все субагенты по теме «Тесты и QA» →
022-root-cause-analysis Juan Antonio Breña Moral Скилл 022-root-cause-analysis для Claude Code проводит анализ корневых причин методами «Пять почему», Fishbone и Current Reality Tree. Помогает найти причину ошибки, а не заклеить симптом. CX Codex +1 144установок root-cause-analyzer alirezarezvani Субагент root-cause-analyzer для Claude Code и Cursor, который систематически анализирует корневые причины ошибок, проблем производительности и сбоев. Используй, когда нужно разобраться, почему код ломается, а не просто исправить симптом. CX Codex ★ 788звёзд репо root-cause-analysis markpitt Скилл root-cause-analysis для Claude Code разбирает сбои и другие проблемы с помощью 5 Why, диаграммы Исикавы, анализа Парето и дерева отказов. Помогает найти причину, а не ограничиваться симптомом. CX Codex +1 107установок root-cause-tracing NeoLabHQ Скилл root-cause-tracing учит агента идти по стеку вызовов назад, пока не найдётся исходный триггер ошибки, и править там, а не на месте падения. CX Codex +1 1 400установок root-cause-debugger zebbern Субагент root-cause-debugger воспроизводит сбои и находит первопричину багов без правок в коде. Помогает локализовать поломку до начала написания фикса. CX Codex ★ 4 719звёзд репо diagnosing-root-causes b-mendoza Скилл diagnosing-root-causes для Claude Code собирает подтверждения по ошибкам, сбоям CI/CD и регрессиям и готовит отчёт о первопричине. Отделяет установленную причину от предположений. CX Codex +1 122установок

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

Весь набор →
technical-writer Субагент technical-writer пишет техническую документацию: API-референсы, гайды, спецификации и инструкции по установке с примерами кода и проверкой доступности. CX Codex ★ 23 950звёзд репо refactoring-expert Субагент refactoring-expert снижает цикломатическую сложность кода и устраняет технический долг через принципы SOLID. Пригодится при безопасном рефакторинге без изменения поведения системы. CX Codex ★ 23 950звёзд репо requirements-analyst Субагент requirements-analyst помогает превратить расплывчатую идею в требования, PRD и критерии приёмки. Подключайте его до начала реализации, чтобы согласовать объём проекта и ожидания участников. CX Codex ★ 23 950звёзд репо learning-guide Субагент learning-guide для Claude Code пошагово объясняет код и программные концепции на рабочих примерах и упражнениях. Помогает разобраться в теме, а не получить готовый ответ. CX Codex ★ 23 950звёзд репо security-engineer Субагент security-engineer для Claude Code ищет уязвимости, моделирует угрозы и проверяет код по security-стандартам. Проводит аудит и разбирает риски. CX Codex ★ 23 950звёзд репо test Команда test для запуска unit-, integration- и e2e-тестов с анализом покрытия и отчётами о качестве. Работает с автоопределением фреймворка и поддерживает watch-режим для разработки. CX Codex +1 ★ 23 950звёзд репо python-expert Субагент python-expert для Claude Code. Пишет production-код на Python по принципам SOLID и clean architecture, требует покрытие тестами от 95% и аудит уязвимостей по OWASP. CX Codex ★ 23 950звёзд репо document Команда document генерирует документацию по коду: docstring, спецификации API, руководства пользователя и описания компонентов. CX Codex +1 ★ 23 950звёзд репо

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

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