Когда это нужноWhen to reach for itКоли це потрібно
Нужен прямой и быстрый взгляд на diff: замечания, а не развёрнутый отчёт, без вступлений и похвал для объёма.You want a blunt, fast look at a diff: findings and not a write-up, with no throat-clearing or praise padding.Потрібен прямий і швидкий погляд на diff: зауваження, а не розгорнутий звіт, без вступів і похвал для об'єму.
ТребованияRequirementsВимоги
- Где доступноAvailable inДе доступно
- Каждая загрузка kitEvery download of the kitКожне завантаження kit
- К чему обращаетсяWhat it touchesДо чого звертається
- Читает файлы проектаReads the files of your projectЧитає файли проєкту
- Запускает команды (проверки, git)Runs commands (checks, git)Запускає команди (перевірки, git)
- Работает сWorks withПрацює з
- Сделано для Claude Code; другие агенты адаптируютBuilt for Claude Code; other agents adapt itЗроблено для Claude Code; інші агенти адаптують
- Где выполняются шагиWhere the steps happenДе виконуються кроки
- Чат вашего агента и ваши собственные файлы. Ни то ни другое не интерфейс этого сайта, поэтому шаги описаны текстом, а не скриншотами.Your agent's chat and your own files. Neither is an interface of this site, so the steps are text and not screenshots.Чат вашого агента і ваші власні файли. Ні те, ні інше не є інтерфейсом цього сайту, тому кроки описано текстом, а не скриншотами.
- Где это лежит в kitWhere it lives in the kitДе це лежить у kit
.claude/skills/caveman-review/SKILL.md
Прежде чем начатьBefore you startПерш ніж почати
Краткость - это формат, а не сниженная планка. Если однострочный комментарий скрыл бы важный контекст безопасности, архитектуры или разрушительного риска, либо проблема связана с безопасностью или архитектурно нетривиальна, ревью переходит на короткий абзац вместо принудительного сжатия до одной строки.Terse is a format, not a lower bar. When a one-line comment would hide important security, architectural or destructive-risk context, or the issue is security-sensitive or architecturally non-trivial, the review switches to a short paragraph instead of forcing one-line compression.Стислість - це формат, а не знижена планка. Якщо однорядковий коментар приховав би важливий контекст безпеки, архітектури чи руйнівного ризику, або проблема стосується безпеки чи архітектурно нетривіальна, рев'ю переходить на короткий абзац замість примусового стискання до одного рядка.
ШагиStepsКроки
- Введите
/caveman-review, чтобы проверить текущий diff или переданный вами контекст, либо назовите цель:/caveman-review PaymentServiceсфокусируется на одном файле или символе. Строка вызова:/caveman-review [optional: file, diff, or topic].Type/caveman-reviewto review the current diff or the context you provide, or name a target:/caveman-review PaymentServicefocuses on one file or symbol. The usage line is/caveman-review [optional: file, diff, or topic].Введіть/caveman-review, щоб перевірити поточний diff або переданий вами контекст, або назвіть ціль:/caveman-review PaymentServiceзосередиться на одному файлі чи символі. Рядок виклику:/caveman-review [optional: file, diff, or topic]. - Агент проверяет по обычной планке: сначала баги, риски, регрессии и недостающие тесты.The agent reviews at the normal bar: bugs, risks, regressions and missing tests come first.Агент перевіряє за звичайною планкою: спершу баги, ризики, регресії та бракуючі тести.
- Он выводит замечания до любого резюме, по одной строке на замечание, пока ясность сохраняется. Строка начинается с файла и номера строки, затем идёт метка:
bug,riskилиnitс проблемой и исправлением либоqс вопросом. Например:PaymentService.cs:L42: bug: refund runs twice on retry. Add an idempotency key.It prints findings before any summary, one line per finding when clarity is preserved. A line starts with the file and the line number, then a label:bug,riskornitfollowed by the problem and a fix, orqfollowed by a question. For example:PaymentService.cs:L42: bug: refund runs twice on retry. Add an idempotency key.Він виводить зауваження перед будь-яким підсумком, по одному рядку на зауваження, поки ясність зберігається. Рядок починається з файлу й номера рядка, далі йде мітка:bug,riskабоnitз проблемою та виправленням чиqіз запитанням. Наприклад:PaymentService.cs:L42: bug: refund runs twice on retry. Add an idempotency key. - Символы, имена файлов, номера строк, команды, API и тексты ошибок остаются точными. Совет без конкретного направления, например голое предложение провести рефакторинг, недопустим: каждое замечание применимо на практике и технически точно.Exact symbols, file names, line numbers, commands, APIs and error strings stay unchanged. Advice with no concrete direction, such as a bare suggestion to refactor, is not allowed: every finding is actionable and technically exact.Символи, імена файлів, номери рядків, команди, API й тексти помилок лишаються точними. Порада без конкретного напрямку, наприклад голе пропонування зробити рефакторинг, неприпустима: кожне зауваження придатне до дії й технічно точне.
- Если замечаний нет, ревью прямо об этом говорит и коротко называет оставшиеся пробелы в тестах или проверке.If there are no findings, the review says so explicitly and briefly names the residual test or validation gaps.Якщо зауважень немає, рев'ю прямо про це каже й коротко називає залишкові прогалини в тестах чи перевірці.
Что вы должны увидетьWhat you should seeЩо ви маєте побачити
Замечания, поставленные раньше любого резюме, у каждого файл, строка, метка и конкретное исправление или вопрос; либо прямое заявление, что замечаний нет, и оставшиеся пробелы в тестах и проверке.Findings placed ahead of any summary, each with file, line, label and a concrete fix or question; or an explicit statement that there are no findings, plus the remaining test and validation gaps.Зауваження, поставлені раніше за будь-який підсумок, у кожного файл, рядок, мітка й конкретне виправлення чи запитання; або пряма заява, що зауважень немає, і залишкові прогалини в тестах та перевірці.
СоветыTipsПоради
- /critique - более полный проход, с замечаниями, сгруппированными по важности. Для краткого вывода по одной строке на замечание kit отсылает к этой команде./critique is the fuller pass, with findings grouped by severity. For terse one-line-per-finding output the kit points to this command instead./critique - повніший прохід, із зауваженнями, згрупованими за важливістю. Для стислого виводу по одному рядку на зауваження kit відсилає до цієї команди.
- Ревью пишется на языке чата, если только вы не попросите готовые к вставке комментарии для PR: они пишутся на языке, который ваш проект задал в
<ARTIFACT_LANGUAGE>- плейсхолдере файла правил.The review is written in the chat language, unless you ask for paste-ready PR comments: those go in the language your project set as<ARTIFACT_LANGUAGE>, a placeholder of the rules file.Рев'ю пишеться мовою чату, якщо тільки ви не попросите готові до вставки коментарі для PR: вони пишуться мовою, яку ваш проєкт задав у<ARTIFACT_LANGUAGE>- плейсхолдері файлу правил. - Чтобы кратким был каждый ответ в чате, а не только ревью, включите /caveman. Для сообщения коммита есть /caveman-commit.To make every reply in the chat terse, not only the review, use /caveman. For a commit message there is /caveman-commit.Щоб стислою була кожна відповідь у чаті, а не лише рев'ю, увімкніть /caveman. Для повідомлення коміту є /caveman-commit.
Связанные функцииRelated functionsПов'язані функції
- Провести ревью изменения и получить замечания по серьёзностиCritique a change and get findings by severityПровести рев'ю зміни й отримати зауваження за серйозністюСжатое ревью diff, документа, набора данных или договора: сначала замечания, самые серьёзные выше, у каждого место и конкретная правка.A terse review of a diff, a document, a dataset or a contract: findings first, highest severity on top, each with a place and a concrete fix.Стисле рев'ю diff, документа, набору даних чи договору: спершу зауваження, найсерйозніші вгорі, у кожного місце й конкретна правка.
- Перевести весь чат на короткие ответы по делуPut the whole chat into brief, signal-only repliesПеревести весь чат на короткі відповіді по суті
/cavemanпереводит текущий чат в сжатый режим трёх степеней,lite,fullилиultra, и держит его, пока вы не скажетеstop cavemanилиnormal mode./cavemanswitches the current chat into terse mode at three intensities,lite,fullorultra, and keeps it until you saystop cavemanornormal mode./cavemanпереводить поточний чат у стислий режим трьох ступенів,lite,fullабоultra, і тримає його, доки ви не скажетеstop cavemanчиnormal mode. - Получить краткое сообщение коммита для вставкиGet a terse Conventional Commit message to pasteОтримати стисле повідомлення коміту для вставки
/caveman-commitпишет краткое сообщение коммита в формате Conventional Commits по вашему описанию или diff, блоком для вставки.git commitон не запускает./caveman-commitwrites a terse Conventional Commit message from your description or the current diff, as a code block to paste. It never runsgit commit./caveman-commitпише стисле повідомлення коміту у форматі Conventional Commits за вашим описом або поточним diff, блоком коду для вставки.git commitвін не запускає.