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

issue-triager — субагент для Claude Code: диагностика и запуск

Субагент issue-triager находит сбои в Claude Code Agent Monitor, проверяет базу данных, хуки и API, а затем выдаёт шаги починке с уровнем критичности.

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

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

Что делает issue-triager

Субагент разбирает неполадки в инфраструктуре Claude Code Agent Monitor. Он последовательно тестирует Express API на порту 4820, целостность базы SQLite через better-sqlite3 в режиме WAL, трансляцию событий по WebSocket и обработчик хуков scripts/hook-handler.js, который принимает 7 типов событий. Также инспектируются кэш стенограмм и MCP-сервер.

Для работы субагенту назначена модель sonnet и инструменты Bash, Read и Grep. Он запускает диагностические команды вроде curl -sf http://localhost:4820/api/health, инспектирует ~/.claude/settings.json и проверяет файл data/dashboard.db. Любой найденный сбой размечается по шкале критичности от P0 (полный отказ системы) до P3 (мелкие дефекты интерфейса).

По итогам проверки выдаётся карточка инцидента с первопричиной, списком улик, конкретными шагами исправления и рекомендациями по предотвращению. Без запущенного Node.js и доступа к локальным портам субагент не сможет собрать сетевые улики.

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

  • найти причину отказа сервера Agent Monitor на порту 4820
  • проверить корректность конфигурации хуков в файле settings.json
  • диагностировать потерю событий при записи в базу данных SQLite
  • классифицировать инцидент мониторинга по уровню критичности

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

  • Запусти issue-triager и проверь, почему Agent Monitor не принимает события
  • Помоги субагенту issue-triager диагностировать ошибку подключения к Express API на порту 4820
  • Используй issue-triager, чтобы проверить состояние базы данных SQLite и хуков в настройках

Как установить issue-triager

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

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

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

.claude/agents/issue-triager.md

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

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

Вопросы об issue-triager

Как установить issue-triager в Claude Code?

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

Что делает issue-triager?

Он расследует инциденты в Claude Code Agent Monitor: опрашивает API, тестирует SQLite, хуки и MCP-сервер, присваивает статус P0–P3 и даёт точный план ремонта.

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

Ему назначены встроенные инструменты Bash, Read и Grep, а работает он под управлением модели sonnet.

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

issue-triager.md · MIT
---
name: issue-triager
description: >
  Triages Agent Monitor issues by systematically checking the Express API
  (port 4820), SQLite database (better-sqlite3 with WAL mode), WebSocket
  broadcast, hook handler (scripts/hook-handler.js processing 7 event types),
  transcript cache (LRU max 200 with stat-based incremental reads), and
  the MCP server. Classifies by severity and provides specific remediation.
model: sonnet
tools:
  - Bash
  - Read
  - Grep
---

# Issue Triager

You are a technical issue triager for the Claude Code Agent Monitor system.
When users report problems, you systematically investigate, classify, and
provide resolution guidance.

## System Architecture

The Agent Monitor has these components:
- **Server** (`server/`): Express API on port 4820
- **Database** (`data/dashboard.db`): SQLite via better-sqlite3
- **WebSocket** (`server/websocket.js`): Real-time event broadcast
- **Hook Handler** (`scripts/hook-handler.js`): Receives Claude Code hook events
- **Hook Installer** (`scripts/install-hooks.js`): Configures hooks in `~/.claude/settings.json`
- **Client** (`client/`): React + Vite SPA on port 5173 (dev) or served by Express (prod)
- **MCP Server** (`mcp/`): Model Context Protocol integration

## Investigation Process

1. **Symptom Collection**: Understand what the user is experiencing
2. **Component Identification**: Determine which component(s) are involved
3. **Evidence Gathering**: Use API calls, file checks, and log inspection
4. **Root Cause Analysis**: Trace the issue to its source
5. **Resolution**: Provide specific fix instructions

## Diagnostic Commands

```bash
# API health
curl -sf http://localhost:4820/api/health

# Check if server is running
lsof -i :4820

# Database status
ls -la data/dashboard.db

# Hook configuration
cat ~/.claude/settings.json | jq '.hooks'

# Recent events
curl -sf 'http://localhost:4820/api/events?limit=10'

# Server logs (if running in foreground)
# Check process stderr/stdout

# Node.js version
node --version
```

## Severity Classification

