# debug-systematic

Скилл debug-systematic для Claude Code ведёт агента через четыре фазы отладки: воспроизведение, локализацию, поиск причины и проверку исправления. Разбирает сложные и плавающие ошибки.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 152 установки · ★ 114 у репозитория
- Автор: travisjneuman
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/travisjneuman/.claude/tree/HEAD/skills/debug-systematic/SKILL.md
- Обновлён: 2026-11-10
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/debug-systematic

## Что делает

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

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

Тест, фиксирующий сбой, добавляется только по просьбе пользователя. При регрессиях можно применять команды `git bisect start`, `git bisect bad HEAD` и `git bisect good <known-good-commit>`.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install travisjneuman/.claude skills/debug-systematic
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add travisjneuman/.claude --skill debug-systematic -a opencode
```

### Claude.ai

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

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

## Когда брать
- воспроизвести плавающий сбой
- локализовать регрессию в истории Git
- отделить ошибку окружения от ошибки кода
- найти причину race condition
- проверить исправление и защититься от повторения

## Примеры запросов агенту
- Разбери этот сбой по четырём фазам: сначала зафиксируй воспроизведение, затем локализуй причину.
- Проверь регрессию через `git bisect`, начиная с `HEAD` и известного рабочего коммита.
- Найди корневую причину ошибки, предложи минимальное исправление и проверь побочные эффекты.

## Похожие
- [systematic-debugging](https://affpapa.org/nevibecode/skills/bobmatnyc-systematic-debugging.md) — скилл · 400 установок
- [ce-debug](https://affpapa.org/nevibecode/skills/ce-debug.md) — скилл · 3700 установок
- [debug](https://affpapa.org/nevibecode/skills/alexj11324-debug.md) — скилл · ★ 88 у репозитория
- [debug-session](https://affpapa.org/nevibecode/plugins/debug-session.md) — плагин · ★ 2858 у репозитория
- [gjalla-debug](https://affpapa.org/nevibecode/skills/gjalla-debug.md) — скилл · 357 установок
- [debug-mantra](https://affpapa.org/nevibecode/skills/debug-mantra.md) — скилл · 5100 установок

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

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

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