safe-debug — скилл для Claude Code: что делает и как установить
Консервативная диагностика сбоев в deep learning исследованиях: локализует причину ошибки и готовит минимальный патч без несогласованных правок в коде.
npx skills add lllllllama/RigorPilot-Skills --skill safe-debug -a claude-codeЧто делает safe-debug
Скилл safe-debug задаёт строгий регламент отладки для исследовательских ML-проектов. При падении обучения, утечке памяти CUDA OOM, несоответствии размерностей тензоров или появлении NaN в функции потерь агент не переписывает код сразу. Он сначала локализует первопричину сбоя и сохраняет выводы в папку debug_outputs/.
В ходе анализа формируются отчёты debug_outputs/DIAGNOSIS.md, debug_outputs/PATCH_PLAN.md и файл состояния debug_outputs/status.json. Агент обязан предложить наименьшее возможное исправление и запросить прямое одобрение пользователя перед любым изменением файлов. Для правок со средним или высоким риском требуется создание ветки или контрольной точки.
Главное правило скилла: исправление бага не приравнивается к исследовательскому результату. Если предложенный патч влияет на сопоставимость или научный смысл эксперимента, агент прямо предупредит об этом. Скилл непригоден для общего рефакторинга или ознакомительных обзоров репозитория.
Какие задачи решает
- Локализовать сбои CUDA OOM и ошибки загрузки чекпоинтов
- Найти причину расхождения размерностей тензоров и NaN loss
- Сформировать план минимального патча в
debug_outputs/PATCH_PLAN.md - Предотвратить несанкционированные правки файлов репозитория агентом
- Отделить технические исправления от исследовательских результатов
Примеры запросов агенту
- Обучение упало с ошибкой CUDA out of memory, разбери трейсбек через safe-debug без изменения файлов
- При расчёте функции потерь появился NaN loss, найди причину сбоя и подготовь отчёт в
debug_outputs/DIAGNOSIS.md - В коде возникло несоответствие размерностей тензоров, предложи минимальный патч в
debug_outputs/PATCH_PLAN.md
Как установить safe-debug
1Через Skills CLI (Vercel)
npx skills add lllllllama/RigorPilot-Skills --skill safe-debug -a claude-code2Вручную: положить файлы
~/.claude/skills/safe-debug/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/safe-debug/
1Через Skills CLI (Vercel)
npx skills add lllllllama/RigorPilot-Skills --skill safe-debug -a codex2Вручную: положить файлы
.agents/skills/safe-debug/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add lllllllama/RigorPilot-Skills --skill safe-debug -a cursor2Вручную: положить файлы
.cursor/skills/safe-debug/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install lllllllama/RigorPilot-Skills safe-debug2Вручную: положить файлы
.github/skills/safe-debug/SKILL.md1Через Skills CLI (Vercel)
npx skills add lllllllama/RigorPilot-Skills --skill safe-debug -a gemini-cli2Командой платформы
gemini skills install https://github.com/lllllllama/RigorPilot-Skills --path skills/safe-debugВручную: положить файлы
.devin/skills/safe-debug/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add lllllllama/RigorPilot-Skills --skill safe-debug -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о safe-debug
Как установить safe-debug в Claude Code?
Выполните команду npx skills add lllllllama/RigorPilot-Skills --skill safe-debug -a claude-code. Также файл скилла можно сохранить вручную по пути ~/.claude/skills/safe-debug/SKILL.md.
Что делает скилл safe-debug?
Он направляет агента на осторожную диагностику ошибок deep learning без автоматической правки кода. Скилл требует подтверждения любых изменений и документирует выводы в папке debug_outputs/.
В каких случаях safe-debug не подходит?
Скилл нельзя запускать для ознакомления со структурой проекта, исследовательских экспериментов без активных ошибок или крупного рефакторинга кода.
Исходный текст
SKILL.md · MIT
--- name: safe-debug description: Rigor Debug / Rigor Audit skill for deep learning research work. Use when the user pastes a traceback, terminal error, CUDA OOM, checkpoint load failure, shape mismatch, NaN loss symptom, or training failure and wants conservative diagnosis before any patching, with debug fixes clearly separated from research contributions. Do not use for broad refactoring, speculative adaptation, automatic exploratory patching, or general repository familiarization. --- # safe-debug Use this as the Rigor Debug / Rigor Audit skill. The installed slug remains `safe-debug` for compatibility. Use the shared operating principles in `../ai-research-reproduction/references/agent-operating-principles.md`; this skill should guide conservative diagnosis without blocking the model from finding the local root cause. ## When to apply - The user provides a traceback, terminal error, or concrete training or inference failure symptom. - The user wants diagnosis, root-cause narrowing, and minimal patch suggestions before code is changed. - The user wants a safe debug flow with explicit human approval before mutation. ## When not to apply - When the user wants a broad repository walkthrough without an active failure. - When the task is speculative experimentation or code adaptation. - When the user is asking for a large refactor or readability rewrite. ## Clear boundaries - Diagnose first. - Do not modify repository code by default. - If a patch is needed, propose the smallest fix and require explicit approval first. - Escalate savepoint or branch creation before medium-risk or high-risk changes. - A debug fix is not automatically a research contribution; if it changes experiment meaning or comparability, say so explicitly. ## Output expectations - `debug_outputs/DIAGNOSIS.md` - `debug_outputs/PATCH_PLAN.md` - `debug_outputs/status.json` ## Notes Use `references/debug-policy.md`, `../ai-research-reproduction/references/research-rigor-principles.md`, and the shared `../ai-research-reproduction/references/research-pitfall-checklist.md`.
© lllllllama · MIT · lllllllama/RigorPilot-Skills
