root-cause-tracing · neolabhq — скилл для Claude Code: поиск корня бага
Скилл учит агента идти по стеку вызовов назад, пока не найдётся исходный триггер ошибки, и править там, а не на месте падения.
npx skills add NeoLabHQ/context-engineering-kit --skill root-cause-tracing -a claude-codeЧто делает root-cause-tracing
Ошибка всплывает глубоко в стеке: git init в чужой папке, файл не там, база открыта по неверному пути. Скилл задаёт порядок разбора: сначала симптом, потом код, который его вызвал, потом вопрос «а что вызвало этот код». Так доходят до места, где появилось пустое значение или неверный параметр.
Когда вручную цепочку не проследить, скилл советует добавить инструментацию: new Error().stack перед опасной операцией, вывод через console.error() — в тестах логгер может молчать. Дальше запуск тестов с фильтром по метке и разбор стеков: имена файлов, номера строк, повторяющийся параметр. Для поиска теста, который гадит в общее состояние, в наборе есть скрипт find-polluter.sh — он гоняет тесты по одному и останавливается на первом виновнике.
Правка только в точке падения оставляет баг живым: тот же пустой аргумент придёт снова. Скилл требует закрыть источник и добавить проверки на каждом слое — в примере из практики это валидация каталога, запрет пустого значения и отказ от git init вне временной папки. Скрипт полагается на bash, поэтому на Windows без WSL он не поедет.
Какие задачи решает
- найти, откуда в глубокий вызов пришло пустое или битое значение
- разобрать длинный стек вызовов и не чинить симптом
- вычислить тест, который оставляет мусор в общем каталоге
- добавить трассировку перед опасной операцией, когда руками цепочку не видно
- закрыть источник бага проверками на нескольких слоях
Примеры запросов агенту
- Ошибка вылезает глубоко в стеке, проследи цепочку вызовов назад до исходного триггера и почини там
- Добавь трассировку перед git init и покажи, какой тест передаёт пустой projectDir
- Что-то создаёт .git в папке с исходниками во время тестов — найди виновника через find-polluter.sh
Как установить root-cause-tracing
1Через Skills CLI (Vercel)
npx skills add NeoLabHQ/context-engineering-kit --skill root-cause-tracing -a claude-code2Вручную: положить файлы
~/.claude/skills/root-cause-tracing/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/root-cause-tracing/
1Через Skills CLI (Vercel)
npx skills add NeoLabHQ/context-engineering-kit --skill root-cause-tracing -a codex2Вручную: положить файлы
.agents/skills/root-cause-tracing/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add NeoLabHQ/context-engineering-kit --skill root-cause-tracing -a cursor2Вручную: положить файлы
.cursor/skills/root-cause-tracing/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install NeoLabHQ/context-engineering-kit root-cause-tracing2Вручную: положить файлы
.github/skills/root-cause-tracing/SKILL.md1Через Skills CLI (Vercel)
npx skills add NeoLabHQ/context-engineering-kit --skill root-cause-tracing -a gemini-cli2Командой платформы
gemini skills install https://github.com/NeoLabHQ/context-engineering-kit --path skills/root-cause-tracingВручную: положить файлы
.devin/skills/root-cause-tracing/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add NeoLabHQ/context-engineering-kit --skill root-cause-tracing -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о root-cause-tracing
Как установить root-cause-tracing в Claude?
Выполните npx skills add NeoLabHQ/context-engineering-kit --skill root-cause-tracing -a claude-code. После этого файл скилла лежит в ~/.claude/skills/root-cause-tracing/SKILL.md.
Что делает root-cause-tracing?
Ведёт разбор ошибки назад по цепочке вызовов до исходного триггера и требует править в источнике, а не там, где упало. Если вручную не выходит, подсказывает, какую инструментацию добавить.
Чем отличается от обычной отладки по стеку?
Скилл запрещает останавливаться на первом найденном месте сбоя и просит добавить проверки на каждом слое, чтобы тот же баг не вернулся. Для поиска теста-загрязнителя в наборе идёт find-polluter.sh.
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — root-cause-tracing от других авторов.
