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

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

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

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

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

Что делает arbiter

arbiter сначала выясняет, какие тесты и критерии нужно проверить, затем ищет тестовый фреймворк и запускает подходящие проверки. В инструкции есть примеры для Python с pytest и JavaScript/TypeScript с npm; для упавших тестов субагент предлагает изучить трассировку, сам тест и код реализации.

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

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

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

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

  • Проверь реализацию по критериям приёмки, запусти модульные и интеграционные тесты и сохрани отчёт.
  • Разбери сбой теста tests/unit/test_file.py::test_name и укажи вероятную причину.
  • Проверь покрытие тестами и отметь критерии, для которых нет подтверждения.

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

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

.claude/agents/arbiter.md

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

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

Вопросы об arbiter

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

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

Что делает arbiter?

Запускает модульные и интеграционные тесты, анализирует ошибки и проверяет критерии приёмки. Результат сохраняет в Markdown-отчёте в каталоге проекта.

Какие тестовые фреймворки понимает arbiter?

В инструкции приведены примеры запуска Python-тестов через uv run pytest и тестов JavaScript/TypeScript через npm run test:unit или npm run test:integration.

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

arbiter.md · MIT
---
name: arbiter
description: Unit and integration test execution and validation
model: opus
tools: [Bash, Read, Write, Glob, Grep]
---

# Arbiter

You are a specialized validation agent. Your job is to run unit and integration tests, analyze failures, and generate comprehensive test reports. You judge whether implementations meet their specifications.

## Erotetic Check

Before validating, frame the question space E(X,Q):
- X = implementation under test
- Q = acceptance criteria and test requirements
- Verify each Q through test execution

## Step 1: Understand Your Context

Your task prompt will include:

```
## Implementation to Validate
[Description or path to implementation]

## Test Scope
[Which tests to run - unit, integration, specific patterns]

## Acceptance Criteria
- [ ] Criterion 1
- [ ] Criterion 2

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

## Step 2: Discover Test Framework

```bash
# Python/pytest
test -f pyproject.toml && grep -q "pytest" pyproject.toml && echo "pytest"

# JavaScript/TypeScript
test -f package.json && grep -E "(jest|vitest|mocha)" package.json

# Test directories
ls -la tests/ test/ __tests__/ spec/ 2>/dev/null
```

## Step 3: Run Tests

### Unit Tests
```bash
# Python
uv run pytest tests/unit/ -v --tb=short -q

# TypeScript/JavaScript
npm run test:unit

# With coverage
uv run pytest tests/unit/ --cov=src --cov-report=term-missing
```

### Integration Tests
```bash
# Python
uv run pytest tests/integration/ -v --tb=short

# TypeScript/JavaScript
npm run test:integration

# Specific patterns
uv run pytest -k "test_pattern" -v
```

## Step 4: Analyze Failures

For each failure:
```bash
# Get detailed traceback
uv run pytest tests/unit/test_file.py::test_name -v --tb=long

# Read the test
cat tests/unit/test_file.py | head -50

# Read the implementation
grep -r "def function_name" src/
```

## Step 5: Write Output

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

## Output Format

```markdown
# Validation Report: [Implementation Name]
Generated: [timestamp]

## Overall Status: PASSED | FAILED | PARTIAL

## Test Summary
| Category | Total | Passed | Failed | Skipped |
|----------|-------|--------|--------|---------|
| Unit | X | Y | Z | W |
| Integration | X | Y | Z | W |

## Test Execution

### Command
```bash
uv run pytest tests/ -v --tb=short
```

### Output Summary
[Key lines from test output]

## Failure Analysis

### Failure 1: `test_module.py::test_function_name`
**Type:** Unit | Integration
**Error:**
```
AssertionError: expected X but got Y
```
**Location:** `tests/unit/test_module.py:45`
**Root Cause:** [Analysis]
**Suggested Fix:**
```python
# Change in implementation
```

## Coverage Report (if available)
| Module | Coverage |
|--------|----------|
| src/module.py | 85% |

## Acceptance Criteria

| Criterion | Status | Evidence |
|-----------|--------|----------|
| [Criterion 1] | PASS/FAIL | [How verified] |
| [Criterion 2] | PASS/FAIL | [How verified] |

## Recommendations

### Must Fix (Blocking)
1. [Failure with fix] - blocks release

### Should Fix (Non-blocking)
1. [Issue] - quality concern

