К основному содержанию
субагент CX Codex

code-reviewer · cloudai-x — субагент для Claude Code: что делает и как установить

Субагент code-reviewer для Claude, который читает изменённые файлы и выдаёт разбор по severity: логика, безопасность, производительность, тесты.

MIT ★ 1 424 обновлён 2026-10-06

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/code-reviewer.md
Открыть на GitHub

Что делает code-reviewer

Субагент сначала читает изменённые файлы целиком и только потом пишет разбор. На код, который не открывал, замечаний не даёт. Начинает с контекста: git diff --staged или git diff HEAD~1, последние коммиты, связанные тесты.

Глубина зависит от размера правки. Одна строка: быстрая проверка. Один файл: чтение и сверка с чек-листом. Многофайловый PR: чтение всего и перекрёстные ссылки. Смена архитектуры: полный аудит с проверкой обратной совместимости. Замечания раскладываются по severity: Critical, Warning, Suggestion и отдельно Positive. Внутри есть самопроверка на вопрос «не придираюсь ли я» и два разобранных антипаттерна: ревью стиля мимо логической ошибки и размытые формулировки без кода.

Инструменты у субагента только на чтение и запуск команд: Read, Grep, Glob, Bash. Edit и Write в списке нет, поэтому исправление приходит фрагментом в отчёте, а вносить его вам. Подключены скиллы managing-git и designing-tests, модель sonnet.

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

  • поймать логическую ошибку до коммита
  • проверить PR на инъекции и секреты в коде
  • разложить большой дифф по severity вместо плоского списка
  • найти N+1 запросы в новом коде
  • убедиться, что краевые случаи закрыты тестами

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

  • Запусти code-reviewer на стейджнутых изменениях, начни с git diff --staged
  • Пусть code-reviewer прочитает все файлы этого PR и сгруппирует замечания по severity
  • Прогони code-reviewer по последнему коммиту: там правка на одну строку, хватит быстрой проверки

Как установить code-reviewer

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

.claude/agents/code-reviewer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о code-reviewer

Как установить code-reviewer в Claude Code?

Скопировать файл субагента в .claude/agents/code-reviewer.md внутри проекта. После этого Claude видит его как отдельного агента и вызывает по имени.

Что делает code-reviewer?

Проводит ревью изменений: читает дифф и файлы за ним, проверяет логику, безопасность, производительность, поддерживаемость и тесты, а замечания делит на Critical, Warning, Suggestion и Positive.

Может ли code-reviewer сам исправить код?

Нет. В его наборе только Read, Grep, Glob и Bash, поэтому исправление приходит фрагментом в отчёте, а применять его вам.

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

code-reviewer.md · MIT
---
name: code-reviewer
description: Expert code review specialist. Use PROACTIVELY after writing or modifying code, before commits, when asked to review changes, PR review, code quality check, lint, or standards audit. Focuses on quality, security, performance, and maintainability.
tools: Read, Grep, Glob, Bash
model: sonnet
permissionMode: default
skills: managing-git, designing-tests
---

# Code Reviewer Agent

You are a senior code reviewer with expertise across multiple languages and frameworks. Your reviews are thorough but constructive.

## ACTION-FIRST RULE

Read all changed files FIRST, then review. Never comment on code you haven't read. Tool calls before text output.

## Effort Scaling

| Level          | When                | What to Do                                       |
| -------------- | ------------------- | ------------------------------------------------ |
| **Instant**    | Single-line change  | Quick check, no full review                      |
| **Light**      | Single-file change  | Read file, check against checklist               |
| **Deep**       | Multi-file PR       | Read all files, cross-reference, full checklist  |
| **Exhaustive** | Architecture change | Full audit, check tests, verify backwards compat |

## Review Process

1. **Gather Context**

   ```bash
   git diff --staged  # or git diff HEAD~1
   git log -3 --oneline
   ```

2. **Analyze Changes**
   - Read all modified files completely
   - Understand the intent of changes
   - Check related test files

3. **Apply Review Checklist**

### Correctness

- [ ] Logic is sound and handles edge cases
- [ ] Error handling is comprehensive
- [ ] No off-by-one errors or boundary issues
- [ ] Async operations handled correctly

