debugging-wizard - Debugging Wizard, поиск причины ошибок

Когда звать

• Когда агент чинит ошибку «наугад», меняет сразу несколько мест, и после его правок баг то уходит, то возвращается.
• Когда есть трассировка или лог падения и нужно найти причину, а не заткнуть симптом.

Что это

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

Debugging Wizard заставляет работать по методу. В SKILL.md пять шагов: воспроизвести, сузить до минимального случая, проверить гипотезы по одной, исправить и проверить, поставить защиту от повторения. Скилл подходит под любой язык и стек, а инструменты для конкретных языков вынесены в справочные файлы.

Правила, которые он вводит

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

Запрещено: гадать без проверки, делать несколько правок одновременно, пропускать воспроизведение, считать, что причина уже известна, отлаживать на рабочей системе без защитных мер и оставлять console.log и debugger в коде.

В конце агент отдаёт четыре части: корневую причину, доказательство (трассировка, лог или тест), правку и профилактику. Для разбора чужих отчётов об ошибках это хороший шаблон.

Что внутри

В тексте скилла примеры команд для четырёх сценариев: отладчик Python, Node.js с Chrome DevTools, поиск коммита с поломкой через git bisect и отладчик Go. Подробности по языкам лежат в справочных файлах: инструменты, частые паттерны багов, стратегии (в том числе поиск коммита и «путешествия во времени»), быстрые исправления частых ошибок и систематическая отладка для сложных случаев.

Как поставить

Из README и QUICKSTART автора.

В Claude Code (ставится весь набор из 67 скиллов):

/plugin marketplace add jeffallan/claude-skills
/plugin install fullstack-dev-skills@fullstack-dev-skills

В Codex отдельной инструкции у автора нет. Универсальная установка только скиллов через skills.sh описана так, и мы её для Codex не запускали:

npx skills add jeffallan/claude-skills

Чтобы взять только этот скилл, скопируй вручную папку skills/debugging-wizard в каталог скиллов своего агента. Как это сделать в Claude Code - в статье как установить скилл.

Проверка: дай агенту код с понятной ошибкой и фразу «найди причину». Он должен начать с воспроизведения и перечислить гипотезы, и только потом править.

Что учесть

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

Команды отладки из скилла выполняются на твоём компьютере с правами твоего пользователя. git bisect переключает файлы на разные коммиты. Работай в чистой ветке без несохранённых изменений.

Мы прочитали SKILL.md целиком, посмотрели список справочных файлов и проверили версию и лицензию на 22 октября 2026 года. Скилл здесь не запускали. Если хочешь дисциплину отладки как часть большого набора методов, посмотри Superpowers: оттуда автор заимствовал одну из частей.