debugging · akillness — скилл для Claude Code: разбор багов по шагам

Что делает debugging

Скилл задаёт агенту рамку из восьми шагов. Сначала фиксируется определение сбоя: ожидаемое поведение, фактическое, триггер, окружение и уверенность. Потом выбирается самый дешёвый источник доказательств — прямой прогон падающей команды, сравнение изменений при регрессии, повторные запуски для плавающего теста, сравнение конфигов для сбоев только в CI или на стенде.

Дальше агент строит минимальный воспроизводимый пример и сужает границу: UI против API, база, воркер, конфиг, зависимость. На каждую гипотезу — одна проверка, а не пять правок сразу. Внутри есть справочники: references/debug-loop.md с полным каркасом эксперимента, references/mode-selection-and-fast-checks.md с наборами под регрессию, флейки, расхождение окружений и разбор артефактов, references/handoff-boundaries.md — чтобы не тащить в скилл чужую работу.

Инструменты ограничены: Read, Grep, Glob, Bash, Write. Скилл не берётся за разбор сырых логов без суженного симптома, за проектирование тестовой политики, ревью PR и тюнинг производительности — для этого он отправляет к другим скиллам. Если воспроизвести или изолировать не удалось, агент обязан сказать, что уверенность низкая, и запросить один недостающий артефакт вместо догадок.