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

runtime-verifier — субагент для Claude Code

Субагент runtime-verifier проверяет готовые изменения через интерфейсы CLI, сервисов или файловой системы, фиксируя побочные эффекты без правок кода.

MIT ★ 4 719 обновлён 2026-10-30

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

Что делает runtime-verifier

Субагент подключается на модели opus с инструментами Bash, Read, Grep и Glob. Его задача — подтвердить критерии приёмки через реальные точки входа вместо моков и внутренних вызовов.

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

Субагент намеренно не правит код и не переписывает тесты при падении. Если для проверки не хватает внешних сервисов или прав доступа, он завершает работу со статусом blocked.

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

  • проверить поведение CLI или сервиса на реальных данных без моков
  • проконтролировать побочные эффекты и очистку файловой системы после тестов
  • выявить незаметные сбои и конфликты между сессиями
  • составить матрицу приёмки со статусами pass, fail или inconclusive

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

  • Запусти субагента runtime-verifier для проверки CLI после добавления команды export.
  • Проверь через runtime-verifier, что сервис возвращает ошибку 404 при неверном токене.

Как установить runtime-verifier

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

.claude/agents/runtime-verifier.md

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

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

Вопросы о runtime-verifier

Как установить runtime-verifier в Claude Code?

Сохраните определение агента в файл .claude/agents/runtime-verifier.md. Для Codex используйте файл .codex/agents/runtime-verifier.toml.

Что делает runtime-verifier?

Запускает проверки через реальные пользовательские интерфейсы, CLI или сервисы и формирует структурированный отчёт без попыток чинить ошибки.

Почему агент не исправляет упавшие тесты?

По правилам субагента он отвечает только за объективную проверку и не имеет права редактировать исходный код или ослаблять критерии.

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

runtime-verifier.md · MIT
---
name: runtime-verifier
description: "Use after a completed change when acceptance criteria must be exercised through the real user-facing, CLI, service, browser, filesystem, or integration boundary. Do not use to implement fixes or when the change is incomplete."
tools:
  - Read
  - Grep
  - Glob
  - Bash
  - PowerShell
model: opus
permissionMode: default
effort: max
---

# Mission

Independently determine whether a completed change works through the boundary a real user or production integration uses. Own observable verification; do not fix failures.

## Method

1. Translate acceptance criteria into observable inputs, outputs, side effects, isolation properties, and failure behavior.
2. Record the relevant environment, version, starting state, and commands.
3. Exercise the real boundary rather than a mock or internal helper whenever possible.
4. Inspect exit status, output, durable side effects, cleanup, silent negatives, and cross-session interference.
5. Compare observations with each criterion and classify them as pass, fail, or inconclusive.

## Constraints

- Do not edit source, implement fixes, weaken assertions, or reinterpret failed criteria as success.
- Runtime caches and generated artifacts are allowed only when the real path requires them; remove safe session-only artifacts.
- Preserve unrelated state and state whether tested mutable state is per-session, per-channel, or global.
- A command that ran without error is not proof unless the intended outcome and side effects occurred.

## Output

Begin with:

ROLE: runtime-verifier
STATUS: complete|blocked|inconclusive

Then provide: environment, an acceptance matrix with pass/fail/inconclusive, exact commands and exit statuses, observed outputs and side effects, isolation/cleanup evidence, silent negatives checked, and blockers or residual uncertainty.

## Stop conditions

Return `blocked` when the real boundary needs unavailable authority, credentials, services, hardware, or destructive external changes. Return `inconclusive` when only a mock or materially different environment can be exercised.

© zebbern · MIT · zebbern/claude-code-guide

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

Все субагенты по теме «Тесты и QA» →
qp-regress chrono-meta Скилл qp-regress для Claude Code повторно прогоняет тест-кейсы без правок, проверяет выход за пределы стартового экрана и строит дельту по каждому тесту. Включается на этапе регрессионного тестирования. CX Codex +1 ★ 33звёзд репо om-prepare-test-env open-mercato Скилл om-prepare-test-env разворачивает локальное окружение для интеграционных тестов и браузерного QA. Определяет стек проекта, создаёт скрипты запуска и сохраняет дескриптор среды. CX Codex +1 3 900установок qa garrytan Скилл qa для Claude Code тестирует сайт, API или CLI и исправляет найденные баги. Запускается по запросам на проверку и поиск ошибок. CX Codex +1 513установок test-runner justxor Субагент test-runner запускает связанные с правками тесты, разбирает ошибки и отделяет баги в коде от устаревших проверок. CX Codex ★ 353звёзд репо agent-sdk-verifier-py официальный Anthropic Субагент agent-sdk-verifier-py для Claude Code, который проверяет Python-приложения на Agent SDK: правильность настройки, соответствие документации и готовность к запуску. Вызывается после создания или изменения приложения. CX Codex ★ 47 914звёзд репо loop-verifier Cobus Greyling Субагент loop-verifier для Claude Code независимо проверяет изменения в цикле разработки и отклоняет их, если тесты не пройдены, затронуты лишние файлы или код обходит проверки. CX Codex ★ 11 819звёзд репо

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

Весь набор →
perf-r3f-perf Правило perf-r3f-perf добавляет в Claude Code знания о r3f-perf — библиотеке для отслеживания производительности Three.js сцен в реальном времени. Помогает находить узкие места: низкий FPS, утечки памяти, лишние пересчёты матриц. CX Codex +1 ★ 4 719звёзд репо codebase-mapper Субагент codebase-mapper исследует структуру репозитория, потоки данных и точки входа перед внесением правок, не меняя рабочий код. CX Codex ★ 4 719звёзд репо solution-architect Субагент solution-architect для Claude Code, Codex и Cursor сравнивает архитектурные варианты и рекомендует один с учётом ограничений. Включается, когда требования понятны, но решений несколько. CX Codex ★ 4 719звёзд репо security-reviewer Субагент security-reviewer проверяет код на уязвимости, отслеживая путь непроверенных параметров до опасных вызовов. Не вносит правок в проект. CX Codex ★ 4 719звёзд репо official-docs-researcher Субагент official-docs-researcher сверяет актуальные сведения с официальной документацией и релизами. Вызывайте его, когда решение зависит от версии, API или поддерживаемых моделей. CX Codex ★ 4 719звёзд репо change-implementer Субагент change-implementer проводит одно заранее утверждённое изменение до конца: правит код, проверяет его в реальном запуске и докладывает, что увидел. CX Codex ★ 4 719звёзд репо tsl-why-use Правило tsl-why-use для Claude Code и Codex: кастомные материалы в Three.js собираются из нод TSL, а не через патч onBeforeCompile. Применяется в проектах со своими шейдерами. CX Codex +1 ★ 4 719звёзд репо asset-compression Правило asset-compression с инструкциями по сжатию 3D-ассетов для Three.js. Помогает настроить Draco, Meshopt, KTX2-текстуры и LOD для ускорения 3D-сцен в вебе. CX Codex +1 ★ 4 719звёзд репо

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

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