self-review · sammcj — скилл для Claude Code: критический обзор своих правок
Скилл self-review запускает критическую самопроверку изменений. Подходит и для мелких правок, и для делегирования ревью субагенту.
Apache-2.0 ★ 173 обновлён 2026-10-24
npx skills add sammcj/agentic-coding --skill self-review -a claude-codeЧто делает self-review
Скилл предлагает два пути. Для небольших изменений в одном файле он перечитывает правку скептически: корректность, полнота, регрессии, лишняя сложность, неоправданная многословность. Найденные проблемы исправляются сразу.
Для изменений, которые затрагивают несколько файлов или фич, скилл делегирует проверку субагенту critical-reviewer. Тот читает код свежим взглядом и возвращает приоритизированные находки с severity и позицией file:line. Дальше вы разбираете их по серьёзности и применяете исправления. Свежий ревьюер ловит то, в чём вы себя уже убедили, и не тащит рассуждения о ревью в ваш контекст.
При делегировании есть свои правила: дать список изменённых файлов через git diff --name-only, исходную задачу и границы скоупа, а также пометки о том, что выглядит неправильно, но сделано намеренно. Скилл советует писать бриф тезисно, ключевыми словами, а не прозой. Для очень сложных изменений можно взять модель fable, для обычных хватит opus. Параллелить ревью стоит только на независимых частях; если части связаны общим интерфейсом, один ревьюер должен видеть обе стороны. Максимум циклов ревью — 3.
Какие задачи решает
- Поймать регрессию в собственных правках
- Проверить изменение на избыточную сложность
- Отдать большое ревью субагенту без предвзятости
- Разобрать находки по severity и позиции file:line
- Не засорять свой контекст рассуждениями о ревью
Примеры запросов агенту
- Проверь мои последние правки скиллом self-review
- Отревьюй изменения в auth-модуле через critical-reviewer, вот список файлов
- Прогони самопроверку по свежим изменениям и исправь, что найдёшь
Как установить self-review
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill self-review -a claude-code2Вручную: положить файлы
~/.claude/skills/self-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/self-review/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill self-review -a codex2Вручную: положить файлы
.agents/skills/self-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill self-review -a cursor2Вручную: положить файлы
.cursor/skills/self-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills/self-review/SKILL.md2Вручную: положить файлы
.github/skills/self-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill self-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/sammcj/agentic-coding --path Skills/self-reviewВручную: положить файлы
.devin/skills/self-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о self-review
Как установить self-review в Claude Code?
Выполните npx skills add sammcj/agentic-coding --skill self-review -a claude-code. Скилл появится в ~/.claude/skills/self-review/SKILL.md.
Что делает скилл self-review?
Перечитывает ваши недавние правки скептически и исправляет найденные проблемы. Для маленьких изменений ревью делает сам, для больших — делегирует субагенту critical-reviewer.
Когда делегировать ревью субагенту, а не делать самому?
Когда изменение затрагивает несколько файлов, фич или фиксов. Свежий ревьюер ловит то, что вы упустили из-за погружённости в задачу.
Исходный текст
SKILL.md · Apache-2.0
--- name: self-review description: Use to critically self-review your changes, or when you want to delegate the review to a sub-agent. argument-hint: "[optional focus or extra context]" --- Critically review your recent changes and fix any issues you find. Choose one of the two paths below, based on the size of the change. When in doubt, delegate - the cost is low and the unbiased read is the point. ## Option A: Review it yourself (small or simple changes) For a single file, or one focused fix or feature: Re-read what you changed with a sceptical eye - correctness, completeness, regressions, over-engineering, unwarranted verbosity. Then fix what you find directly. ## Option B: Delegate to the reviewer (larger changes) For changes spanning multiple files, features, or fixes: Delegate to the `critical-reviewer` subagent(s) for a fresh, unbiased read, then act on what they report. - A fresh reviewer catches what you've talked yourself into, and keeps the review reasoning out of your context. - The reviewer is read-only and returns prioritised findings (each with a severity and a `file:line` location); you triage by severity and apply the fixes. When you delegate: - **If the change is large or complex.** Consider calling the sub-agent with the fable model (if it's available) as it's the most powerful AI model. - **Provide a high signal brief.** The agent operates outside of this conversation's context. Give it: the list of changed files (names only, e.g. `git diff --name-only`), the task you were originally asked to do and what was in / out of scope, and anything intentional that looks wrong but isn't. - **Parallelise only on independent slices.** Spawn one reviewer per group of changes that don't interact (by subsystem, layer, or requirement), and give each an explicit boundary - the files or area it owns - so they don't overlap. When slices share an interface or contract, brief at least one reviewer on both sides, or use a single reviewer - a fresh reviewer that sees only one side can't catch the interaction. Don't split for its own sake. - **Stay fresh by default.** A fresh reviewer gives the unbiased read that makes self-review worth doing. Fork only if the review genuinely needs this conversation's nuance; never fork it for the adversarial read, since a fork inherits this agent's bias and defeats the point. - **Write the brief in terse notes.** Keywords and bullets, not full prose; the reviewer is a capable model, not an audience. - **For very complex changes pick the best model.** If the work to review is very complex, use the most capable model available (e.g. `fable`), for normal reviews use the default model (`opus`). After each reviewer agent has finished and returned it's findings (unless there is a good reason to wait for all findings, or instructed otherwise): 1. Action the (valid) findings. - **Fix what's real.** Apply the fixes for genuine findings, then verify (build, tests, lint). Push back on findings that are wrong rather than changing correct code to satisfy them. 2. If you make large amounts of changes, loop back and run another review cycle (maximum loops: 3). --- `$ARGUMENTS`
© sammcj · Apache-2.0 · sammcj/agentic-coding
Похожие скиллы
Все скиллы по теме «Код-ревью и рефакторинг» →Сначала — self-review от других авторов.