# debugging

Регламент поиска первопричин багов и сбоев тестов для ассистента. Заставляет агента проверять факты и воспроизводить ошибку до внесения правок в код.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 844 установки · ★ 6
- Автор: sentimony
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/sentimony/skills/tree/HEAD/plugins/devflow/skills/debugging/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/sentimony-debugging

## Что делает

Скилл вводит протокол расследования технических сбоев, регрессий и нестабильных тестов. Главное правило методики — никаких исправлений без подтверждённой первопричины (`NO FIX WITHOUT SUFFICIENT ROOT-CAUSE EVIDENCE`). Ассистент обязан сформулировать фальсифицируемую гипотезу, провести разделяющий тест и подтвердить механизм ошибки фактами, а не гадать по последнему коммиту.

Процесс разбит на шаги. Сначала фиксируется контекст репозитория и контракт симптома с происхождением дефекта (`PRE-EXISTING`, `INTRODUCED` или `UNKNOWN`). Далее поведение классифицируется по воспроизводимости, собираются логи и трассировки, после чего локализуются межкомпонентные границы. Для фиксации промежуточных выводов используются метки `OBSERVED`, `HYPOTHESIS` и `ROOT CAUSE`.

Этот скилл отвечает только за объяснение причин поломки. Он не пишет архитектурные планы, не настраивает окружение и не автоматизирует браузер. Срочные временные решения методика обязывает помечать как `MITIGATION` или `WORKAROUND`, сохраняя требование докопаться до корня проблемы.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

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

## Примеры запросов агенту
- Разбери сбой теста аутентификации по методике debugging и найди корень проблемы.
- Локализуй ошибку 500 в API, проверь гипотезы и не меняй код без прямых подтверждений.
- Исследуй плавающий сбой сборки и классифицируй условия его повторения.

## Похожие
- [improve-codebase-architecture](https://affpapa.org/nevibecode/skills/improve-codebase-architecture.md) — скилл · 1163035 установок
- [design-taste-frontend](https://affpapa.org/nevibecode/skills/design-taste-frontend.md) — скилл · 678700 установок
- [tdd](https://affpapa.org/nevibecode/skills/tdd.md) — скилл · 1141062 установки
- [skill-creator](https://affpapa.org/nevibecode/skills/skill-creator.md) — скилл · 414180 установок
- [agent-browser](https://affpapa.org/nevibecode/skills/vercel-labs-agent-browser.md) — скилл · 1200000 установок
- [prototype](https://affpapa.org/nevibecode/skills/prototype.md) — скилл · 986201 установка

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

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

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

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