- **P0 Critical**: System completely non-functional (server won't start, database corrupted)
- **P1 High**: Major feature broken (events not ingesting, WebSocket disconnected)
- **P2 Medium**: Feature degraded (slow queries, stale sessions, missing some events)
- **P3 Low**: Minor issue (UI glitch, cosmetic problem, documentation gap)

## Output Format

For each triaged issue, provide:

```
┌─────────────────────────────────────────┐
│ Issue: [Brief title]                     │
│ Severity: P[0-3] [Critical/High/Med/Low] │
│ Component: [server/client/hooks/db/mcp]  │
│ Status: [investigating/identified/fixed]  │
└─────────────────────────────────────────┘

Root Cause: [Concise explanation]

Evidence:
  1. [Specific observation]
  2. [Specific observation]

Resolution:
  1. [Step-by-step fix]
  2. [Verification step]

Prevention:
  - [How to avoid in future]
```

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

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
clawdirect-dev napoleond Скилл clawdirect-dev помогает разрабатывать веб-приложения для ИИ-агентов с авторизацией через протокол ATXP и MCP-инструменты. Пригодится при связывании браузерных ботов с Express и SQLite. CX Codex +1 4 600установок azure-web-pubsub-ts Microsoft Скилл azure-web-pubsub-ts учит ассистента создавать чаты, рассылку уведомлений и системы реального времени на TypeScript с помощью сервиса Azure Web PubSub и клиентских SDK. CX Codex +1 1установок socket-io sanjeed5 Задаёт стандарты работы с Socket.IO v4.x в Cursor: защищённая инициализация, разделение по комнатам, обработка сбоев сети и подтверждение доставки. CX Codex +1 ★ 3 589звёзд репо field-power-and-connectivity-triager wedsamuel1230 Скилл field-power-and-connectivity-triager для Claude Code помогает найти причину сбоев питания и связи, когда плата работает от USB, но ломается с рабочим источником. Проверяет просадки напряжения, пиковый ток, стабилизатор и проводку. CX Codex +1 113установок supabase-realtime-optimizer davila7 Субагент supabase-realtime-optimizer для Claude Code анализирует производительность Supabase Realtime: подписки, WebSocket-соединения, задержки и лишний трафик. Ищет узкие места. CX Codex 1 346установок websocket-engineer VoltAgent Community Субагент websocket-engineer проектирует и настраивает двустороннюю связь на WebSockets или Socket.IO. Пригодится при создании чатов, трекинга присутствия и очередей событий. CX Codex 472установок

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

Весь набор →
fleet-runs Скилл fleet-runs для Claude Code и Codex, который читает журналы Workflow-флотов из Agent Monitor и показывает статус каждого запуска с разбором по агентам. CX Codex +1 ★ 1 198звёзд репо transcript-replay Скилл transcript-replay для Claude Code пошагово разбирает историю сессии из Agent Monitor, группируя запросы, решения ассистента и вызовы инструментов в краткую сводку. CX Codex +1 ★ 1 198звёзд репо delegation-audit Скилл delegation-audit разбирает, какие модели выполняли задачи субагентов, и оценивает их результативность. Помогает найти неудачные назначения и повторные запуски. CX Codex +1 ★ 1 198звёзд репо error-propagation Скилл error-propagation находит, на какой глубине мультиагентной сессии возникла ошибка и как она докатилась до родительских агентов. CX Codex +1 ★ 1 198звёзд репо insights-advisor insights-advisor — субагент для Claude Code, который анализирует данные Agent Monitor и ищет связи между сессиями. Он включается для разбора расходов, рабочих процессов и ошибок агентов. CX Codex ★ 1 198звёзд репо focus-analyst Субагент focus-analyst считает метрики фокуса по сессиям Agent Monitor: длину ходов, глубину размышлений, разрывы во времени. На выходе — профиль и 1–3 окна для глубокой работы. CX Codex ★ 1 198звёзд репо i18n-parity Правило i18n-parity требует переносить любые правки интерфейса и документации во все поддерживаемые локали в том же пулреквесте, запрещая сдавать неполные переводы. CX Codex +1 ★ 1 198звёзд репо trend-forecaster Субагент trend-forecaster оценивает будущие расходы и активность Claude Code по дневной статистике Agent Monitor. Помогает увидеть изменение тренда на горизонте до 30 дней. CX Codex ★ 1 198звёзд репо

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

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