alekseiul/systematic-debugging
skills/systematic-debugging/SKILL.md
Систематическая отладка при любых багах, ошибках, неожиданном поведении. Используй ПЕРЕД предложением фиксов. Триггеры: 'не работает', 'баг', 'ошибка', 'сломалось', 'debug', 'почему не', 'странное поведение', 'крон не запустился', 'скрипт падает'.
$ install --global
skillsauthnpx skillsauth add alekseiul/sprut-agent-kit systematic-debuggingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 1, 2026, 10:49 PM53.3s1 file scanned
SKILL.md
- name:
- systematic-debugging
- description:
- Систематическая отладка при любых багах, ошибках, неожиданном поведении. Используй ПЕРЕД предложением фиксов. Триггеры: 'не работает', 'баг', 'ошибка', 'сломалось', 'debug', 'почему не', 'странное поведение', 'крон не запустился', 'скрипт падает'.
Систематическая отладка
Железное правило
НИКАКИХ ФИКСОВ БЕЗ ПОНИМАНИЯ ПРИЧИНЫ
Рандомные фиксы тратят время и создают новые баги. Если не прошёл Фазу 1 - нельзя предлагать решения.
Когда использовать
Любая техническая проблема:
- Крон не запустился / выдал ошибку
- Скрипт падает
- Gateway не отвечает
- Docker контейнер упал
- Память не ищет нужное
- Бот не отправляет сообщения
- Любое "раньше работало, теперь нет"
Особенно когда: под давлением, "очевидный фикс" напрашивается, уже пробовал 2+ решения.
Четыре фазы
Фаза 1: Расследование причины
ПЕРЕД любым фиксом:
-
Прочитай ошибку целиком
- Не пропускай стектрейсы и warnings
- Часто ответ прямо в тексте ошибки
- Запиши: файл, строка, код ошибки
-
Воспроизведи
- Можешь повторить проблему?
- Какие точные шаги?
- Если не воспроизводится - собирай больше данных, не гадай
-
Что изменилось?
git diff, последние коммиты- Обновление платформы? (проверь версию)
- Новые зависимости, конфиг?
memory/progress-log.md- что делалось недавно
-
Проследи поток данных Для многокомпонентных систем (крон → gateway → агент → tool → результат):
На каждом стыке: - Что входит? - Что выходит? - Где ломается?
Фаза 2: Анализ паттерна
- Найди рабочий пример - похожий скрипт/крон который работает
- Сравни - что отличается между рабочим и сломанным?
- Проверь зависимости - всё ли на месте (docker, npm, пути, права)?
Фаза 3: Гипотеза и тест
- Сформулируй гипотезу - "Я думаю причина в X потому что Y"
- Минимальный тест - ОДНО изменение, ОДНА переменная
- Проверь - сработало → Фаза 4. Нет → новая гипотеза
- НЕ лепи фиксы поверх - если не сработало, откати и думай заново
Фаза 4: Реализация фикса
- Фикси причину, не симптом
- Одно изменение за раз
- Проверь - проблема ушла? Ничего другого не сломалось?
- Запиши -
bash scripts/progress-log.sh+ daily notes если важное - Если 3+ фикса не сработали - СТОП. Проблема архитектурная. Обсуди с Алексеем.
Красные флаги - ОСТАНОВИСЬ
Если ловишь себя на мысли:
- "Быстрый фикс, потом разберусь"
- "Попробую поменять X, вдруг поможет"
- "Добавлю несколько изменений сразу"
- "Не совсем понимаю, но может сработает"
- "Ещё один фикс..." (когда уже 2+ не сработали)
→ СТОП. Вернись к Фазе 1.
Наши типичные проблемы и где искать
| Проблема | Первым делом проверь |
|----------|---------------------|
| Крон не запустился | Проверь cron list → consecutiveErrors, lastStatus |
| Gateway не отвечает | Проверь gateway status, порт |
| Скрипт не найден | Путь, chmod +x, shebang |
| Docker упал | docker ps -a, docker logs <name> |
| Память не ищет | sqlite3 <path>/memory.sqlite "SELECT count(*) FROM chunks;" |
| Бот молчит | message tool → проверь to, channel |
| После обновления | Проверь health-check, перезапусти сервисы |
Related Skills
alekseiul/presentation
content-media
VerifiedTrustedCommunity
Create presentations from text/outline using Marp (Markdown to slides). Use when user asks to create presentation, slides, pitch deck. Triggers on "презентация", "слайды", "presentation", "pitch deck", "сделай презентацию".
62SKILL.mdUpdated Apr 1, 2026
alekseiul/youtube-seo
development
VerifiedTrustedCommunity
Generate YouTube titles, descriptions, timecodes and hashtags from video transcripts.
55SKILL.mdUpdated Apr 1, 2026
alekseiul/writing-plans
tools
VerifiedTrustedCommunity
Создание пошаговых планов реализации для любых задач - технических, контентных, организационных. Используй когда есть идея/спека и нужен детальный план действий. Триггеры: 'составь план', 'пошаговый план', 'plan', 'как реализовать', 'разбей на шаги', 'что нужно сделать'.
55SKILL.mdUpdated Apr 1, 2026
alekseiul/weather
development
VerifiedTrustedCommunity
Get current weather and forecasts (no API key required). Use when user asks about weather, temperature, forecast. Triggers on 'погода', 'weather', 'прогноз', 'температура', 'какая погода'.
55SKILL.mdUpdated Apr 1, 2026