Запрос код-ревью

Отдаёт законченную работу свежему субагенту-ревьюеру по шаблону: диапазон коммитов, план или требования, замечания по важности и вердикт о мерже. Для случаев, когда закончена задача или фича и впереди мерж в main.

Код-ревьюПак: Superpowers95 строкrequesting-code-review
Автор
Источник
obra/superpowers/skills/requesting-code-review @ 22f0b46
Лицензия
MIT · Copyright (c) 2025 Jesse Vincent

Об этом скилле

Что делает

Скилл заставляет агента отдавать готовую работу отдельному субагенту-ревьюеру, а не проверять собственный diff. Агент заполняет шаблон промпта — диапазон коммитов (SHA начала и конца), что сделано и какой план или требования — и запускает субагента general-purpose. Историю сессии ревьюер не видит, поэтому оценивает код, а не ход мысли автора. Замечания Critical исправляются сразу, Important — до следующего шага, Minor откладываются, а с неверным замечанием агент спорит по существу.

Шаблон лежит в папке как code-reviewer.md. По нему ревьюер проверяет соответствие плану, качество кода, архитектуру, тесты и готовность к проду; считает требованием то, чего ждал бы разумный пользователь, даже если спецификация молчит; перечисляет всё, что отложил как выходящее за рамки задачи; ничего не меняет в рабочей копии. В конце — вердикт: готово к мержу — да, нет или после правок.

Когда включать и когда не надо

По скиллу ревью обязательно после каждой задачи при разработке через субагентов, после крупной фичи и перед мержем в main. Желательно — когда агент застрял, перед рефакторингом и после запутанного бага.

Нужен агент, который умеет запускать субагентов, и закоммиченная работа: шаблон смотрит диапазон SHA, а не незакоммиченные правки. Ещё скилл запрещает пропускать ревью, потому что правка «простая», — если мелочь должна проходить без ревьюера, по умолчанию его лучше не ставить.

Как поставить и вызвать

Команда установки ниже кладёт всю папку: SKILL.md, code-reviewer.md и лицензию. Агент сам подхватывает скилл по описанию, когда заканчивает задачу или фичу. Вызвать вручную:

  • Claude Code: /requesting-code-review или попросить скилл по имени.
  • Codex: $requesting-code-review.
  • Cursor: наберите / в чате Agent и выберите requesting-code-review.

Пример: /requesting-code-review Ограничитель запросов закоммичен. Отревьюй всё от origin/main по требованиям из задачи 42.

Тот же шаблон проводит итоговое ревью всей ветки в executing-plans и subagent-driven-development, так что ставьте скилл вместе с ними; обратную сторону ревью закрывает receiving-code-review.

Чем отличается от похожих

Ревью пул-реквеста из нашего каталога делает ревьюером самого агента и сообщает только о багах, для которых есть сценарий падения. Requesting code review — про сторону автора: подготовить контекст, отдать его свежему субагенту и разобрать вердикт. Самопроверка перед PR — это автор, читающий свой diff, а этот скилл такого как раз избегает: ревью в основной сессии съедает контекст агента-координатора. Разработка через сомнение тоже отдаёт работу субагенту со свежим контекстом, но по каждому нетривиальному решению, пока работа ещё идёт, и с заданием найти, что не так. Ревью по стандартам и спецификации запускает параллельно двух свежих субагентов — по записанным стандартам репозитория и по спецификации — и не смешивает их отчёты. Безопасности в шаблоне отведена одна строка, поэтому для кода, который принимает ввод, работает с авторизацией или платежами, добавьте Ревью безопасности.

Установка

Выполните одну команду — она сохранит SKILL.md и файлы, которые он использует, в папку скиллов агента. Claude Code и Codex подхватывают новый скилл без перезапуска; если скилл не появился, перезапустите агента.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Claude Code — macOS, Linux
curl -fsSL --create-dirs -o ~/.claude/skills/requesting-code-review/SKILL.md https://anymodel.org/en/skills/superpowers/requesting-code-review/SKILL.md -o ~/.claude/skills/requesting-code-review/LICENSE https://anymodel.org/en/skills/superpowers/requesting-code-review/LICENSE -o ~/.claude/skills/requesting-code-review/code-reviewer.md https://anymodel.org/en/skills/superpowers/requesting-code-review/code-reviewer.md
Codex, Cursor — macOS, Linux
curl -fsSL --create-dirs -o ~/.agents/skills/requesting-code-review/SKILL.md https://anymodel.org/en/skills/superpowers/requesting-code-review/SKILL.md -o ~/.agents/skills/requesting-code-review/LICENSE https://anymodel.org/en/skills/superpowers/requesting-code-review/LICENSE -o ~/.agents/skills/requesting-code-review/code-reviewer.md https://anymodel.org/en/skills/superpowers/requesting-code-review/code-reviewer.md
Claude Code — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','code-reviewer.md') { $p = Join-Path "$HOME\.claude\skills\requesting-code-review" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/superpowers/requesting-code-review/$f" -UseBasicParsing -OutFile $p }
Codex, Cursor — Windows PowerShell
foreach ($f in 'SKILL.md','LICENSE','code-reviewer.md') { $p = Join-Path "$HOME\.agents\skills\requesting-code-review" $f; New-Item -ItemType Directory -Force (Split-Path $p) | Out-Null; Invoke-WebRequest "https://anymodel.org/en/skills/superpowers/requesting-code-review/$f" -UseBasicParsing -OutFile $p }

