Systematic Debugging: скилл Superpowers для поиска корневой причины бага

obra/superpowers· Проверено 13.11.2026· 317 тыс.на GitHub

Скилл Superpowers для отладки: агент ищет корневую причину бага в 4 фазы и не предлагает исправлений, пока не понял, откуда взялась ошибка.

Как установить Systematic Debugging

Личные скиллы лежат в ~/.claude/skills/, проектные — в .claude/skills/ репозитория. Проверка: команда /skills в сессии, вызов по имени — /systematic-debugging.

# плагином, внутри Claude Code
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# или вручную
git clone --depth 1 https://github.com/obra/superpowers.git /tmp/systematic-debugging
mkdir -p ~/.claude/skills/systematic-debugging
cp -r /tmp/systematic-debugging/skills/systematic-debugging/. ~/.claude/skills/systematic-debugging/

Общая папка ~/.agents/skills/ (в проекте — .agents/skills/) читают Codex, Cursor, VS Code Copilot, Gemini CLI, Antigravity, OpenCode, Kilo Code, Goose, Qwen Code.

git clone --depth 1 https://github.com/obra/superpowers.git /tmp/systematic-debugging
mkdir -p ~/.agents/skills/systematic-debugging
cp -r /tmp/systematic-debugging/skills/systematic-debugging/. ~/.agents/skills/systematic-debugging/

Установщик скиллов от Vercel, нужен Node.js 22.20 или новее. Без -g скилл ставится в текущий проект; флаг -a выбирает агента.

npx skills add obra/superpowers --skill systematic-debugging -a claude-code

# для всех проектов
npx skills add obra/superpowers --skill systematic-debugging -g

Нужен тариф Pro, Max, Team или Enterprise с включённым выполнением кода.

Скачайте папку скилла с GitHub и упакуйте её в ZIP.
claude.ai → Customize → Skills → + → Create skill → Upload a skill
Загрузите ZIP и включите скилл переключателем.

Gemini CLI ставит скиллы из git-репозитория и хранит их в ~/.gemini/skills/.

gemini skills install https://github.com/obra/superpowers.git --consent

# проверка
gemini skills list

Что умеет

Прочитать ошибку и стек целиком, воспроизвести баг и проверить последние изменения

Расставить диагностику на границах компонентов (CI → сборка → подпись) и найти слой, где всё ломается

Сравнить сломанный код с работающим примером и выписать все различия

Проверять по одной гипотезе с минимальной правкой

Остановиться после трёх неудачных исправлений и поставить вопрос об архитектуре

Фазы: поиск корневой причины, анализ закономерностей, гипотеза и проверка, исправление. К следующей фазе агент переходит, только закончив предыдущую.

Перед исправлением агент пишет падающий тест по скиллу test-driven-development, после — подтверждает результат по verification-before-completion.

Рядом лежат техники: root-cause-tracing.md (обратная трассировка по стеку), defense-in-depth.md (проверки на нескольких слоях), condition-based-waiting.md (ожидание условия вместо таймаутов).

Что нужно

АгентыСтавится вместе с набором Superpowers в Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot CLI, OpenCode, Qwen Code и другие агенты.

Что попросить агента

Тест <имя теста> падает, разберисьПрочитает ошибку, воспроизведёт падение, найдёт причину и только потом предложит правку с тестом

В CI подпись приложения ломается, локально всё работаетДобавит диагностический вывод на каждом слое конвейера и найдёт, где теряется секрет или настройка

Я уже трижды чинил <баг>, не выходитОстановится и предложит обсудить, верна ли сама архитектура, до четвёртой попытки

Ограничения

Пока первая фаза не пройдена, агент не предлагает исправлений, даже когда горят сроки

После трёх неудачных исправлений агент останавливается и обсуждает архитектуру с вами

Описание из SKILL.md

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

Частые вопросы

Как установить systematic-debugging skill в Claude Code?

Поставьте набор Superpowers: /plugin install superpowers@claude-plugins-official или через маркетплейс автора obra/superpowers-marketplace. Скилл systematic-debugging включится сам, когда задача подойдёт.

Когда срабатывает systematic debugging?

На любой баг, упавший тест, сбой сборки, проблему производительности или странное поведение — до того, как агент предложит исправление.

Что если корневой причины нет?

Если проблема в окружении, таймингах или внешней системе, агент описывает, что проверил, добавляет обработку (повтор, таймаут, сообщение об ошибке) и логирование. Авторы предупреждают: в 95% таких случаев расследование не закончено.

Зачем процесс для простых багов?

У простых багов тоже есть корневая причина, а на них процесс проходит быстро. Скилл прямо велит не пропускать его, когда баг кажется простым или горят сроки.

По каким вашим фразам агент поймёт, что идёт не туда?

«Хватит гадать», «Мы застряли?», «Это разве не происходит?» — после таких реплик скилл велит вернуться к первой фазе.