AIKraft/Skills/systematic-debugging

systematic-debugging

Используйте при возникновении багов, падении тестов или неожиданном поведении, прежде чем предлагать исправления. Помогает системно анализировать проблемы.

sickn33 official Разработка ★ 47.3k

Что делает навык

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

Когда применять

  • Падение тестов или сбои в продакшене
  • Неожиданное поведение системы или проблемы с производительностью
  • Сбои сборки (build failures) или интеграционные проблемы
  • Ситуации, когда кажется очевидным «быстрый фикс» или есть давление по времени

Как работает

  1. Фаза 1: Проведите расследование первопричины — внимательно прочитайте ошибки, воспроизведите проблему, проверьте недавние изменения и соберите доказательства (включая диагностическую инструментацию для многокомпонентных систем).
  2. Фаза 2: Проанализируйте паттерны — найдите работающие примеры в кодовой базе, сравните их с неработающими, выявите различия и изучите зависимости.
  3. Фаза 3: Сформулируйте единственную гипотезу и протестируйте её минимальным изменением, проверяя результат перед продолжением.
  4. Фаза 4: Реализуйте исправление, создав сначала падающий тест, внедрив одно изменение и убедившись, что проблема решена и другие тесты не сломаны.
  5. Если 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 и совместимые) подхватывает его по описанию и следует шагам.