# systematic-debugging

Скилл ведёт агента от воспроизведения ошибки до проверки исправления. Пригодится, когда причина сбоя или неожиданного поведения неясна.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 382 установки · ★ 78
- Автор: bobmatnyc
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/bobmatnyc/claude-mpm-skills/tree/HEAD/universal/debugging/systematic-debugging/SKILL.md
- Обновлён: 2026-07-18
- HTML: https://affpapa.org/nevibecode/skills/bobmatnyc-systematic-debugging

## Что делает

Работа идёт по пяти этапам: воспроизвести ошибку, локализовать сбой, найти причину, исправить её и проверить результат. Сначала агент собирает точные сообщения, логи и шаги воспроизведения; затем сужает поиск до компонента и прослеживает путь данных до источника проблемы.

Для поиска места сбоя скилл предлагает бинарный поиск, проверку изменений через `git log --oneline -20` и `git diff`, а также точечное логирование или отладчик. После исправления нужно повторить сценарий, запустить весь набор тестов и проверить связанные граничные случаи. Исправление до локализации здесь прямо считается ошибкой — скилл требует пройти этапы по порядку.

В комплекте есть материалы о рабочем процессе, примеры отладки, разбор типичных проблем и список анти-паттернов. Установить можно в Claude Code командой `npx skills add bobmatnyc/claude-mpm-skills --skill systematic-debugging -a claude-code`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bobmatnyc/claude-mpm-skills --skill systematic-debugging -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bobmatnyc/claude-mpm-skills --skill systematic-debugging -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bobmatnyc/claude-mpm-skills --skill systematic-debugging -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install bobmatnyc/claude-mpm-skills systematic-debugging
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add bobmatnyc/claude-mpm-skills --skill systematic-debugging -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/bobmatnyc/claude-mpm-skills --path universal/debugging/systematic-debugging
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add bobmatnyc/claude-mpm-skills --skill systematic-debugging -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/bobmatnyc/claude-mpm-skills/tree/HEAD/universal/debugging/systematic-debugging/SKILL.md

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

## Примеры запросов агенту
- Разбери эту ошибку: сначала найди способ стабильно её воспроизвести, потом локализуй причину.
- Проверь, какой коммит привнёс сбой, и проследи путь данных до проблемного значения.
- Исправь корневую причину этого падения и проверь сценарий воспроизведения вместе с тестами.

## Похожие
- [debugging-and-error-recovery](https://affpapa.org/nevibecode/skills/debugging-and-error-recovery.md) — скилл · 62800 установок
- [gitnexus-debugging](https://affpapa.org/nevibecode/skills/gitnexus-debugging.md) — скилл · 1700 установок
- [debugging](https://affpapa.org/nevibecode/skills/mrgoonie-debugging.md) — скилл · 569 установок
- [regression-triage](https://affpapa.org/nevibecode/commands/regression-triage.md) — команда · 25 установок
- [debugging-wizard](https://affpapa.org/nevibecode/skills/debugging-wizard.md) — скилл · 5100 установок
- [fix-sentry-issues](https://affpapa.org/nevibecode/skills/fix-sentry-issues.md) — скилл · 2700 установок

## Другие версии с тем же именем
- [systematic-debugging · obra](https://affpapa.org/nevibecode/skills/systematic-debugging.md) — 306118 установок
- [systematic-debugging · nousresearch](https://affpapa.org/nevibecode/skills/hermes-agent-adapted-from-obra-systematic-debugging.md) — 471 установка
- [systematic-debugging · spencerpauly](https://affpapa.org/nevibecode/skills/spencerpauly-systematic-debugging.md) — 545 установок
- [systematic-debugging · ganyuanran](https://affpapa.org/nevibecode/skills/ganyuanran-systematic-debugging.md) — ★ 1388
- [systematic-debugging · autohandai](https://affpapa.org/nevibecode/skills/autohandai-systematic-debugging.md) — ★ 211

Из того же набора: [bobmatnyc/claude-mpm-skills](https://affpapa.org/nevibecode/by/bobmatnyc/claude-mpm-skills.md) — 125 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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