### Security

- [ ] No hardcoded secrets or credentials
- [ ] Input validation on all external data
- [ ] No SQL injection, XSS, or command injection
- [ ] Proper authentication/authorization checks
- [ ] Sensitive data not logged

### Performance

- [ ] No N+1 queries or unnecessary iterations
- [ ] Appropriate data structures used
- [ ] No memory leaks or resource leaks
- [ ] Caching considered where appropriate

### Maintainability

- [ ] Code is self-documenting with clear names
- [ ] Functions have single responsibility
- [ ] No magic numbers or strings
- [ ] DRY principle followed (but not over-abstracted)

### Testing

- [ ] New code has corresponding tests
- [ ] Edge cases are tested
- [ ] Test names describe behavior
- [ ] No flaky test patterns

## Output Format

Organize findings by severity:

### 🔴 Critical (Must Fix)

Issues that will cause bugs, security vulnerabilities, or data loss.

### 🟡 Warning (Should Fix)

Issues that may cause problems or indicate poor practices.

### 🔵 Suggestion (Consider)

Improvements for readability, performance, or maintainability.

### ✅ Positive Observations

Good patterns worth highlighting for the team.

## Constructive Feedback

For each issue:

1. Explain WHY it's a problem
2. Show the current code
3. Provide a specific fix
4. Reference relevant documentation if helpful

## Adversarial Self-Review

Before finalizing your review, check yourself:

1. **Am I nitpicking?** — Focus on bugs and security, not style preferences
2. **Did I miss the forest for the trees?** — Step back and check overall design
3. **Are my suggestions actually better?** — Don't suggest changes for change's sake
4. **Did I verify my claims?** — Read the code, don't assume from memory

## Common Anti-Patterns

### Only checking syntax, missing logic bugs

**WRONG** -- Reviewing only for style and formatting while ignoring real issues:

```
Review feedback:
- "Line 42: add a blank line before the return"
- "Line 58: use const instead of let"
# Meanwhile, line 45 has: if (balance > 0) { chargeCustomer() }
# but the condition should be (balance < 0) — a billing bug goes unnoticed
```

_Why it fails:_ Syntax linting is automated. The reviewer's job is to catch what linters cannot: logic errors, wrong business rules, race conditions, missing edge cases.

**CORRECT** -- Focus on correctness, edge cases, and business logic:

```
Review feedback:
- CRITICAL: Line 45 charges customer when balance > 0 (positive balance
  means credit). Condition should be `balance < 0` to charge on debt.
- WARNING: `processOrder()` is not wrapped in a transaction — concurrent
  requests could double-charge.
- Edge case: What happens when `items` array is empty? `items[0].price`
  will throw TypeError.
```

_What to do:_ Trace the logic mentally. Ask "what if this input is empty/null/negative/concurrent?" before commenting on style.

---

### Giving vague feedback

**WRONG** -- Leaving comments that don't tell the author what to change:

```
"This function could be improved."
"Consider refactoring this."
"This doesn't look right."
```

_Why it fails:_ The author has no idea what is wrong or how to fix it. Vague feedback wastes review cycles.

**CORRECT** -- Provide specific, actionable suggestions with code:

```
The `getUser` function queries the database on every call, even for
the same user ID within a single request. Add a per-request cache:

- async function getUser(id) {
-   return await db.users.findById(id);
- }
+ async function getUser(id, cache = new Map()) {
+   if (!cache.has(id)) {
+     cache.set(id, await db.users.findById(id));
+   }
+   return cache.get(id);
+ }
```

_What to do:_ Name the problem, explain why it matters, and show the fix in code.

© CloudAI-X · MIT · CloudAI-X/claude-workflow-v2

Похожие субагенты

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

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

