debug · yeachan-heo — скилл для Claude Code: что делает и как установить
Находит причины сбоев в текущей сессии Claude Code или кодовой базе через анализ логов, трейсов и состояния агента. Пригодится при поломке хуков или сценариев.
npx skills add Yeachan-Heo/oh-my-claudecode --skill debug -a claude-codeЧто делает debug
Скилл разбирает ошибки выполнения и запутанное поведение сессий oh-my-claudecode. Сначала он проверяет локальные свидетельства: трейсы, снимки состояния, память проекта и упавшие команды, не полагаясь на догадки.
Масштабное переписывание кода до выяснения корня проблемы прямо запрещено правилами скилла. Временный отладочный вывод маркируется тегом [DEBUG-<4hex>], поэтому весь диагностический мусор легко удалить одной командой grep. Секреты и токены вырезаются из трейсов до того, как данные покинут сессию.
В финале разработчик получает зафиксированный сбой, гипотезу первопричины с доказательствами и один минимальный шаг для исправления. Если проблема вызвана архитектурным стыком, скилл направляет к refit или architecture-survey.
Какие задачи решает
- локализовать сбой в цепочке вызовов хуков и агентов
- отделить симптомы ошибки от её корневой причины
- очистить временные логи по единому тегу
- скрыть секреты и токены в выводимых трейсах
Примеры запросов агенту
- Помоги понять, почему сломался хук в текущей сессии
- Выясни причину падения теста и покажи трейсы состояния
- Изолируй сбой в поведении агента без правок всего проекта
Как установить debug
1Через Skills CLI (Vercel)
npx skills add Yeachan-Heo/oh-my-claudecode --skill debug -a claude-code2Вручную: положить файлы
~/.claude/skills/debug/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/debug/
1Через Skills CLI (Vercel)
npx skills add Yeachan-Heo/oh-my-claudecode --skill debug -a codex2Вручную: положить файлы
.agents/skills/debug/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Yeachan-Heo/oh-my-claudecode --skill debug -a cursor2Вручную: положить файлы
.cursor/skills/debug/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Yeachan-Heo/oh-my-claudecode debug2Вручную: положить файлы
.github/skills/debug/SKILL.md1Через Skills CLI (Vercel)
npx skills add Yeachan-Heo/oh-my-claudecode --skill debug -a gemini-cli2Командой платформы
gemini skills install https://github.com/Yeachan-Heo/oh-my-claudecode --path skills/debugВручную: положить файлы
.devin/skills/debug/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Yeachan-Heo/oh-my-claudecode --skill debug -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора26
Весь набор →Другие версии debug
Похожие
Вопросы о debug
Как установить debug в Claude Code?
Выполните команду npx skills add Yeachan-Heo/oh-my-claudecode --skill debug -a claude-code. Также файл скилла можно сохранить по пути ~/.claude/skills/debug/SKILL.md.
Что делает скилл debug?
Он анализирует трейсы, состояние сессии и память проекта, чтобы выявить корневую причину сбоя и предложить один минимальный шаг для проверки или исправления.
Как очистить временный отладочный вывод?
Скилл помечает все диагностические логи префиксом [DEBUG-<4hex>], поэтому временные строки легко найти и удалить через команду grep.
Исходный текст
SKILL.md · MIT
--- name: debug description: Diagnose the current OMC session or repo state using logs, traces, state, and focused reproduction --- # Debug Use this skill when the user wants help diagnosing a current OMC/Claude-Code session problem, workflow breakage, or confusing runtime behavior. ## Goal Find the real failure signal quickly and explain the next corrective step. ## Workflow 1. Read the user’s issue description carefully. 2. Inspect the most relevant local evidence first: - trace tools - state tools - notepad / project memory when relevant - failing tests or commands 3. Reproduce the issue narrowly if possible. 4. Distinguish symptoms from root cause. 5. Recommend the smallest next fix or verification step. ## Rules - Prefer real evidence over guesses. - Use the trace/state surfaces when the issue involves orchestration, hooks, or agent flow. - If the issue is actually a product/runtime bug rather than app code, say so plainly. - Do not prescribe broad rewrites before isolating the failure. - Tag temporary debug output `[DEBUG-<4hex>]`; cleanup is then a single grep. - Redact secrets from logs and traces before they leave the session. - If the failure traces to a missing or wrong seam, say so as the finding and point at `refit` or `architecture-survey` — the environment lesson outlives the fix. ## Output - Observed failure - Root-cause hypothesis - Evidence for that hypothesis - Smallest next action
© Yeachan-Heo · MIT · Yeachan-Heo/oh-my-claudecode