Другой агент: сохраните файл в его папку скиллов или дайте ему ссылку на файл: https://anymodel.org/en/skills/superpowers/requesting-code-review/SKILL.md

SKILL.md

Исходник

Requesting Code Review

Dispatch a code reviewer subagent to catch issues before they cascade. The reviewer gets precisely crafted context for evaluation — never your session's history.

Core principle: Review early, review often.

When to Request Review

Mandatory:

  • After each task in subagent-driven development
  • After completing major feature
  • Before merge to main

Optional but valuable:

  • When stuck (fresh perspective)
  • Before refactoring (baseline check)
  • After fixing complex bug

How to Request

1. Get git SHAs:

BASE_SHA=$(git rev-parse HEAD~1)  # or: git merge-base origin/main HEAD
HEAD_SHA=$(git rev-parse HEAD)

2. Dispatch code reviewer subagent:

Dispatch a general-purpose subagent, filling the template at code-reviewer.md

Placeholders:

  • {DESCRIPTION} - Brief summary of what you built
  • {PLAN_OR_REQUIREMENTS} - What it should do
  • {BASE_SHA} - Starting commit
  • {HEAD_SHA} - Ending commit

3. Act on feedback:

  • Fix Critical issues immediately
  • Fix Important issues before proceeding
  • Note Minor issues for later
  • Push back if reviewer is wrong (with reasoning)

Example

[Just completed Task 2: Add verification function]

You: Let me request code review before proceeding.

BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | cut -d' ' -f1)
HEAD_SHA=$(git rev-parse HEAD)

[Dispatch code reviewer subagent]
  DESCRIPTION: Added verifyIndex() and repairIndex() with 4 issue types
  PLAN_OR_REQUIREMENTS: Task 2 from docs/superpowers/plans/deployment-plan.md
  BASE_SHA: a7981ec
  HEAD_SHA: 3df7661

[Subagent returns]:
  Strengths: Clean architecture, real tests
  Issues:
    Important: Missing progress indicators
    Minor: Magic number (100) for reporting interval
  Assessment: Ready to proceed

You: [Fix progress indicators]
[Continue to Task 3]

Common Rationalizations

Excuse Reality
"I'll just review the diff myself instead of dispatching a reviewer" You're the coordinator — reviewing the diff inline burns the context window you need to keep driving the work. Dispatch a reviewer subagent: the diff and the evaluation live in its context, and only the findings come back to you.
"The reviewer needs my whole session history to understand the change" Hand it precisely crafted context, never your session's history. That keeps the reviewer on the work product, not your thought process.

Red Flags

Never:

  • Skip review because "it's simple"
  • Ignore Critical issues
  • Proceed with unfixed Important issues
  • Argue with valid technical feedback

If reviewer wrong:

  • Push back with technical reasoning
  • Show code/tests that prove it works
  • Request clarification

See template at: code-reviewer.md

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Superpowers

Брейншторм перед работой

Выясняет, что и зачем вы хотите построить: вопросы по одному, пересказ по частям, два-три способа на выбор и дизайн-документ, без одобрения которого код не пишется. Для новых фич и изменений, когда запрос оставляет главное открытым.

Параллельные субагенты

Раздаёт независимые задачи параллельным субагентам: каждому — одна область и самодостаточное задание с рамками и форматом отчёта, потом сверяет правки на конфликты и гоняет все тесты. Для случаев, когда упало сразу несколько несвязанных мест.

Выполнение плана по шагам

Выполняет план из writing-plans в текущей сессии без субагента на каждую задачу: задачи подряд через TDD, журнал прогресса и спорных решений на случай сжатия контекста, одно свежее ревью всей ветки в конце. Для случаев, когда ревью каждой задачи не нужно или субагентов нет.

Завершение ветки разработки

Завершает ветку: прогоняет тесты, предлагает слить локально, открыть PR или оставить как есть, после слияния снова проверяет тесты и убирает свой worktree, а работу удаляет только после «discard». Для случаев, когда реализация готова.

Как принимать код-ревью

Сверяет каждое замечание ревьюера с кодом до правок, сначала выясняет всё неясное, возражает с доводами и не изображает согласие. Для случаев, когда нужно отработать ревью без слепых правок.

Разработка через субагентов

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

Системная отладка

Не даёт агенту чинить наугад: сначала воспроизвести баг и найти первопричину, проверять по одной гипотезе, исправлять с падающим тестом, а после трёх неудачных правок пересмотреть устройство кода. Для любых багов, падений тестов и странного поведения.

TDD по методу Superpowers

Ведёт работу тестом вперёд: сначала тест и его падение, потом минимум кода и прогон всего набора; код, написанный до теста, удаляется. Для фич и багфиксов, когда агент норовит дописать тесты после кода.

Работа в git worktree

Выносит работу над фичей в отдельный git worktree: проверяет, не изолирован ли агент уже, предпочитает родной инструмент среды, следит за .gitignore, ставит зависимости и прогоняет тесты на старте. Для случаев, когда работа не должна попасть в текущую ветку.

Проверка перед словом «готово»

Не даёт агенту сказать «готово» или «тесты проходят», пока он заново не запустил проверку и не прочитал вывод целиком. Для случаев, когда агент докладывает об успехе, коммитит или открывает PR.

План реализации перед кодом

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

Как писать скиллы

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