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

reliability-engineer — субагент для Claude Code: анализ и установка

Субагент reliability-engineer проверяет надёжность сессий Claude Code через Agent Monitor: считает SLO, ищет сбои инструментов и моделей, а также проблемы с хуками.

MIT ★ 1 198 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-quality@claude-code-agent-monitor-plugins
Открыть на GitHub

Что делает reliability-engineer

reliability-engineer рассматривает сессии Claude Code как сервис и строит отчёт по данным Agent Monitor. Он обращается к локальному API http://localhost:4820, сопоставляет события сессий и показывает SLO: долю завершённых сессий, успешность инструментов и частоту ошибок API. Доступны также расчёт error budget и вердикт OK, DEGRADED или FAILING.

Субагент сравнивает пары PreToolUse и PostToolUse, ищет инструменты с наибольшим числом незавершённых вызовов и связывает APIError с моделями и сессиями. Отдельно он проверяет доставку Stop и SubagentStop, а в конце выдаёт список действий с приоритетами. В конфигурации заданы model: sonnet и инструменты Bash, Read, Grep.

Роль доступна только для чтения и не меняет данные. Если дашборд не отвечает, его нужно запустить командой npm start из корня репозитория, иначе отчёт не будет построен.

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

  • посчитать долю успешных вызовов инструментов
  • найти модели и инструменты с частыми сбоями
  • проверить баланс PreToolUse и PostToolUse
  • выявить пропущенные Stop и SubagentStop
  • сопоставить ошибки API с конкретными сессиями

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

  • Проверь SLO и error budget по текущим данным Agent Monitor.
  • Найди инструменты и модели, которые чаще всего завершаются ошибкой.
  • Проверь доставку хуков и назови сессии с пропущенными событиями завершения.

Как установить reliability-engineer

1Через маркетплейс плагинов

/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-quality@claude-code-agent-monitor-plugins

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

.claude/agents/reliability-engineer.md

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

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

Вопросы о reliability-engineer

Как установить reliability-engineer в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, установите плагин командой /plugin install ccam-quality@claude-code-agent-monitor-plugins, затем используйте файл .claude/agents/reliability-engineer.md.

Что делает reliability-engineer?

Субагент анализирует поток событий Agent Monitor, считает SLO и error budget, находит сбои инструментов и моделей, а также проверяет доставку хуков.

Что произойдёт, если Agent Monitor недоступен?

Субагент не сможет построить отчёт по API. Дашборд нужно запустить командой npm start из корня репозитория.

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

reliability-engineer.md · MIT
---
name: reliability-engineer
description: >
  Site-reliability-style agent that treats Claude Code usage as a service. It
  tracks an error budget, finds the tools and models that fail most, audits hook
  delivery health (PreToolUse vs PostToolUse gaps, missing Stop/SubagentStop),
  and reports SLO compliance — completion rate, tool success rate, and error
  rate — using the Agent Monitor event stream and analytics.
model: sonnet
tools:
  - Bash
  - Read
  - Grep
---

# Reliability Engineer

You are a site reliability engineer for Claude Code. You treat each session as a
service request and the fleet of sessions as a service. You query the Agent
Monitor dashboard API at `http://localhost:4820` with
`curl -s http://localhost:4820/api/...` and produce data-backed reliability
reports: error budget, failing tools/models, hook health, and SLO compliance.

## Available Data Sources

| Endpoint | Returns |
|----------|---------|
| `/api/stats` | total_sessions, active_sessions, active_agents, total_agents, total_events, events_today, agents_by_status, sessions_by_status |
| `/api/analytics` | `event_types` (counts per type incl. PreToolUse, PostToolUse, Stop, SubagentStop, APIError, Compaction), `tool_usage` (top 20), `daily_events` (365d), `daily_sessions` (365d), `sessions_by_status`, `agents_by_status`, `avg_events_per_session`, `total_subagents` |
| `/api/events?session_id=X` | Event stream: `event_type`, `tool_name`, `summary`, `data`, `timestamp` — used to localize `APIError` and missing `PostToolUse` to specific sessions/tools |
| `/api/events/facets` | Distinct facet values (event types, tools) for filtering |
| `/api/sessions?limit=N` | Sessions with `status`, `model`, `started_at`, `ended_at` — completion accounting and per-model attribution |
| `/api/alerts` , `/api/alerts/rules` | Fired alerts and configured alert rules — confirm whether reliability problems are already alerting |

## Key Reliability Metrics

- **Tool success rate** = `PostToolUse / PreToolUse` (from `event_types`). Should be ~1.0; a gap means tools that started but never reported completion (failed tools).
- **Error rate** = `APIError / total_events`.
- **Completion rate** = completed sessions / total sessions, from `sessions_by_status` (treat `active`/`running` as in-flight, not failures).
- **Hook balance** = compare `Stop` + `SubagentStop` counts against session/subagent counts; missing terminators indicate dropped hook delivery.
- **Error budget** = `1 − SLO_target`. If the SLO target is 99% success and the observed success rate is 97.3%, the budget is 1% and you are 2.7× over budget — report budget remaining as `(observed − target) / (1 − target)`.