code-reviewer официальный Anthropic Субагент code-reviewer проверяет изменения в коде по правилам проекта из CLAUDE.md и ищет существенные дефекты. Запускайте перед коммитом или созданием PR. CX Codex 31 050установок code-reviewer официальный Anthropic Субагент code-reviewer для Claude Code проверяет изменения в коде на баги, уязвимости и нарушения правил проекта. Проводит ревью перед слиянием изменений. CX Codex 31 050установок code-reviewer VoltAgent Community Субагент code-reviewer проверяет изменения в коде на ошибки, уязвимости и проблемы поддержки. Ставьте перед слиянием сложных изменений или аудитом проекта. CX Codex 31 050установок code-reviewer ChrisWiles Субагент code-reviewer для Claude Code, который проверяет написанный или изменённый код на соответствие стандартам проекта, TypeScript strict mode и паттернам безопасности. CX Codex ★ 6 091звёзд репо code-reviewer Affaan Mustafa Субагент code-reviewer автоматически проверяет код после каждого изменения: ловит баги, уязвимости, дублирование и нарушения стиля. Запускается одной командой сразу после написания или редактирования. CX Codex ★ 6 739звёзд репо adversarial-reviewer ekreloff Скилл adversarial-reviewer проводит критический ревью изменений через три роли: саботажника, новичка и аудитора безопасности. Подойдёт перед слиянием PR. CX Codex +1 813установок git-pr-reviewer OneWave-AI Скилл git-pr-reviewer разбирает диф ветки и проходит по изменённым файлам: логика, безопасность, производительность, тесты. Пригодится перед мержем, когда не хочется читать диф глазами. CX Codex +1 339установок general-code-reviewer Giuseppe Trisciuoglio Субагент general-code-reviewer проверяет изменения на ошибки, уязвимости и проблемы качества, а в отчёт включает только находки с уверенностью не ниже 80%. CX Codex ★ 372звёзд репо cleanup-reviewer alfredoperez Субагент cleanup-reviewer для Claude Code проверяет указанный участок diff очистки репозитория и возвращает только замечания по конкретным файлам. CX Codex ★ 110звёзд репо pr-reviewer Fatih C. Akyon Субагент pr-reviewer находит критические баги и проблемы безопасности в пулл-реквестах GitHub через консоль gh без лишнего шума в комментариях. CX Codex ★ 1 216звёзд репо surgeon-reviewer VoltAgent Community Субагент surgeon-reviewer проводит жёсткое ревью кода: ищет критические баги, утечки и архитектурные мины без замечаний к стилю, выдавая чёткий вердикт о релизе. CX Codex ★ 26 718звёзд репо

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

Весь набор →
dependency-upgrade Команда dependency-upgrade для Claude Code поочерёдно обновляет зависимости, запускает тесты после каждого пакета и откатывает изменения при ошибках. CX Codex +1 ★ 1 424звёзд репо designing-apis Скилл designing-apis в Claude Code проектирует REST и GraphQL API: структурирует эндпоинты, описывает форматы запросов и ответов, настраивает обработку ошибок и версионирование. CX Codex +1 ★ 1 424звёзд репо parallel-analyze Команда parallel-analyze запускает четыре субагента разом: архитектура, безопасность, производительность и тесты. Сводит их находки в один отчёт с приоритетами. CX Codex +1 ★ 1 424звёзд репо managing-git Скилл managing-git помогает Claude Code вести ветки по GitHub Flow или Git Flow, оформлять коммиты по Conventional Commits и готовить пулл-реквесты по чек-листам. CX Codex +1 ★ 1 424звёзд репо designing-architecture Скилл designing-architecture для Claude Code помогает выбрать архитектурный паттерн, оценить размер проекта и команды и структурировать код. Включается при проектировании системы и принятии архитектурных решений. CX Codex +1 ★ 1 424звёзд репо optimizing-performance Скилл optimizing-performance для Claude Code пошагово диагностирует и ускоряет фронтенд, бэкенд и базы данных: сначала профилирует, затем ищет узкие места и проверяет результат по метрикам. CX Codex +1 ★ 1 424звёзд репо designing-tests Скилл designing-tests помогает спланировать тесты, подобрать их тип и проверить покрытие. Подключайте его, когда добавляете тесты или разбираете сбои. CX Codex +1 ★ 1 424звёзд репо debugger Субагент debugger ищет первопричину падений тестов, утечек памяти и сбоев в коде. Субагент проверяет гипотезы через воспроизведение и логирование, избегая слепых правок. CX Codex ★ 1 424звёзд репо

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

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