К основному содержанию
скилл CX Codex

review-loop · sangrokjung — скилл для Claude Code: что делает и как установить

Скилл review-loop запускает цикл встречной проверки: исполнитель пишет код, а независимый проверяющий агент ищет в нём уязвимости и ошибки до вердикта APPROVE.

MIT ★ 880 обновлён 2026-09-03

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

Что делает review-loop

Скилл внедряет процедуру состязательной верификации для любых поведенческих правок в коде, конфигурациях, скриптах или CI/CD. Автор изменений не проверяет себя сам. После написания кода запускаются целевые тесты, собираются доказательства работоспособности, а затем вызывается отдельный субагент с чистым контекстом, задача которого — сломать реализацию или найти скрытые дефекты.

Процесс оперирует тремя вердиктами: APPROVE, REQUEST_CHANGES и UNVERIFIED. При замечаниях автор исправляет только указанные места и снова отдаёт диф свежему проверяющему. Для критических областей вроде авторизации, платежей или деструктивных миграций скилл требует две параллельные линии контроля от разных агентов — корректность и безопасность.

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

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

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

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

  • Запусти review loop для текущих изменений перед коммитом
  • Проведи adversarial review этой ветки с отдельным проверяющим
  • Сделай maker-checker верификацию правок в модуле платежей

Как установить review-loop

1Через Skills CLI (Vercel)

npx skills add sangrokjung/claude-forge --skill review-loop -a claude-code

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

~/.claude/skills/review-loop/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о review-loop

Как установить review-loop в Claude Code?

Выполните команду npx skills add sangrokjung/claude-forge --skill review-loop -a claude-code в терминале.

Для каких задач скилл не подходит?

Скилл не применяется к правкам обычной документации, маркетинговым текстам, опечаткам и форматированию, которые никак не меняют поведение исполняемой системы.

Почему проверяющий агент не может сам вносить исправления?

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

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

SKILL.md · MIT
---
name: review-loop
description: Run the adversarial verification loop — implement, then hand the change to a fresh checker that did not write it, fix what it finds, and re-dispatch until APPROVE. Use before claiming any behavioural change is done, and on requests like "review loop", "adversarial review", "independent review", "get this verified", "is this actually done", "maker checker", "second pair of eyes on this change". Not for prose, docs or typo edits.
---

# review-loop — the independent adversarial loop

> Nobody grades their own exam. The maker implements, a separate fresh checker tries to break the
> claim, and the two alternate until the checker approves the code as it stands right now.

## When this applies

Any change to behaviour: executable code, shell/Python/JS/TS/SQL, CI/CD, hooks, commands, agent
and skill definitions, runtime prompts, and configuration that changes what the system does.

Exempt: prose documentation, marketing copy, typos, and formatting that cannot change behaviour.
When a documentation-only change also touches something a runtime reads, it is behavioural. If you
are unsure which side a change falls on, treat it as behavioural.

File count and diff size are not exemptions. A one-line change to an authorization check is
behavioural; a 900-line documentation reflow is not.

| Risk | Lanes required |
|---|---|
| Ordinary behavioural change | 1 independent checker |
| Auth, authorization, payments, access-control rules, secrets, destructive data changes, irreversible deploys | 2 lanes, run by different checkers: correctness plus the risk-specific angle (runtime security, or rollback) |

## The loop

```text
maker implements → targeted test / real-surface QA → fresh checker
     ↑                                                    │
     └────────── REQUEST_CHANGES ← findings ──────────────┘
                                                          │
                                          APPROVE on current code → done
```

There are exactly three verdicts: `APPROVE`, `REQUEST_CHANGES`, `UNVERIFIED`.

- **APPROVE** is a completion candidate only when it was issued against the revision that is
  checked out now, with evidence produced from that same revision.
- **REQUEST_CHANGES** means the maker fixes the findings surgically, re-runs the tests, and calls
  a fresh checker again. Fixing more than the findings restarts the argument.
- **UNVERIFIED** means no judgement was reached: the checker never ran, returned empty, timed out,
  errored, was rate-limited, returned a malformed envelope, or reviewed a state that has since
  moved. It is not a pass. Retry with a different checker, runtime, or strategy.

If a checker modifies the source, it has joined the maker set and its verdict is void. A past maker
can never be that change's checker.

## Running it

1. **Implement.** Keep the change inside the scope you declared. Unrelated cleanup that arrives in
   the same diff will be reviewed as part of it.

2. **Produce evidence before dispatch.** Run the targeted tests and, when the change has a surface a
   person uses, exercise that surface the way they would. Record the exact commands and their exit
   status. Evidence from before your last edit is stale.

3. **Dispatch a fresh checker.** Use the Task/Agent tool to spawn `adversarial-reviewer` in its own
   context, or a general-purpose agent given that agent's contract. Hand it:
   - the goal and acceptance criteria in one paragraph,
   - the scope (paths, or the diff range),
   - the commands you ran and what they returned,
   - the revision under review (`git rev-parse HEAD`).

   Do not hand it your conclusion. "I verified this works" is the claim under test, not context.

4. **Read the verdict, not the tone.** A checker that praises the change but lists a HIGH finding
   has returned REQUEST_CHANGES. A checker that died mid-run has returned UNVERIFIED, however
   encouraging its last message was.

5. **Fix and re-dispatch.** Every round gets a checker with a fresh context. Reusing the previous
   checker means asking someone to re-read their own conclusion.

