systematic-debugging
Используйте при возникновении багов, падении тестов или неожиданном поведении, прежде чем предлагать исправления. Помогает системно анализировать проблемы.
AIsickn33
official
Разработка
★ 47.3k
Что делает навык
Навык обеспечивает системный подход к отладке, запрещая попытки исправления до полного выявления первопричины. Он помогает избежать хаотичных патчей и повторных ошибок, разделяя временные меры по сдерживанию инцидентов и окончательное устранение корневой причины.
Когда применять
- Падение тестов или сбои в продакшене
- Неожиданное поведение системы или проблемы с производительностью
- Сбои сборки (build failures) или интеграционные проблемы
- Ситуации, когда кажется очевидным «быстрый фикс» или есть давление по времени
Как работает
- Фаза 1: Проведите расследование первопричины — внимательно прочитайте ошибки, воспроизведите проблему, проверьте недавние изменения и соберите доказательства (включая диагностическую инструментацию для многокомпонентных систем).
- Фаза 2: Проанализируйте паттерны — найдите работающие примеры в кодовой базе, сравните их с неработающими, выявите различия и изучите зависимости.
- Фаза 3: Сформулируйте единственную гипотезу и протестируйте её минимальным изменением, проверяя результат перед продолжением.
- Фаза 4: Реализуйте исправление, создав сначала падающий тест, внедрив одно изменение и убедившись, что проблема решена и другие тесты не сломаны.
- Если 3 или более попыток исправления не увенчались успехом, остановитесь и пересмотрите архитектуру, а не пытайтесь применять четвёртое исправление.
Примеры запросов агенту
Тест падает с ошибкой, но я не понимаю причину. Проведи системную отладку: сначала найди корневую причину, а потом предлагай исправление.
В продакшене возникло неожиданное поведение. Используй навык systematic-debugging, чтобы проанализировать проблему, не прибегая к хаотичным фиксам.
Сборка в CI падает, хотя локально всё работает. Примени системный подход: проверь различия в окружении, собери доказательства и найди корневую причину.
Что понадобится
- Доступ к воспроизводимой команде или наблюдаемому сбою
- Доступ к истории изменений (git diff, коммиты) и тестовой среде
- Возможность добавления диагностической инструментации для сбора доказательств
Описание составлено по SKILL.md навыка, сверено 08.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «sickn33-systematic-debugging» из репозитория:
# https://github.com/sickn33/agentic-awesome-skills
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r sickn33-systematic-debugging/ ~/.claude/skills/sickn33-systematic-debugging/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.