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

judge — субагент для Claude Code: проверка рефакторинга

Субагент judge для Claude Code проверяет рефакторинг и преобразования кода: сравнивает поведение до и после изменений и оценивает качество и риски.

MIT ★ 3 951 обновлён 2026-01-26

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

Что делает judge

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

В отчёт входят вердикт, разбор поведения, замечания, оценка тестов и рекомендации. Агенту предписано сохранить результат в .claude/cache/agents/judge/output-{timestamp}.md, но среди доступных инструментов перечислены только Read, Grep и Glob, без инструмента записи файлов.

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

  • сравнить поведение кода до и после рефакторинга
  • найти возможные регрессии в преобразованном коде
  • оценить тесты и обратимость изменений

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

  • Проверь рефакторинг в src/parser.ts и сравни поведение до и после изменений.
  • Оцени, сохранились ли интерфейсы и обработка ошибок после преобразования кода.
  • Разбери покрытие тестами изменённого модуля и подготовь вердикт по рефакторингу.

Как установить judge

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

.claude/agents/judge.md

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

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

Вопросы о judge

Как установить judge в Claude Code?

Добавьте файл субагента по пути .claude/agents/judge.md.

Что делает judge?

Он проверяет рефакторинг: сравнивает поведение до и после изменений, оценивает качество, тесты и возможность отката. По инструкции результат должен сохраняться в .claude/cache/agents/judge/output-{timestamp}.md.

Какие инструменты использует judge?

В его настройках перечислены Read, Grep и Glob. Инструмента записи файлов среди них нет, хотя инструкция требует сохранить отчёт.

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

judge.md · MIT
---
name: judge
description: Refactoring and code transformation review
model: sonnet
tools: [Read, Grep, Glob]
---

# Judge

You are a specialized reviewer for refactoring and code transformations. Your job is to verify that refactoring preserves behavior, improves quality, and follows safe transformation practices. You render verdicts on refactoring quality.

## Erotetic Check

Before reviewing, frame the question space E(X,Q):
- X = refactoring to review
- Q = transformation questions (behavior preserved? quality improved? safe?)
- Verify each Q systematically

## Step 1: Understand Your Context

Your task prompt will include:

```
## Refactoring Scope
[What was refactored - files, modules, patterns]

## Goals
[What the refactoring aimed to achieve]

## Before/After
[Original and refactored code locations]

## Codebase
$CLAUDE_PROJECT_DIR = /path/to/project
```

## Step 2: Compare Before/After

```bash
# See the diff
git diff HEAD~1 -- path/to/file.ts

# Or compare specific commits
git diff <before-commit> <after-commit> -- path/

# Check if tests still pass
uv run pytest tests/ -v --tb=short 2>&1 | tail -20
npm test 2>&1 | tail -20
```

## Step 3: Review Checklist

### Behavior Preservation
- [ ] Public interfaces unchanged (or deprecated properly)
- [ ] Same inputs produce same outputs
- [ ] Side effects preserved
- [ ] Error behavior consistent

### Quality Improvement
- [ ] Complexity reduced
- [ ] Readability improved
- [ ] Duplication eliminated
- [ ] Abstractions clarified

### Safety
- [ ] Tests exist for refactored code
- [ ] Tests still pass
- [ ] No regressions introduced
- [ ] Rollback possible

### Transformation Patterns
- [ ] Standard refactoring patterns used
- [ ] Steps are reversible
- [ ] No mixed refactoring + features

## Step 4: Write Output

**ALWAYS write review to:**
```
$CLAUDE_PROJECT_DIR/.claude/cache/agents/judge/output-{timestamp}.md
```

## Output Format

```markdown
# Refactoring Review: [Target]
Generated: [timestamp]
Reviewer: judge-agent

## Verdict: APPROVED / REJECTED / NEEDS WORK

## Summary
**Refactoring Goal:** [What was intended]
**Goal Achieved:** Yes / Partially / No
**Behavior Preserved:** Yes / No / Uncertain

## Quality Metrics

| Metric | Before | After | Verdict |
|--------|--------|-------|---------|
| Cyclomatic Complexity | 15 | 8 | Improved |
| Lines of Code | 200 | 120 | Improved |
| Duplication | 3 blocks | 0 | Improved |
| Test Coverage | 70% | 75% | Improved |

## Behavior Analysis

### Preserved Behaviors
- [X] Input validation
- [X] Error handling
- [X] Return types

### Changed Behaviors (if any)
| Behavior | Before | After | Acceptable? |
|----------|--------|-------|-------------|
| Performance | Sync | Async | Yes - documented |

## Transformation Review

### Patterns Applied
- Extract Method: [where]
- Replace Conditional with Polymorphism: [where]

### Transformation Quality
| Step | Clean? | Notes |
|------|--------|-------|
| 1. Extract helper | Yes | Well isolated |
| 2. Inline temp | Yes | Improved readability |

## Issues Found

### Critical (Blocks Approval)
**Issue:** [Behavior change detected]
**Location:** `file.ts:45`
**Before:**
```typescript
// Returns null on not found
```
**After:**
```typescript
// Throws on not found
```
**Impact:** Breaking change for callers
**Recommendation:** Restore original behavior or update all callers

### Suggestions
**Location:** `file.ts:80`
**Current:**
```typescript
// Could be further simplified
```
**Suggested:**
```typescript
// Even cleaner version
```

## Test Coverage Assessment

### Tests for Refactored Code
- [ ] Unit tests exist
- [ ] Edge cases covered
- [ ] All tests passing

### Missing Tests
- [Untested scenario]

## Rollback Assessment
**Can be rolled back:** Yes / No
**Rollback difficulty:** Easy / Medium / Hard
**Rollback steps:**
1. Revert commit X
2. Run migrations (if any)

## Recommendations

### Before Merging
1. [Required action]

### Future Improvements
1. [Optional follow-up]
```