6. **Stop when a current APPROVE exists** for the code as it stands, backed by evidence from that
   same revision.

## Re-verification etiquette

When you come back for round N+1, say so plainly:

- state what changed since the last round, in one or two lines, and name the finding each edit
  addresses;
- ask the checker to re-reproduce the original defect, not to take your word that it is gone;
- explicitly invite it to attack the fix itself. Fixes introduce their own defects, and a fix
  written under review pressure is exactly where a second one hides.

Both of the defects worked through in `docs/VERIFICATION-LOOP.md` were found this way: the first
review broke the guard, and the review of the *fix* broke the fix.

## When rounds stop converging

Three rounds on the same strategy is not a reason to stop, and it is not a reason to keep going
unchanged. Switch strategy: a different reproduction, a narrower test, a different checker or
runtime, or a re-plan of the approach. See `references/convergence-detection.md`.

Escalate to the human when the same finding comes back REQUEST_CHANGES twice in a row: two failed
attempts at one defect means the diagnosis is wrong, and a third attempt usually makes it worse.
Report the finding, both attempted fixes, and the reproduction. See `rules/adversarial-review.md`.

## Never report success when

- the reviewed revision is not the revision that is checked out now;
- there is no successful evidence from after the last edit;
- the checker was the maker, or a fork of the maker's context;
- a required lane is missing;
- the checker modified code, returned an empty or malformed verdict, or timed out;
- you are reusing an APPROVE from a different change or a different session.

In every one of those cases the honest report is what is missing, not "done".

© sangrokjung · MIT · sangrokjung/claude-forge

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →

Сначала — review-loop от других авторов.

review-loop 2dmurali Скилл review-loop запускает цикл «работа — критика — правка»: отдельный субагент оценивает результат по шкале 1–10 и возвращает замечания, пока не наберётся нужный балл. CX Codex +1 114 900установок verification-loop affaan-m Скилл verification-loop проводит код через сборку, проверки типов, линтер, тесты, поиск секретов и просмотр diff. Запускайте его после изменений или перед созданием PR. CX Codex +1 7 200установок adversarial-review syahiidkamil Скилл adversarial-review запускает враждебную проверку свежего кода через изолированных субагентов и требует обязательного воспроизведения каждой ошибки на работающем приложении. CX Codex +1 ★ 406звёзд репо codebase-review-swarm ZaxbyHub Скилл codebase-review-swarm для Claude Code запускает аудит репозитория с опорой на цитаты кода. Проверяет безопасность, QA, доступность и AI-мусор без изменения файлов проекта. CX Codex +1 ★ 539звёзд репо build-loop-claude-code BuilderOS Скилл build-loop-claude-code гоняет каждую задачу по кругу: собрать, проверить ревью, протестировать вживую, починить. Пока в плане остаются незакрытые пункты, цикл не останавливается. CX Codex +1 1 700установок ai-qa-review kindlmann Скилл ai-qa-review разбирает существующие тесты на запахи и проверяет тестируемость кода приложения. Пригодится перед ревью PR или когда непонятно, почему тесты зелёные, а баги всё равно проходят. CX Codex +1 1 500установок test-evidence-review Donchitos Скилл test-evidence-review для Claude Code, Codex, Cursor и других платформ проверяет не факт существования тестов, а их содержательное покрытие. Для каждой истории выносит вердикт: ADEQUATE, INCOMPLETE, MISSING или NOT ASSESSED. CX Codex +1 632установок

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

Весь набор →
systematic-debugger Субагент systematic-debugger для Claude Code разбирает воспроизводимые баги: проверяет падающий тест, ищет сломавший коммит, тестирует гипотезы и фикс. CX Codex ★ 880звёзд репо humanize-korean Скилл humanize-korean правит переводные обороты и шаблонные фразы ИИ в готовом корейском тексте, сохраняя факты, числа, имена и цитаты. Работает за один проход. CX Codex +1 ★ 880звёзд репо workflow-classify Команда workflow-classify оценивает задачу по шкале S/M/L/XL и предлагает рабочий процесс. Запустите её до начала работы, чтобы выбрать подходящий объём планирования и проверок. CX Codex +1 ★ 880звёзд репо build-error-resolver Субагент build-error-resolver доводит упавшую сборку до зелёного состояния минимальными правками: типы, компиляция, импорты, зависимости. Рефакторинг и смена архитектуры исключены. CX Codex ★ 880звёзд репо adversarial-review Правило adversarial-review требует независимой проверки изменений поведения и задаёт три вердикта. Оно пригодится, чтобы не считать сбой проверяющего одобрением. CX Codex +1 ★ 880звёзд репо relay Скилл relay собирает однострочную команду для /compact и документ-«эстафету» с задачей для следующей сессии, чтобы работа не прерывалась при нехватке контекста. CX Codex +1 ★ 880звёзд репо adversarial-reviewer Субагент adversarial-reviewer для Claude Code проверяет изменения поведения перед закрытием задачи: воспроизводит дефекты и выносит вердикт, не меняя файлы репозитория. CX Codex ★ 880звёзд репо rca-debugger Субагент rca-debugger разбирает сложные сбои, когда обычная отладка не нашла причину: например, при нестабильной ошибке или расхождении CI и локального запуска. CX Codex ★ 880звёзд репо

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

Компании, которые помогают держать аналитику открытой