# debug

Скилл debug для Claude Code организует системную отладку ошибок и упавших тестов. Он удерживает агента от поспешных правок, пока не сформулирована и не проверена гипотеза.

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

## Что делает

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

Править логику разрешено только после того, как сбой вызван намеренно через лог, утверждение или воспроизводящий сценарий. Изменение обязано устранять причину, а не глушить внешнее проявление бага. Финальным шагом агент составляет тест, который предотвратит возврат ошибки в будущем.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alexj11324/Mikka .claude/skills/debug
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

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

## Примеры запросов агенту
- «Тест падает с ошибкой NullPointerException, помоги найти причину»
- «После вчерашнего релиза эндпоинт возвращает 500, разберись почему»
- «В корзине неверно считается итоговая сумма, найди баг»

## Похожие
- [ce-debug](https://affpapa.org/nevibecode/skills/ce-debug.md) — скилл · 3700 установок
- [debug-like-expert](https://affpapa.org/nevibecode/skills/debug-like-expert.md) — скилл · ★ 1988 у репозитория
- [debug-systematic](https://affpapa.org/nevibecode/skills/debug-systematic.md) — скилл · 152 установки
- [principle-attack-the-premise](https://affpapa.org/nevibecode/skills/principle-attack-the-premise.md) — скилл · 10100 установок
- [systematic-debugging](https://affpapa.org/nevibecode/skills/spencerpauly-systematic-debugging.md) — скилл · 604 установки
- [gjalla-debug](https://affpapa.org/nevibecode/skills/gjalla-debug.md) — скилл · 357 установок

## Другие версии с тем же именем
- [debug · anthropics](https://affpapa.org/nevibecode/skills/debug.md) — 6100 установок
- [debug · jsmastery-pro](https://affpapa.org/nevibecode/skills/jsmastery-pro-debug.md) — 5100 установок
- [debug · yeachan-heo](https://affpapa.org/nevibecode/skills/yeachan-heo-debug.md) — 705 установок
- [debug · cyrusagents](https://affpapa.org/nevibecode/skills/cyrusagents-debug.md) — 871 установка
- [debug · parcadei](https://affpapa.org/nevibecode/skills/parcadei-debug.md) — 511 установок

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

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