debug-issue — скилл для Claude Code: отладка и установка
Скилл ведёт поиск причины ошибки через граф кода, а затем проверяет цепочку вызовов и последствия правки. Пригодится, когда нужно сузить область отладки до чтения исходников.
npx skills add tirth8205/code-review-graph --skill debug-issue -a claude-codeЧто делает debug-issue
debug-issue сначала запрашивает минимальный контекст задачи через get_minimal_context_tool, затем ищет связанные узлы с semantic_search_nodes_tool. Он прослеживает вызывающий и вызываемый код через query_graph_tool, строит путь выполнения с get_flow_tool и проверяет недавние изменения через detect_changes_tool.
Для файлов с подозрительным кодом скилл вызывает get_impact_radius_tool, чтобы оценить затронутые участки. Он предпочитает минимальный уровень детализации и точные запросы к графу вместо широких списков. Ориентир — около пяти вызовов инструментов и 800 токенов графового вывода на задачу.
Перед изменением кода нужно прочитать реализацию и её тесты. Граф лишь сужает поиск, поэтому это повод проверить вывод инструментов по исходникам.
Какие задачи решает
- найти код, связанный с ошибкой
- проследить цепочку вызовов в обе стороны
- выявить изменение, вызвавшее сбой
- построить путь выполнения до подозрительного кода
- оценить последствия исправления файлов
Примеры запросов агенту
- Разберись с ошибкой: сначала пройди по графу вызовов и найди точку входа.
- Найди недавнее изменение, которое могло вызвать этот сбой, и проверь радиус влияния правки.
- Отладь проблему через граф кода, затем прочитай реализацию и тесты перед исправлением.
Как установить debug-issue
1Через Skills CLI (Vercel)
npx skills add tirth8205/code-review-graph --skill debug-issue -a claude-code2Вручную: положить файлы
~/.claude/skills/debug-issue/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/debug-issue/
1Через Skills CLI (Vercel)
npx skills add tirth8205/code-review-graph --skill debug-issue -a codex2Вручную: положить файлы
.agents/skills/debug-issue/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add tirth8205/code-review-graph --skill debug-issue -a cursor2Вручную: положить файлы
.cursor/skills/debug-issue/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install tirth8205/code-review-graph debug-issue2Вручную: положить файлы
.github/skills/debug-issue/SKILL.md1Через Skills CLI (Vercel)
npx skills add tirth8205/code-review-graph --skill debug-issue -a gemini-cli2Командой платформы
gemini skills install https://github.com/tirth8205/code-review-graph --path skills/debug-issueВручную: положить файлы
.devin/skills/debug-issue/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add tirth8205/code-review-graph --skill debug-issue -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора7
Весь набор →Похожие
Вопросы о debug-issue
Как установить debug-issue в Claude Code?
Выполните npx skills add tirth8205/code-review-graph --skill debug-issue -a claude-code, затем повторите npx skills add tirth8205/code-review-graph --skill debug-issue -a claude-code. Файл скилла расположен в ~/.claude/skills/debug-issue/SKILL.md.
Что делает debug-issue?
Скилл исследует ошибку через граф кода: находит связанные узлы, цепочки вызовов, путь выполнения, недавние изменения и радиус влияния будущей правки.
Как debug-issue ограничивает объём контекста?
Он начинает с get_minimal_context_tool и передаёт detail_level="minimal", когда инструмент принимает этот параметр. Более подробный режим нужен только когда минимального недостаточно.
Исходный текст
SKILL.md · MIT
--- name: debug-issue description: Systematically debug issues using graph-powered code navigation --- ## Debug Issue Trace a bug through the knowledge graph before reading source. ### Steps 1. Call `semantic_search_nodes_tool` to find code related to the issue. 2. Call `query_graph_tool` with `callers_of` and `callees_of` to trace the call chain in both directions. 3. Call `get_flow_tool` for the execution path that reaches the suspect code. Its entry point is where the bug is triggered. 4. Call `detect_changes_tool` to check whether a recent change caused the issue. 5. Call `get_impact_radius_tool` on the suspect files to see what a fix would affect. ## Token Efficiency Rules - Call `get_minimal_context_tool(task="<your task>")` before any other graph tool. - Pass `detail_level="minimal"` wherever a tool accepts it. Use "standard" only when minimal is not enough. - Prefer a targeted `query_graph_tool` call over a broad listing call. - Budget: about five tool calls and 800 tokens of graph output per task. - Read the implementation and its tests before changing code. The graph narrows scope; it does not replace the source.
© tirth8205 · MIT · tirth8205/code-review-graph