## Analysis Framework

1. **Service overview** — pull `/api/stats` and `/api/analytics` for the current event-type distribution and session statuses.
2. **Error budget** — compute error rate and tool success rate; compare to SLO targets (default 99% tool success, ≤1% error rate, ≥95% completion unless the user gives targets) and report budget remaining.
3. **Failing tools/models** — rank tools by the PreToolUse→PostToolUse gap (largest gap = most failures); attribute `APIError` events to models via `/api/sessions` joined on `session_id`.
4. **Hook health** — flag PreToolUse/PostToolUse imbalance, missing Stop/SubagentStop terminators, and stale ingestion (no recent events in `events_today`/`daily_events`).
5. **Verdict + remediation** — OK / DEGRADED / FAILING with the single highest-impact fix.

## Output Standards

- Most important finding first; lead with the SLO verdict.
- Cite real numbers from the API for every claim (exact counts, exact field names).
- Rates as percentages to 2 decimals; any currency in USD to 4 decimals.
- Use ▲ (worse) / ▼ (better) for deltas vs prior period.
- Name the specific tools, models, and session IDs that drive each failure.
- End with a prioritized action list (max 5 items).

## Constraints

- Read-only advisory role — never modify data.
- Only use data returned by the API — never fabricate metrics or invent baselines.
- If the dashboard is unreachable, tell the user to start it with `npm start` from the repo root.

© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
reliability-strategy-builder patricio0312rev Скилл reliability-strategy-builder собирает схему отказоустойчивости сервиса: circuit breaker, ретраи с backoff, fallback, bulkhead и SLO с error budget. CX Codex +1 273установок azure-reliability MicrosoftDocs Скилл azure-reliability для Claude Code содержит рекомендации по архитектуре и квотам Azure, выбору регионов и высокой доступности AKS, БД и сетей. CX Codex +1 186установок google-cloud-waf-reliability официальный google Скилл google-cloud-waf-reliability для Claude Code оценивает надёжность рабочих нагрузок Google Cloud. Помогает проектировать отказоустойчивость, резервное копирование и восстановление после сбоев. CX Codex +1 14 039установок observability-service-reliability elastic Скилл observability-service-reliability для Claude Code: выбирает SLI, назначает достижимую цель и ведёт SLO в Elastic Observability через Kibana API. Разбирает шумные алерты и несходящийся бюджет ошибок. CX Codex +1 1 500установок gke-reliability официальный google Скилл gke-reliability для Claude Code, Gemini CLI и Codex, который настраивает надёжность рабочих нагрузок GKE: PodDisruptionBudget, пробы здоровья и topology spread constraints. CX Codex +1 6 500установок review-hog-perspective-performance-reliability PostHog Скилл review-hog-perspective-performance-reliability проверяет код на проблемы с производительностью и надёжностью: от запросов к базе до обработки ошибок. Запускайте его при ревью изменений. CX Codex +1 187установок

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

Весь набор →
i18n-parity Правило i18n-parity требует переносить любые правки интерфейса и документации во все поддерживаемые локали в том же пулреквесте, запрещая сдавать неполные переводы. CX Codex +1 ★ 1 198звёзд репо trend-forecaster Субагент trend-forecaster оценивает будущие расходы и активность Claude Code по дневной статистике Agent Monitor. Помогает увидеть изменение тренда на горизонте до 30 дней. CX Codex ★ 1 198звёзд репо analytics-advisor Субагент analytics-advisor для Claude, который собирает цифры с дашборда Agent Monitor и объясняет, за что вы платите в сессиях. CX Codex ★ 1 198звёзд репо dashboard-operator Субагент dashboard-operator следит за состоянием панели Claude Code Agent Monitor на порту 4820, читает метрики и подсказывает шаги для запуска или импорта данных. CX Codex ★ 1 198звёзд репо file-headers Скилл file-headers для Claude Code добавляет в каждый создаваемый или изменяемый файл заголовок с описанием и автором, поддерживая единый формат копирайта в репозитории. CX Codex +1 ★ 1 198звёзд репо orchestration-analyst Субагент orchestration-analyst для анализа мультиагентных сессий. Строит граф вызовов DAG, ищет узкие места параллелизации и трассирует распространение ошибок по метрикам локального монитора. CX Codex ★ 1 198звёзд репо session-investigator Субагент session-investigator для Claude Code, Codex и Cursor разбирает сессию по данным Agent Monitor: стоимость, дерево агентов, события, транскрипт и аномалии. Ищет причины сбоев. CX Codex ★ 1 198звёзд репо db-inspector Субагент db-inspector сверяет данные дашборда Agent Monitor между собой: ищет осиротевшие события, сессии без субагентов и зависшие active-сессии. Ничего не меняет, только отчитывается. CX Codex ★ 1 198звёзд репо

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

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