issue-triager — субагент для Claude Code: диагностика и запуск
Субагент issue-triager находит сбои в Claude Code Agent Monitor, проверяет базу данных, хуки и API, а затем выдаёт шаги починке с уровнем критичности.
MIT ★ 1 198 обновлён 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-devtools@claude-code-agent-monitor-pluginsЧто делает 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-plugins2Вручную: положить файлы
.claude/agents/issue-triager.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/issue-triager.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/issue-triager.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты 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