# debugging

Систематизирует отладку кода: запрещает править наугад без поиска первопричины и требует проверять результат тестами перед закрытием задачи.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 569 установок · ★ 2228
- Автор: mrgoonie
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/mrgoonie/claudekit-skills/tree/HEAD/.claude/skills/debugging/SKILL.md
- Обновлён: 2026-04-03
- HTML: https://affpapa.org/nevibecode/skills/mrgoonie-debugging

## Что делает

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

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

Такая методология прямо исключает маскировку симптомов костылями. По данным автора, структурированный разбор даёт 95% успешных исправлений с первой попытки против 40% при случайном подборе вариантов.

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mrgoonie/claudekit-skills --skill debugging -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add mrgoonie/claudekit-skills --skill debugging -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install mrgoonie/claudekit-skills debugging
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add mrgoonie/claudekit-skills --skill debugging -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- Найди первопричину ошибки по этому стектрейсу через root-cause-tracing
- Используй systematic-debugging, чтобы локализовать сбой в тестах корзины
- Проверь фикс через verification-before-completion перед закрытием задачи

## Похожие
- [systematic-debugging](https://affpapa.org/nevibecode/skills/spencerpauly-systematic-debugging.md) — скилл · 545 установок
- [debugging-and-error-recovery](https://affpapa.org/nevibecode/skills/debugging-and-error-recovery.md) — скилл · 62800 установок
- [debugger](https://affpapa.org/nevibecode/agents/debugger.md) — субагент · 13459 установок
- [debugging-network-issues](https://affpapa.org/nevibecode/skills/debugging-network-issues.md) — скилл · 675 установок
- [debugging-strategies](https://affpapa.org/nevibecode/skills/debugging-strategies.md) — скилл · 13414 установок
- [principle-prove-it-works](https://affpapa.org/nevibecode/skills/principle-prove-it-works.md) — скилл · 5200 установок

## Другие версии с тем же именем
- [debugging · tursodatabase](https://affpapa.org/nevibecode/skills/debugging.md) — 1300 установок
- [debugging · akillness](https://affpapa.org/nevibecode/skills/akillness-debugging.md) — 361 установка

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

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