К основному содержанию
скилл CX Codex

022-root-cause-analysis — скилл для Claude Code и Cursor

Скилл 022-root-cause-analysis для Claude Code проводит анализ корневых причин методами «Пять почему», Fishbone и Current Reality Tree. Помогает найти причину ошибки, а не заклеить симптом.

Apache-2.0 144 установок ★ 465 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jabrena/plinth --skill 022-root-cause-analysis -a claude-code
Открыть на GitHub

Что делает 022-root-cause-analysis

Перед тем как предложить исправление, он отделяет симптом — наблюдаемый эффект — от корневой причины, которая этот эффект порождает.

Внутри четыре техники. «Пять почему» строит цепочку вопросов от симптома к причине, останавливаясь там, где следующий шаг потребовал бы догадки. Fishbone (Ishikawa) раскладывает кандидатов по категориям — люди, процесс, технологии, среда — когда причин может быть несколько. Current Reality Tree связывает несколько симптомов с одним или двумя общими корневыми проблемами через причинно-следственные цепочки. Четвёртый шаг — назвать ограничение, которое удерживает систему в текущем состоянии, даже если оно не самое заметное.

Скилл читает references/022-root-cause-analysis.md перед каждым сеансом, поэтому без этого файла в репозитории анализ не запустится. Находки передаются дальше в 023-assumption-analysis и остальные линзы Functional Specification из набора Plinth Toolkit.

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

  • найти корневую причину бага, а не залатать симптом
  • построить диаграмму Fishbone по проблеме с несколькими измерениями
  • связать несколько симптомов с одной корневой проблемой через Current Reality Tree
  • определить ограничение, которое держит систему в текущем состоянии
  • подготовить раздел Root Cause Analysis для Functional Specification

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

  • Найди корневую причину этой проблемы методом «Пять почему»
  • Построй диаграмму Fishbone для этого бага — разбей причины по категориям
  • Используй Current Reality Tree, чтобы связать эти симптомы и найти общую причину

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

1Через Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 022-root-cause-analysis -a claude-code

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

~/.claude/skills/022-root-cause-analysis/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/022-root-cause-analysis/

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

Вопросы о 022-root-cause-analysis

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

Выполните npx skills add jabrena/plinth --skill 022-root-cause-analysis -a claude-code. Скилл появится в ~/.claude/skills/022-root-cause-analysis/SKILL.md.

Что делает скилл 022-root-cause-analysis?

Он ведёт интерактивный анализ корневых причин: задаёт уточняющие вопросы, строит цепочки «Пять почему», диаграммы Fishbone и Current Reality Tree, называет ограничение системы. Фиксирует, что осталось неясным, и не предлагает исправление, пока причина не установлена.

Нужен ли файл references/022-root-cause-analysis.md в репозитории?

Да. Скилл обязан прочитать этот файл перед запуском анализа — без него guidance не применяется.

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

SKILL.md · Apache-2.0
---
name: 022-root-cause-analysis
description: Use when a framed problem needs root-cause investigation rather than a symptom-level fix, applying Five Whys, Fishbone (Ishikawa), Current Reality Tree, and constraint identification. This should trigger when an issue's Root Cause Analysis point of view needs evaluation, or when a maintainer directly asks to find the root cause of a problem before proposing a fix. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Root Cause Analysis

Guide the identification of root causes, not symptoms, for a framed problem, using Five Whys, Fishbone (Ishikawa), Current Reality Tree, and constraint identification. **This is an interactive SKILL**.

**What is covered in this Skill?**

- Five Whys for a linear causal chain from a symptom to a root cause
- Fishbone (Ishikawa) for categorized candidate causes across multiple dimensions
- Current Reality Tree for interconnected causes and effects with a small number of core problems
- Constraint identification for the limiting factor holding the current state in place
- Choosing the technique(s) proportionate to the problem's complexity
- Feeding root-cause findings into `023-assumption-analysis` and the remaining Functional Specification lenses

## Constraints

Distinguish root causes from symptoms before recommending a fix. When this technique is orchestrated by another workflow, the orchestrator owns clarifying-question sequencing; when applied standalone, ask directly.

- **MUST** read `references/022-root-cause-analysis.md` before applying Root Cause Analysis guidance
- **MUST** distinguish a symptom (an observed effect) from a root cause (the condition that produces it)
- **MUST** apply Five Whys as a chain of "why" questions grounded in evidence from the problem frame, not assumption
- **MUST** apply Fishbone to organize candidate causes into categories (for example people, process, technology, environment) when more than one causal dimension is plausible
- **MUST** apply Current Reality Tree when multiple symptoms may share one or a small number of core problems connected by cause-effect relationships
- **MUST** identify the constraint limiting the current state, not only the most visible cause
- **MUST NOT** invent a root cause when the available evidence is vague or ambiguous; flag the gap for a clarifying question instead

