# diagnosing-root-causes

Скилл diagnosing-root-causes для Claude Code собирает подтверждения по ошибкам, сбоям CI/CD и регрессиям и готовит отчёт о первопричине. Отделяет установленную причину от предположений.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 122 установки · ★ 3 у репозитория
- Автор: b-mendoza
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/b-mendoza/agent-skills/tree/HEAD/skills/diagnosing-root-causes/SKILL.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/diagnosing-root-causes

## Что делает

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

Работа идёт по конечной схеме состояний. Анализ по умолчанию ограничен чтением: действия уровня Tier C скилл не выполняет даже после одобрения, а формирует пакет для передачи человеку. Это важно, если вы ожидаете, что агент сам исправит код или запустит рискованные действия. Если в среде нет инструмента для субагентов, этапы выполняются в одном контексте, и проверка отчёта уже не независима.

Для запуска нужны описание проблемы и материалы для расследования. Можно добавить сведения о среде, способ воспроизведения и источник сообщения. Результат завершается одним из статусов `ready`, `blocked`, `needs-validation` или `escalated`; при ранней остановке используются `needs-input` либо `error`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill diagnosing-root-causes -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/diagnosing-root-causes/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/diagnosing-root-causes/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill diagnosing-root-causes -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/diagnosing-root-causes/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill diagnosing-root-causes -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/diagnosing-root-causes/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install b-mendoza/agent-skills skills/diagnosing-root-causes
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/diagnosing-root-causes/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill diagnosing-root-causes -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/b-mendoza/agent-skills --path skills/diagnosing-root-causes
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/diagnosing-root-causes/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill diagnosing-root-causes -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/b-mendoza/agent-skills/tree/HEAD/skills/diagnosing-root-causes/SKILL.md

## Когда брать
- найти причину сбоя приложения по логам
- разобрать регрессию после изменения кода
- выяснить, почему падает конвейер CI/CD
- проверить, хватает ли данных в сообщении об ошибке
- подготовить проверяемый отчёт о первопричине

## Примеры запросов агенту
- Разбери сбой приложения по логам `logs/build-42.txt` и укажи, какие выводы подтверждены.
- Найди причину ошибки конвейера CI/CD после обновления зависимости; используй переданные логи и диапазон коммитов.
- Проверь сообщение об ошибке и запроси недостающие сведения, если для анализа их не хватает.

## Похожие
- [principle-fix-root-causes](https://affpapa.org/nevibecode/skills/principle-fix-root-causes.md) — скилл · 10800 установок
- [root-cause-analysis](https://affpapa.org/nevibecode/skills/markpitt-root-cause-analysis.md) — скилл · 107 установок
- [root-cause-analyst](https://affpapa.org/nevibecode/agents/root-cause-analyst.md) — субагент · ★ 23950 у репозитория
- [022-root-cause-analysis](https://affpapa.org/nevibecode/skills/022-root-cause-analysis.md) — скилл · 144 установки
- [why](https://affpapa.org/nevibecode/skills/neolabhq-why.md) — скилл · 1300 установок
- [rca-debugger](https://affpapa.org/nevibecode/agents/rca-debugger.md) — субагент · ★ 880 у репозитория

Из того же набора: [b-mendoza/agent-skills](https://affpapa.org/nevibecode/by/b-mendoza/agent-skills.md) — 12 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