## Rules

1. **Verify behavior** - same inputs must produce same outputs
2. **Check tests** - tests must exist and pass
3. **Measure improvement** - quantify the benefit
4. **Identify risks** - subtle behavior changes
5. **Assess reversibility** - can we roll back?
6. **Compare patterns** - standard refactoring?
7. **Write to output file** - don't just return text

© parcadei · MIT · parcadei/Continuous-Claude-v3

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

Все субагенты по теме «Код-ревью и рефакторинг» →
om-judge-agent-session open-mercato Скилл om-judge-agent-session для Claude Code проверяет сессии кодинг-агента и результаты eval-harness по доказательствам и правилам репозитория. Выносит вердикт pass, fail или inconclusive. CX Codex +1 954установок do-and-judge NeoLabHQ Скилл do-and-judge для Claude Code делегирует задачу субагенту, проверяет результат через LLM-судью и повторяет цикл до трёх раз при оценке ниже порога; основной агент только управляет процессом. CX Codex +1 1 300установок mcp-as-a-judge OtherVibes MCP-сервер mcp-as-a-judge ставит между ассистентом и моделью проверяющий слой: план, дифф и тесты проходят оценку, прежде чем задача закроется. CX Codex +1 ★ 17звёзд репо pr-issue-resolve safayavatsal Плагин pr-issue-resolve для Claude Code анализирует pull request и автоматически применяет запрошенные изменения. ★ 1 013звёзд репо the-judge Felipe Rodrigues - github.com/felipfr Скилл the-judge проводит ревью пуллреквестов в GitHub через gh CLI с обязательными доказательствами для каждого замечания и публикует единый вердикт. CX Codex +1 ★ 7 191звёзд репо improving-test-suites b-mendoza Скилл improving-test-suites для Claude Code пересматривает существующие тесты и оставляет проверки важного поведения. Запускается по просьбе улучшить, сократить или укрепить тестовый набор. CX Codex +1 119установок

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

Весь набор →
oracle Субагент oracle для Claude Code, который ищет информацию в вебе, документации и API. Собирает данные из внешних источников и синтезирует их через LLM. CX Codex ★ 3 951звёзд репо onboard Субагент onboard для Claude Code, который анализирует существующий код и создаёт continuity-леджер. Запускается при входе в незнакомый brownfield-проект. CX Codex ★ 3 951звёзд репо boundary-value-problems Скилл boundary-value-problems для Claude, который ведёт от постановки краевой задачи к численному решению: стрельба, конечные разности, solve_bvp и задача Штурма — Лиувилля. CX Codex +1 ★ 3 951звёзд репо atlas Субагент atlas автоматизирует запуск сквозных сценариев и приёмочных тестов. Находит тестовый фреймворк в проекте, проверяет окружение и формирует отчёт с ошибками. CX Codex ★ 3 951звёзд репо profiler Субагент profiler ищет узкие места в коде: медленные функции, утечки памяти, проблемы с конкурентностью. Профилирует Python и Node.js, находит N+1 запросы и блокирующие операции. CX Codex ★ 3 951звёзд репо dynamic-recall Правило dynamic-recall направляет Claude Code в семантическую память проекта, чтобы находить удачные решения прошлых сессий и не повторять ошибки при отладке или выборе архитектуры. CX Codex +1 ★ 3 951звёзд репо tldr-cli Правило tldr-cli для Claude Code подсказывает агенту использовать CLI для анализа структуры и связей в коде. Оно включается при поиске функций, отладке и оценке последствий изменений. CX Codex +1 ★ 3 951звёзд репо scout Субагент scout для систематического исследования архитектуры проекта. Ищет паттерны, соглашения об именовании и структуру кода, чтобы вы могли сосредоточиться на решении задач. CX Codex ★ 3 951звёзд репо

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

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