Установка скиллов и плагинов OpenClaw осуществляется на ваш страх и риск. Все файлы были получены из открытых источников и предоставляются «как есть». Мы не гарантируем их корректную работу, безопасность или совместимость с вашей системой. Перед установкой настоятельно рекомендуется ознакомиться с содержимым кода и убедиться, что вы понимаете, какие изменения будут внесены в вашу систему.
Systematic Debugging
Случайные исправления тратят время и создают новые баги. Быстрые «заплатки» лишь маскируют настоящие проблемы.
Ключевой принцип: ВСЕГДА находи первопричину, прежде чем пытаться что-либо исправить. Исправление симптомов — это провал.
Нарушение этого процесса — это нарушение самой сути отладки.
Железное правило
НЕЛЬЗЯ вносить исправления без предварительного анализа первопричины.
НЕЛЬЗЯ начинать анализ без предварительного восстановления контекста.
Если ты не завершил этап 0 — нельзя переходить к этапу 1. Если не завершён этап 1 — нельзя предлагать решения.
Когда использовать
Используй этот подход при ЛЮБЫХ технических проблемах:
- падение тестов
- баги в продакшене
- неожиданное поведение
- проблемы с производительностью
- ошибки сборки
- проблемы интеграции
Особенно важно применять, когда:
- есть давление по срокам
- кажется, что «есть быстрый фикс»
- уже было несколько неудачных попыток
- предыдущие исправления не помогли
- ты не до конца понимаешь проблему
Не пропускай процесс, даже если:
- баг кажется простым
- нужно «срочно починить»
- кто-то требует быстрый результат
Системный подход быстрее, чем хаотичные попытки.
Пять фаз системной отладки
Ты ОБЯЗАН пройти каждую фазу последовательно.
Фаза 0: Восстановление контекста (обязательная)
Прежде чем делать что-либо:
- выдели ключевые слова из ошибки (тип, компонент, область кода)
- найди похожие случаи в документации, памяти, истории проекта
- проверь последние изменения (git, зависимости, конфиги)
Результат:
- если найдено решение — сразу к фазе 4
- если частично — используй как старт
- если ничего — переходи к фазе 1
Фаза 1: Поиск первопричины
- внимательно прочитай сообщения об ошибке
- воспроизведи проблему стабильно
- определи точные шаги возникновения
- проверь недавние изменения
- собери доказательства (логи, трассировки)
- проследи поток данных до источника проблемы
Цель — понять что происходит и почему.
Фаза 2: Анализ паттернов
- найди рабочие примеры в кодовой базе
- сравни их с проблемным кодом
- выяви ВСЕ различия
- проанализируй зависимости и окружение
Фаза 3: Гипотеза и тестирование
- сформулируй одну гипотезу: «причина X, потому что Y»
- внеси минимальное изменение
- меняй только одну переменную за раз
- проверь результат
Если не сработало — новая гипотеза.
Фаза 4: Реализация
- сначала создай тест, который падает
- внеси ОДНО исправление
- не делай дополнительных улучшений «заодно»
- убедись, что всё работает и тесты проходят
Если 3+ попытки неудачны — остановись и пересмотри архитектуру.
Красные флаги
Если ты ловишь себя на таких мыслях — СТОП:
- «сейчас быстро пофикшу, потом разберусь»
- «давай просто попробуем поменять X»
- предлагаешь решение без анализа данных
- «ещё одна попытка фикса» после нескольких неудач
Все эти сигналы означают: вернись к фазе 1.
Краткое резюме
Системная отладка — это дисциплина:
- сначала понимание, потом исправление
- никаких догадок без доказательств
- никаких множественных изменений сразу
- каждое действие — проверяемое
Следуя этому процессу, ты не только быстрее исправляешь баги, но и почти не создаёшь новых. :
Файл из источника