investigation — скилл для Claude Code: структурированный разбор кода
Скилл investigation для Claude Code создаёт датированную папку в scratch/ с README и чек-листом для исследования кода. Прослеживает поток данных и помогает разобраться в чужой архитектуре.
BSD-3-Clause-Clear 1 установок ★ 624 обновлён 2026-10-20
npx skills add talmolab/sleap --skill investigation -a claude-codeЧто делает investigation
Скилл заводит в репозитории каталог scratch/{YYYY-MM-DD}-{descriptive-name} и кладёт туда README.md: постановку задачи, контекст и чек-лист, который пополняется по мере находок. Рядом появляются скрипты и данные для проверок. Крупное исследование разбивается на нумерованные поддокументы.
Ходов несколько, и они смешиваются. Трассировка идёт по стеку вызовов или по данным вперёд и назад от выбранного компонента. Разбор архитектуры начинается с точек входа и проходит по всем слоям. Баг ищут через воспроизведение и поиск корневой причины. Выполнимость идеи проверяют пробными скриптами, а перед проектированием API собирают варианты и их компромиссы, нумеруя спорные вопросы как DQ1, DQ2.
Из практики: отдельные скрипты скилл советует запускать через uv с инлайн-зависимостями, внешние пакеты клонировать в scratch/repos/, а для скриншотов веб-страниц держать под рукой Playwright MCP. Папка scratch/ прописана в .gitignore, поэтому в коммит оттуда ничего не попадёт — выводы для PR переносят в описание руками.
Какие задачи решает
- проследить, откуда приходят данные в компонент и куда уходят
- разобрать незнакомую архитектуру от точек входа до слоёв
- найти корень бага по шагам воспроизведения
- проверить на пробном скрипте, выполнима ли идея
- собрать контекст и альтернативы перед проектированием API
Примеры запросов агенту
- Начни исследование: проследи путь от
load_labelsдо записи файла. - Разберись, почему падает тест
test_predict, и сложи заметки в папку исследования. - Собери контекст по API экспорта: какие варианты дизайна есть и чем они различаются.
Как установить investigation
1Через Skills CLI (Vercel)
npx skills add talmolab/sleap --skill investigation -a claude-code2Вручную: положить файлы
~/.claude/skills/investigation/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/investigation/
1Через Skills CLI (Vercel)
npx skills add talmolab/sleap --skill investigation -a codex2Вручную: положить файлы
.agents/skills/investigation/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add talmolab/sleap --skill investigation -a cursor2Вручную: положить файлы
.cursor/skills/investigation/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install talmolab/sleap .claude/skills/investigation2Вручную: положить файлы
.github/skills/investigation/SKILL.md1Через Skills CLI (Vercel)
npx skills add talmolab/sleap --skill investigation -a gemini-cli2Командой платформы
gemini skills install https://github.com/talmolab/sleap --path .claude/skills/investigationВручную: положить файлы
.devin/skills/investigation/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add talmolab/sleap --skill investigation -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об investigation
Как установить investigation в Claude Code?
Выполните npx skills add talmolab/sleap --skill investigation -a claude-code. Скилл окажется в ~/.claude/skills/investigation/SKILL.md.
Что делает investigation?
Заводит в scratch/ датированную папку под одну задачу: README с постановкой и чек-листом, затем скрипты и данные для проверок. Дальше ведёт исследование по выбранному ходу — трассировка, архитектура, баг, выполнимость, дизайн.
Попадут ли заметки из scratch/ в git?
Нет, эта папка в .gitignore. Находки для PR копируют прямо в описание, потому что ссылки на файлы из scratch/ в репозитории не останутся.