# systematic-debugging

Заставляет ИИ-агента искать причину бага по шагам вместо случайных правок кода. Пригодится, когда поломку трудно поймать или она проявляется только в продакшене.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 545 установок · ★ 866
- Автор: spencerpauly
- Лицензия: CC0-1.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/spencerpauly/awesome-cursor-skills/tree/HEAD/resources/systematic-debugging/SKILL.md
- Обновлён: 2026-08-02
- HTML: https://affpapa.org/nevibecode/skills/spencerpauly-systematic-debugging

## Что делает

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

После изоляции формулируется проверяемая гипотеза. Вместо хаотичных правок агент добавляет точечный лог или точку останова, чтобы подтвердить догадку фактами. Финал — минимальный фикс и регрессионный тест. В скилл вшито строгое правило: если за 15 минут прогресса нет, нужно остановиться и локализовать проблему заново.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add spencerpauly/awesome-cursor-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 spencerpauly/awesome-cursor-skills --skill systematic-debugging -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add spencerpauly/awesome-cursor-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 spencerpauly/awesome-cursor-skills systematic-debugging
```

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

### Gemini CLI

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

2. **Командой платформы**
```bash
gemini skills install https://github.com/spencerpauly/awesome-cursor-skills --path resources/systematic-debugging
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add spencerpauly/awesome-cursor-skills --skill systematic-debugging -a opencode
```

### Claude.ai

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

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

## Когда брать
- локализовать регрессию в истории коммитов с помощью `git bisect`
- сформулировать и проверить точечную гипотезу о сбое перед изменением кода
- изолировать плавающий дефект или состояние гонки
- воспроизвести ошибку окружения между локальной машиной и продакшеном

## Примеры запросов агенту
- Помоги найти причину ошибки через systematic-debugging: запрос падает при сохранении профиля.
- Примени systematic-debugging и выясни через git bisect, какой коммит сломал авторизацию.
- Используй методику systematic-debugging, чтобы локализовать баг с undefined в компоненте.

## Похожие
- [debugging](https://affpapa.org/nevibecode/skills/akillness-debugging.md) — скилл · 361 установка
- [hunt](https://affpapa.org/nevibecode/skills/hunt.md) — скилл · 14900 установок
- [debugging-wizard](https://affpapa.org/nevibecode/skills/debugging-wizard.md) — скилл · 5100 установок
- [bug-reproduction](https://affpapa.org/nevibecode/skills/bug-reproduction.md) — скилл · 1400 установок
- [debugging-and-error-recovery](https://affpapa.org/nevibecode/skills/debugging-and-error-recovery.md) — скилл · 62800 установок
- [debugging-network-issues](https://affpapa.org/nevibecode/skills/debugging-network-issues.md) — скилл · 675 установок

## Другие версии с тем же именем
- [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 · bobmatnyc](https://affpapa.org/nevibecode/skills/bobmatnyc-systematic-debugging.md) — 382 установки

Из того же набора: [spencerpauly/awesome-cursor-skills](https://affpapa.org/nevibecode/by/spencerpauly/awesome-cursor-skills.md) — 60 карточек

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

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