AIKraft/Skills/systematic-debugging

systematic-debugging

Систематическое отладка кода по 4 этапам: сначала анализ причины, затем исправление. Полезно для глубокого понимания ошибок перед их устранением.

NONous Research official Разработка ★ 256.4k

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

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

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

  • Отладка упавших тестов или ошибок в production
  • Исправление неожиданных поведений и проблем с производительностью
  • Решение сложных багов, где простые исправления не работают
  • Анализ сбоев в многокомпонентных системах (API, базы данных, CI/CD)

Как работает

  1. Phase 1: Внимательно прочитать ошибки, создать «плотный цикл обратной связи» (tight feedback loop) для воспроизведения симптома, проверить последние изменения (git diff/log) и собрать доказательства.
  2. Phase 2: Минимизировать сценарий воспроизведения, найти работающие примеры в кодовой базе, сравнить их с неработающим кодом и выявить различия.
  3. Phase 3: Сформировать ранжированные гипотезы, проверить их минимальными изменениями (по одной переменной), используя отладчик или логи с уникальными префиксами.
  4. Phase 4: Создать падающий тест-кейс, внедрить одно исправление корневой причины, проверить его и запустить полный набор тестов; при 3+ неудачах пересмотреть архитектуру.

Примеры запросов агенту

Исправь ошибку в модуле auth, следуя процессу systematic-debugging.
Проведи систематическую отладку падения интеграционного теста test_user_flow.
Разберись, почему сервис возвращает 500 ошибку, используя 4 этапа отладки.

Что понадобится

  • Инструменты: read_file, search_files, terminal (для запуска тестов и команд git)
  • Доступ к кодовой базе и возможность запуска тестов/скриптов воспроизведения
  • Инструменты контроля версий (git) для анализа изменений

Описание составлено по SKILL.md навыка, сверено 24.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «nousresearch-systematic-debugging» из репозитория: # https://github.com/nousresearch/hermes-agent
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r nousresearch-systematic-debugging/ ~/.claude/skills/nousresearch-systematic-debugging/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.