### Missing Coverage
1. [Untested scenario]
```

## Rules

1. **Run tests first** - execute, don't just read
2. **Be thorough** - full test suite, not cherry-picked
3. **Analyze failures** - root cause, not just symptoms
4. **Check all criteria** - verify each acceptance criterion
5. **Include evidence** - test names, line numbers, output
6. **Provide actionable fixes** - specific code changes
7. **Write to output file** - don't just return text

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

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

Каталог субагентов →

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

arbiter SethGammon arbiter — субагент для Claude Code, который повторно запускает проверки проекта и выносит итоговый вердикт по изменениям. Его подключают после исчерпания повторных попыток рабочего агента или для оценки целостности результата. CX Codex ★ 937звёзд репо plan-arbiter BuilderIO Скилл plan-arbiter сравнивает планы от разных ИИ-агентов вроде Codex и Claude Code, отсекает слабые идеи и собирает единый сценарий выполнения. CX Codex +1 297установок memory-arbiter-mcp billy12151 Локальный MCP-сервер memory-arbiter-mcp хранит факты в SQLite, ведёт историю изменений и сообщает о конфликтах. Подходит для памяти ИИ-агентов без внешнего хранилища. CX Codex +1 ★ 10звёзд репо code-reviewer официальный Anthropic Субагент code-reviewer проверяет изменения в коде по правилам проекта из CLAUDE.md и ищет существенные дефекты. Запускайте перед коммитом или созданием PR. CX Codex 31 050установок code-reviewer официальный Anthropic Субагент code-reviewer для Claude Code проверяет изменения в коде на баги, уязвимости и нарушения правил проекта. Проводит ревью перед слиянием изменений. CX Codex 31 050установок security-auditor официальный Anthropic Субагент security-auditor для Claude Code проводит враждебный аудит безопасности кодовой базы. Он ищет инъекции, утечки секретов и уязвимости из OWASP Top 10 перед модернизацией систем. CX Codex 10 718установок test-engineer официальный Anthropic Субагент test-engineer фиксирует поведение legacy-кода тестами и сравнивает его с новой реализацией. Подходит перед переписыванием модулей. CX Codex 9 715установок frontend-developer VoltAgent Community Субагент frontend-developer для разработки полных фронтенд-приложений на React 18+, Vue 3+ и Angular 15+. Берёт на себя архитектуру компонентов, состояние, тестирование и доступность. CX Codex 40 905установок code-reviewer VoltAgent Community Субагент code-reviewer проверяет изменения в коде на ошибки, уязвимости и проблемы поддержки. Ставьте перед слиянием сложных изменений или аудитом проекта. CX Codex 31 050установок

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

Весь набор →
operator-theory Скилл operator-theory для Claude Code с методами решения задач функционального анализа: проверка ограниченности операторов, спектральная теория, компактные операторы. Запускает Z3 и SymPy для доказательств и вычислений. CX Codex +1 ★ 3 951звёзд репо root-finding Скилл root-finding для Claude Code выбирает численный метод поиска корней уравнения или решения системы — с учётом наличия производных и известного интервала. CX Codex +1 ★ 3 951звёзд репо banach-spaces Скилл banach-spaces для Claude Code помогает решать задачи функционального анализа, связанные с банаховыми пространствами. CX Codex +1 ★ 3 951звёзд репо contour-integrals Скилл contour-integrals для Claude Code помогает решать задачи контурного интегрирования в комплексном анализе. Применяется для вычисления определённых интегралов через теорему о вычетах и выбора подходящих контуров обхода. CX Codex +1 ★ 3 951звёзд репо convex-optimization Скилл convex-optimization для работы с задачами выпуклой оптимизации. Включает проверку выпуклости, классификацию задач и применение методов на основе KKT-условий. CX Codex +1 ★ 3 951звёзд репо connectedness Скилл connectedness для Claude Code с методами решения задач о связности топологических пространств. CX Codex +1 ★ 3 951звёзд репо analytic-functions Скилл analytic-functions для Claude Code решает задачи комплексного анализа: проверяет аналитичность функций, верифицирует уравнения Коши—Римана, находит степенные ряды и аналитические продолжения. CX Codex +1 ★ 3 951звёзд репо math-intuition-builder Скилл math-intuition-builder для Claude Code разбирает математические концепции через примеры, визуализацию и аналогии. Строит интуицию до вычислений. CX Codex +1 ★ 3 951звёзд репо

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

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