## When to use this skill

- Find the root cause of this problem
- Apply Five Whys to this issue
- Build a Fishbone diagram for this problem
- Use Current Reality Tree to connect these symptoms
- Identify the constraint limiting the current state
- Draft the Root Cause Analysis section of a Functional Specification

## Workflow

1. **Read the Reference**

Read `references/022-root-cause-analysis.md`, then identify the symptom(s) evidenced by the problem frame.

2. **Apply Five Whys**

Chain "why" questions from the symptom toward an evidenced root cause, stopping when further "why" steps would require guessing.

3. **Apply Fishbone When Multiple Dimensions Are Plausible**

Organize candidate causes into categories when more than one causal dimension (people, process, technology, environment) is plausible.

4. **Apply Current Reality Tree When Symptoms Interconnect**

Connect multiple symptoms to a small number of shared core problems through cause-effect relationships when the symptoms appear related.

5. **Identify the Constraint**

Name the constraint limiting the current state, distinct from the most visible or most recently reported cause.

6. **Report the Root Cause Findings**

Report findings using Five Whys, Fishbone, Current Reality Tree, and the identified constraint, and flag any finding left open pending a clarifying answer.

## Reference

For detailed guidance, examples, and constraints, see [references/022-root-cause-analysis.md](references/022-root-cause-analysis.md).

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
root-cause-analysis aj-geddes Скилл root-cause-analysis ведёт разбор инцидента по шагам и доводит до причины, которую можно устранить, а не залатать симптом. CX Codex +1 940установок root-cause-analyzer alirezarezvani Субагент root-cause-analyzer для Claude Code и Cursor, который систематически анализирует корневые причины ошибок, проблем производительности и сбоев. Используй, когда нужно разобраться, почему код ломается, а не просто исправить симптом. CX Codex ★ 788звёзд репо root-cause-analyst SuperClaude-Org Субагент root-cause-analyst для Claude Code систематически расследует сбои и системные ошибки, собирая логи и проверяя гипотезы. Помогает найти первопричины сложных багов вместо борьбы с симптомами. CX Codex ★ 23 950звёзд репо thinking-five-whys-plus tjboudreaux Скилл thinking-five-whys-plus выстраивает доказательную цепочку «пять почему» от локализованного бага к системной причине. Помогает найти корень проблемы, когда быстрые заплатки не предотвращают повторных сбоев. CX Codex +1 671установок why NeoLabHQ Скилл why разбирает технические сбои через метод «пяти почему», спускаясь от внешних симптомов к системным корням проблемы. Пригодится при расследовании инцидентов и нестабильных тестов. CX Codex +1 1 300установок om-root-cause open-mercato Скилл om-root-cause находит причину подтверждённого бага в кодовой базе и готовит краткий план правок для следующего шага автоисправления. Не трогает файлы и работает строго на чтение. CX Codex +1 3 700установок

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

Весь набор →
811-regulations-eu-market-abuse-regulation Скилл 811-regulations-eu-market-abuse-regulation помогает разбирать Java-системы на предмет контролей EU Market Abuse Regulation, доказательств и маршрутов эскалации. CX Codex +1 166установок 813-regulations-iso-42001 Скилл 813-regulations-iso-42001 проверяет Java-системы с GenAI через призму ISO/IEC 42001 и помогает оформить инженерные контроли, доказательства и зоны эскалации. CX Codex +1 165установок 812-regulations-eu-product-liability-directive Скилл 812-regulations-eu-product-liability-directive переводит требования директивы ЕС 2024/2853 в инженерные артефакты: область охвата, тесты опасных сценариев, история обновлений и предупреждения для Java-продуктов и ИИ-функций. CX Codex +1 165установок 810-regulations-eu-mifid-ii Скилл 810-regulations-eu-mifid-ii помогает проверить Java-сервисы на соответствие нормам MiFID II и подготовить технические доказательства комплаенса перед релизом. CX Codex +1 165установок 025-quality-attribute-discovery Скилл 025-quality-attribute-discovery помогает выявить и расставить приоритеты нефункциональных требований до начала архитектурной работы. Он связывает каждое требование с фактами о проблеме и её контексте. CX Codex +1 143установок 024-context-mapping Скилл 024-context-mapping для Claude Code, Codex, Cursor и других агентов, который собирает карту контекста вокруг задачи: существующие системы, интеграции, владельцы и внешние зависимости. CX Codex +1 142установок 023-assumption-analysis Скилл 023-assumption-analysis помогает выявить допущения и неизвестные в проблеме, оценить их и составить план проверки до начала проектирования. CX Codex +1 140установок 021-problem-framing Скилл 021-problem-framing помогает сформулировать суть проблемы, текущее и желаемое состояние, список заинтересованных лиц и критерии успеха до начала поиска решений. CX Codex +1 139установок

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

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