К основному содержанию
affpapa.org
RU EN
скилл Claude Code CX Codex Cursor GitHub Copilot

investigate-first — скилл для Claude Code: диагностика до правок

Скилл держит агента в режиме разбора: собрать доказательства, назвать причину, и только потом трогать код. Пригодится, когда падение плавающее или причина неясна.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓ 
npx skills add JuliusBrussee/caveman --skill investigate-first -a claude-code
Открыть на GitHub

Что делает investigate-first

Обычная отладка с агентом начинается с догадки и патча. Здесь наоборот. Агент отделяет наблюдаемый симптом от своей версии причины, проходит по входным данным, переходам состояния, границам ответственности модулей и тексту ошибки. Гипотезы выстраиваются по силе доказательств и по тому, насколько дёшево каждую можно опровергнуть.

Продуктовый код не трогается, пока один механизм не объяснит все собранные факты. Как только причина или точное препятствие названы, поиск прекращается — дальше агент не роется. В отчёте причина и доказательство, патч только если задача прямо разрешает правку. Это защита от знакомого сценария, где агент уверенно чинит не то место.

Ставится одной командой: npx skills add JuliusBrussee/caveman --skill investigate-first -a claude-code, для другой платформы меняется флаг -a. Внутри один файл SKILL.md с протоколом, без скриптов. Ставить стоит тем, кто гоняет агента по большому репозиторию и получает ответы в духе «наверное, дело в кеше». Опечатку в одной строке быстрее поправить обычным запросом.

Какие задачи решает

  • найти причину плавающего теста, который падает не на каждом прогоне
  • разобрать регрессию производительности после обновления зависимости
  • отделить видимый симптом от догадки агента о причине
  • получить отчёт с доказательством до того, как кто-то начнёт править код
  • остановить бесконечное исследование, когда причина уже названа

Примеры запросов агенту

  • Разберись, почему `checkout.spec.ts` падает только на CI. Код пока не меняй.
  • Найди причину роста времени ответа у `/api/orders` и покажи доказательства под каждой гипотезой
  • В логах `ECONNRESET` — проведи расследование и разложи версии по силе доказательств

Как установить investigate-first

1Через Skills CLI (Vercel)

npx skills add JuliusBrussee/caveman --skill investigate-first -a claude-code

2Вручную: положить файлы

~/.claude/skills/investigate-first/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/investigate-first/

Из того же набора22

Весь набор →
caveman JuliusBrussee Убирает вежливые фразы и лишние слова из ответов ИИ-агента, сохраняя код и факты. Включается командой /caveman и действует всю сессию. Claude Code CX Codex Cursor +1 591 500установок caveman-commit JuliusBrussee Формирует краткие коммит-сообщения по стандарту Conventional Commits без лишних слов. Пригодится, когда нужно сфокусироваться на сути изменений. Claude Code CX Codex Cursor +1 414 700установок caveman-review JuliusBrussee Формирует сжатое ревью кода по одной строке на замечание с указанием места, проблемы и исправления. Без лишних вежливых фраз. Claude Code CX Codex Cursor +1 410 700установок caveman-compress JuliusBrussee Переписывает CLAUDE.md и списки задач в сжатый телеграфный стиль, чтобы модель читала меньше токенов. Исходник затирается, читаемая копия остаётся в отдельной папке. Claude Code CX Codex Cursor +1 410 300установок caveman-help JuliusBrussee Справка по режимам и командам Caveman для Claude Code и других поддерживаемых платформ. Нужна, когда вы настраиваете стиль ответов и связанные скиллы. Claude Code CX Codex Cursor +1 401 800установок cavecrew JuliusBrussee cavecrew распределяет поиск кода, небольшие правки и ревью между тремя субагентами. Подходит, когда контекст главного агента нужно расходовать экономно. Claude Code CX Codex Cursor +1 357 900установок caveman-stats JuliusBrussee Выводит статистику токенов и активный режим сессии или направляет к штатным отчётам хоста. Полезен для контроля расхода токенов вывода и кэша. Claude Code CX Codex Cursor +1 356 700установок caveman-explore JuliusBrussee Read-only скилл ищет нужные места в репозитории и возвращает ссылки на файлы со строками. Подходит для первого знакомства с кодовой базой. Claude Code CX Codex Cursor +1 106 500установок

Похожие

ponytail-audit DietrichGebert Проверяет репозиторий и ранжирует ошибки, риски и лишний код. Подойдёт, если нужен разовый разбор без автоматических правок. Claude Code CX Codex Cursor +1 44 800установок improve-codebase-architecture Matt Pocock Скилл ищет архитектурные узкие места в кодовой базе и показывает варианты углубления модулей в HTML-отчёте. Подойдёт для ревью перед рефакторингом. Claude Code 1 163 035установок tdd Matt Pocock Скилл управляет циклом красный-зелёный в TDD: проверяет, что тесты пишутся до кода, держит их на уровне публичных интерфейсов и не завязывает на внутреннюю структуру. Claude Code 1 141 062установок triage Matt Pocock Скилл проводит issue и внешние PR через роли триажа, проверку и подготовку брифа для агента. Подойдёт мейнтейнеру, который разбирает очередь задач. Claude Code 990 453установок codebase-design Matt Pocock Скилл помогает проектировать модули с небольшим интерфейсом и скрытой внутри сложностью. Подходит для рефакторинга, тестируемости и поиска чистого seam. Claude Code 850 344установок code-review Matt Pocock Проверяет изменения от выбранной точки по стандартам репозитория и требованиям задачи. Нужен для ревью ветки, PR или незавершённой работы. Claude Code 789 521установок implement Matt Pocock Выполняет задачу по спецификации или тикетам, ведёт работу через тесты и завершает её ревью с коммитом. Подходит для задач, где нужен дисциплинированный цикл разработки. Claude Code 774 700установок

Вопросы о investigate-first

Как установить investigate-first в Claude Code?

Командой npx skills add JuliusBrussee/caveman --skill investigate-first -a claude-code. Файл окажется в ~/.claude/skills/investigate-first/SKILL.md.

Что делает investigate-first?

Задаёт агенту порядок работы при сбое: доказательства, ранжированные гипотезы, названная причина. Правки в продуктовый код он не вносит, пока задача их не разрешает.

Для каких сбоев он рассчитан?

Для неясных причин, плавающего поведения и просадок производительности. То есть случаев, где показать на конкретную строку пока нельзя.

Исходный текст

SKILL.md · Apache-2.0 
---
name: investigate-first
description: Diagnose ambiguous failures before editing. Use for unknown causes, intermittent behavior, performance regressions, or investigations needing evidence-ranked hypotheses.
---

# Investigate first

Gather evidence before changing product code.

- Separate observed symptom from inferred cause.
- Trace inputs, state transitions, ownership boundaries, and failure output.
- Rank hypotheses by evidence and cheap falsification value.
- Do not edit until one credible mechanism explains evidence.
- Stop exploration when evidence is sufficient to name cause or exact blocker.

Report cause and proof. Make no fix unless task authorizes implementation.

© JuliusBrussee · Apache-2.0 · JuliusBrussee/caveman

Смотрите также

Спонсоры проекта

Компании, которые помогают держать аналитику открытой
Золотой спонсор AI-аналитика спроса на iGaming — индекс, тренды, конкуренты
Nutra.Club Закрытое сообщество Nutra-вертикали от команды M1

Показы, клики и копирования кода — открытая статистика. Мы держим цифры публичными по той же логике, что и сам NeBlask. Стать спонсором