{"id":"9e9d890a-e48d-4824-ae60-19291a3a690f","shortId":"6UQRXR","kind":"skill","title":"systematic-debugging","tagline":"Систематическая отладка при любых багах, ошибках, неожиданном поведении. Используй ПЕРЕД предложением фиксов. Триггеры: 'не работает', 'баг', 'ошибка', 'сломалось', 'debug', 'почему не', 'странное поведение', 'крон не запустился', 'скрипт падает'.","description":"# Систематическая отладка\n\n## Железное правило\n\n```\nНИКАКИХ ФИКСОВ БЕЗ ПОНИМАНИЯ ПРИЧИНЫ\n```\n\nРандомные фиксы тратят время и создают новые баги. Если не прошёл Фазу 1 - нельзя предлагать решения.\n\n## Когда использовать\n\nЛюбая техническая проблема:\n- Крон не запустился / выдал ошибку\n- Скрипт падает\n- Gateway не отвечает\n- Docker контейнер упал\n- Память не ищет нужное\n- Бот не отправляет сообщения\n- Любое \"раньше работало, теперь нет\"\n\n**Особенно** когда: под давлением, \"очевидный фикс\" напрашивается, уже пробовал 2+ решения.\n\n## Четыре фазы\n\n### Фаза 1: Расследование причины\n\n**ПЕРЕД любым фиксом:**\n\n1. **Прочитай ошибку целиком**\n   - Не пропускай стектрейсы и warnings\n   - Часто ответ прямо в тексте ошибки\n   - Запиши: файл, строка, код ошибки\n\n2. **Воспроизведи**\n   - Можешь повторить проблему?\n   - Какие точные шаги?\n   - Если не воспроизводится - собирай больше данных, не гадай\n\n3. **Что изменилось?**\n   - `git diff`, последние коммиты\n   - Обновление платформы? (проверь версию)\n   - Новые зависимости, конфиг?\n   - `memory/progress-log.md` - что делалось недавно\n\n4. **Проследи поток данных**\n   Для многокомпонентных систем (крон → gateway → агент → tool → результат):\n   ```\n   На каждом стыке:\n   - Что входит?\n   - Что выходит?\n   - Где ломается?\n   ```\n\n### Фаза 2: Анализ паттерна\n\n1. **Найди рабочий пример** - похожий скрипт/крон который работает\n2. **Сравни** - что отличается между рабочим и сломанным?\n3. **Проверь зависимости** - всё ли на месте (docker, npm, пути, права)?\n\n### Фаза 3: Гипотеза и тест\n\n1. **Сформулируй гипотезу** - \"Я думаю причина в X потому что Y\"\n2. **Минимальный тест** - ОДНО изменение, ОДНА переменная\n3. **Проверь** - сработало → Фаза 4. Нет → новая гипотеза\n4. **НЕ лепи фиксы поверх** - если не сработало, откати и думай заново\n\n### Фаза 4: Реализация фикса\n\n1. **Фикси причину, не симптом**\n2. **Одно изменение за раз**\n3. **Проверь** - проблема ушла? Ничего другого не сломалось?\n4. **Запиши** - `bash scripts/progress-log.sh` + daily notes если важное\n5. **Если 3+ фикса не сработали** - СТОП. Проблема архитектурная. Обсуди с Алексеем.\n\n## Красные флаги - ОСТАНОВИСЬ\n\nЕсли ловишь себя на мысли:\n- \"Быстрый фикс, потом разберусь\"\n- \"Попробую поменять X, вдруг поможет\"\n- \"Добавлю несколько изменений сразу\"\n- \"Не совсем понимаю, но может сработает\"\n- \"Ещё один фикс...\" (когда уже 2+ не сработали)\n\n→ СТОП. Вернись к Фазе 1.\n\n## Наши типичные проблемы и где искать\n\n| Проблема | Первым делом проверь |\n|----------|---------------------|\n| Крон не запустился | Проверь cron list → consecutiveErrors, lastStatus |\n| Gateway не отвечает | Проверь gateway status, порт |\n| Скрипт не найден | Путь, chmod +x, shebang |\n| Docker упал | `docker ps -a`, `docker logs <name>` |\n| Память не ищет | `sqlite3 <path>/memory.sqlite \"SELECT count(*) FROM chunks;\"` |\n| Бот молчит | message tool → проверь to, channel |\n| После обновления | Проверь health-check, перезапусти сервисы |","tags":["systematic","debugging","sprut","agent","kit","alekseiul","agent-skills","ai-agents","ai-assistant","automation","claude-code","claudeclaw"],"capabilities":["skill","source-alekseiul","skill-systematic-debugging","topic-agent-skills","topic-ai-agents","topic-ai-assistant","topic-automation","topic-claude-code","topic-claudeclaw","topic-memory","topic-self-hosted","topic-starter-kit","topic-telegram-bot"],"categories":["sprut-agent-kit"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/AlekseiUL/sprut-agent-kit/systematic-debugging","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add AlekseiUL/sprut-agent-kit","source_repo":"https://github.com/AlekseiUL/sprut-agent-kit","install_from":"skills.sh"}},"qualityScore":"0.481","qualityRationale":"deterministic score 0.48 from registry signals: · indexed on github topic:agent-skills · 63 github stars · SKILL.md body (2,932 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:57:12.713Z","embedding":null,"createdAt":"2026-05-13T12:58:22.369Z","updatedAt":"2026-05-18T18:57:12.713Z","lastSeenAt":"2026-05-18T18:57:12.713Z","tsv":"'/memory.sqlite':383 '1':53,102,108,187,220,262,339 '2':97,128,184,196,231,267,332 '3':144,204,216,238,272,290 '4':162,242,246,259,280 '5':288 'bash':282 'channel':394 'check':400 'chmod':369 'chunk':387 'consecutiveerror':356 'count':385 'cron':354 'daili':284 'debug':3,22 'diff':148 'docker':72,211,372,374,377 'gateway':69,170,358,362 'git':147 'health':399 'health-check':398 'laststatus':357 'list':355 'log':378 'memory/progress-log.md':158 'messag':390 'note':285 'npm':212 'ps':375 'scripts/progress-log.sh':283 'select':384 'shebang':371 'skill' 'skill-systematic-debugging' 'source-alekseiul' 'sqlite3':382 'status':363 'systemat':2 'systematic-debug':1 'tool':172,391 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-assistant' 'topic-automation' 'topic-claude-code' 'topic-claudeclaw' 'topic-memory' 'topic-self-hosted' 'topic-starter-kit' 'topic-telegram-bot' 'warn':116 'x':227,314,370 'y':230 'агент':171 'алексеем':299 'анализ':185 'архитектурная':296 'баг':19 'багах':8 'баги':48 'без':38 'больше':140 'бот':79,388 'быстрый':308 'в':120,226 'важное':287 'вдруг':315 'вернись':336 'версию':154 'воспроизведи':129 'воспроизводится':138 'время':44 'всё':207 'входит':178 'выдал':65 'выходит':180 'гадай':143 'где':181,344 'гипотеза':217,245 'гипотезу':222 'давлением':91 'данных':141,165 'делалось':160 'делом':348 'для':166 'добавлю':317 'другого':277 'думай':256 'думаю':224 'если':49,136,251,286,289,303 'ещё':327 'железное':34 'за':270 'зависимости':156,206 'заново':257 'запиши':123,281 'запустился':29,64,352 'и':45,115,202,218,255,343 'изменение':235,269 'изменений':319 'изменилось':146 'искать':345 'использовать':58 'используй':12 'ищет':77,381 'к':337 'каждом':175 'какие':133 'когда':57,89,330 'код':126 'коммиты':150 'контейнер':73 'конфиг':157 'который':194 'красные':300 'крон':27,62,169,193,350 'лепи':248 'ли':208 'ловишь':304 'ломается':182 'любая':59 'любое':83 'любым':106 'любых':7 'между':200 'месте':210 'минимальный':232 'многокомпонентных':167 'может':325 'можешь':130 'молчит':389 'мысли':307 'на':174,209,306 'найден':367 'найди':188 'напрашивается':94 'наши':340 'не':17,24,28,50,63,70,76,80,112,137,142,247,252,265,278,292,321,333,351,359,366,380 'недавно':161 'нельзя':54 'неожиданном':10 'несколько':318 'нет':87,243 'никаких':36 'ничего':276 'но':324 'новая':244 'новые':47,155 'нужное':78 'обновление':151 'обновления':396 'обсуди':297 'один':328 'одна':236 'одно':234,268 'особенно':88 'остановись':302 'ответ':118 'отвечает':71,360 'откати':254 'отладка':5,33 'отличается':199 'отправляет':81 'очевидный':92 'ошибка':20 'ошибках':9 'ошибки':122,127 'ошибку':66,110 'падает':31,68 'память':75,379 'паттерна':186 'первым':347 'перед':13,105 'перезапусти':401 'переменная':237 'платформы':152 'поведение':26 'поведении':11 'поверх':250 'повторить':131 'под':90 'поменять':313 'поможет':316 'понимания':39 'понимаю':323 'попробую':312 'порт':364 'после':395 'последние':149 'поток':164 'потом':310 'потому':228 'похожий':191 'почему':23 'права':214 'правило':35 'предлагать':55 'предложением':14 'при':6 'пример':190 'причина':225 'причину':264 'причины':40,104 'проблема':61,274,295,346 'проблему':132 'проблемы':342 'пробовал':96 'проверь':153,205,239,273,349,353,361,392,397 'пропускай':113 'проследи':163 'прочитай':109 'прошёл':51 'прямо':119 'пути':213 'путь':368 'работает':18,195 'работало':85 'рабочий':189 'рабочим':201 'раз':271 'разберусь':311 'рандомные':41 'раньше':84 'расследование':103 'реализация':260 'результат':173 'решения':56,98 'с':298 'себя':305 'сервисы':402 'симптом':266 'систем':168 'систематическая':4,32 'скрипт':30,67,192,365 'сломалось':21,279 'сломанным':203 'собирай':139 'совсем':322 'создают':46 'сообщения':82 'сработает':326 'сработали':293,334 'сработало':240,253 'сравни':197 'сразу':320 'стектрейсы':114 'стоп':294,335 'странное':25 'строка':125 'стыке':176 'сформулируй':221 'тексте':121 'теперь':86 'тест':219,233 'техническая':60 'типичные':341 'точные':134 'тратят':43 'триггеры':16 'уже':95,331 'упал':74,373 'ушла':275 'фаза':101,183,215,241,258 'фазе':338 'фазу':52 'фазы':100 'файл':124 'фикс':93,309,329 'фикса':261,291 'фикси':263 'фиксов':15,37 'фиксом':107 'фиксы':42,249 'флаги':301 'целиком':111 'часто':117 'четыре':99 'что':145,159,177,179,198,229 'шаги':135 'я':223","prices":[{"id":"730fd9de-ae2e-471f-b456-ca6839d47b8a","listingId":"9e9d890a-e48d-4824-ae60-19291a3a690f","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"AlekseiUL","category":"sprut-agent-kit","install_from":"skills.sh"},"createdAt":"2026-05-13T12:58:22.369Z"}],"sources":[{"listingId":"9e9d890a-e48d-4824-ae60-19291a3a690f","source":"github","sourceId":"AlekseiUL/sprut-agent-kit/systematic-debugging","sourceUrl":"https://github.com/AlekseiUL/sprut-agent-kit/tree/main/skills/systematic-debugging","isPrimary":false,"firstSeenAt":"2026-05-13T12:58:22.369Z","lastSeenAt":"2026-05-18T18:57:12.713Z"}],"details":{"listingId":"9e9d890a-e48d-4824-ae60-19291a3a690f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"AlekseiUL","slug":"systematic-debugging","github":{"repo":"AlekseiUL/sprut-agent-kit","stars":63,"topics":["agent-skills","ai-agents","ai-assistant","automation","claude-code","claudeclaw","memory","self-hosted","starter-kit","telegram-bot"],"license":"mit","html_url":"https://github.com/AlekseiUL/sprut-agent-kit","pushed_at":"2026-05-13T11:20:57Z","description":"Ready-to-use AI agent with soul, memory, and 23 skills for ClaudeClaw ⚡","skill_md_sha":"b7fc240bd1695dc8ab360ebf73872ef7a2713322","skill_md_path":"skills/systematic-debugging/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/AlekseiUL/sprut-agent-kit/tree/main/skills/systematic-debugging"},"layout":"multi","source":"github","category":"sprut-agent-kit","frontmatter":{"name":"systematic-debugging","description":"Систематическая отладка при любых багах, ошибках, неожиданном поведении. Используй ПЕРЕД предложением фиксов. Триггеры: 'не работает', 'баг', 'ошибка', 'сломалось', 'debug', 'почему не', 'странное поведение', 'крон не запустился', 'скрипт падает'."},"skills_sh_url":"https://skills.sh/AlekseiUL/sprut-agent-kit/systematic-debugging"},"updatedAt":"2026-05-18T18:57:12.713Z"}}