# smart-debug

Слэш-команда разбирает сообщения об ошибках и стек-трейсы, строит гипотезы о причине сбоя и предлагает исправление. Пригодится, когда баг воспроизводится не всегда.

- команда · `type=command` · Claude Code, Codex, Cursor · ★ 41729
- Автор: Seth Hobson
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/wshobson/agents/tree/HEAD/plugins/debugging-toolkit/commands/smart-debug.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/commands/smart-debug

## Что делает

Команда принимает текст с описанием проблемы: сообщение об ошибке, шаги воспроизведения, затронутые сервисы, окружение. Дальше она прогоняет анализ через субагента `debugging-toolkit-debugger` и выдаёт несколько ранжированных гипотез с оценкой вероятности и способом проверки.

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

На выходе — структурированный отчёт: суть проблемы, корневая причина с доказательствами, патч с оценкой риска, план проверки и шаги профилактики. В примере из документации разбор таймаутов оплаты свёлся к N+1-запросу: 15 последовательных обращений к базе заменили одним пакетным. Учтите, что для сбора данных наблюдаемости нужен доступ к соответствующим платформам — без него останется только анализ кода и гипотезы.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add wshobson/agents
```
В чате агента (не в терминале):
```text
/plugin install debugging-toolkit@claude-code-workflows
```

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

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/smart-debug.md` — Вызов — /prompts:smart-debug. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

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

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/smart-debug.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wshobson/agents/tree/HEAD/plugins/debugging-toolkit/commands/smart-debug.md

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

## Примеры запросов агенту
- разбери ошибку: `Payment processing timeout`, 5% заказов, продакшен
- вот стек-трейс, найди корневую причину и предложи патч
- собери трейсы по сервису checkout за последний час и построй гипотезы

## Похожие
- [agents-debug](https://affpapa.org/nevibecode/skills/agents-debug.md) — скилл · 2000 установок
- [insforge-debug](https://affpapa.org/nevibecode/skills/insforge-debug.md) — скилл · 56700 установок
- [sentry-fix-stack-traces](https://affpapa.org/nevibecode/skills/sentry-fix-stack-traces.md) — скилл · 1500 установок
- [monitoring-terminal-errors](https://affpapa.org/nevibecode/skills/monitoring-terminal-errors.md) — скилл · 449 установок
- [sentry-debug-issue](https://affpapa.org/nevibecode/skills/sentry-debug-issue.md) — скилл · 1900 установок
- [gitops-cluster-debug](https://affpapa.org/nevibecode/skills/gitops-cluster-debug.md) — скилл · 1100 установок

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

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

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