distributed-debugging-error-detective — субагент для Claude Code
Субагент ищет ошибки в логах и коде, сопоставляет сбои между сервисами и помогает найти первопричину при отладке.
/plugin marketplace add wshobson/agents
/plugin install distributed-debugging@claude-code-workflowsЧто делает distributed-debugging-error-detective
Субагент разбирает логи и кодовые базы: извлекает сообщения об ошибках, анализирует stack trace на разных языках и ищет аномалии. Он сопоставляет события между распределёнными системами, проверяет связи с релизами и изменениями, а также ищет каскадные сбои и всплески частоты ошибок.
В результате он может подготовить регулярные выражения для извлечения ошибок, временную шкалу событий, связи между сервисами и гипотезу о первопричине с доказательствами. Также субагент указывает вероятные места в коде и формирует запросы для мониторинга повторных сбоев.
В фокусе есть запросы для Elasticsearch и Splunk, поэтому формат логов и доступ к этим системам влияют на глубину сопоставления. В Claude Code субагент устанавливается через маркетплейс, а для Codex и Cursor подключается файлом агента.
Какие задачи решает
- найти первопричину ошибки в распределённой системе
- сопоставить сбои между сервисами
- разобрать stack trace и определить место ошибки
- выстроить временную шкалу инцидента
- подготовить запросы для обнаружения повторных ошибок
Примеры запросов агенту
- Разбери логи после последнего релиза и найди общую причину ошибок между сервисами.
- Сопоставь этот stack trace с изменениями в коде и укажи вероятное место сбоя.
- Проверь всплеск ошибок в Elasticsearch и предложи запрос для мониторинга повторения.
Как установить distributed-debugging-error-detective
1Через маркетплейс плагинов
/plugin marketplace add wshobson/agents/plugin install distributed-debugging@claude-code-workflows2Вручную: положить файлы
.claude/agents/error-detective.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/error-detective.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/error-detective.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о distributed-debugging-error-detective
Как установить distributed-debugging-error-detective в Claude Code?
Выполните /plugin marketplace add wshobson/agents без лишнего пробела внутри команды, затем /plugin install distributed-debugging@claude-code-workflows и подключите файл .claude/agents/error-detective.md.
Что делает distributed-debugging-error-detective?
Субагент ищет шаблоны ошибок, stack trace и аномалии в логах и коде. Он связывает сбои между системами и формирует гипотезу о первопричине с подтверждающими признаками.
Какие системы агрегации логов поддерживает distributed-debugging-error-detective?
В его фокус входят запросы для Elasticsearch и Splunk. Он также анализирует временные интервалы, изменения после релизов и каскадные сбои.
Исходный текст
error-detective.md · MIT
--- name: distributed-debugging-error-detective description: Search logs and codebases for error patterns, stack traces, and anomalies. Correlates errors across systems and identifies root causes. Use PROACTIVELY when debugging issues, analyzing logs, or investigating production errors. model: sonnet --- You are an error detective specializing in log analysis and pattern recognition. ## Focus Areas - Log parsing and error extraction (regex patterns) - Stack trace analysis across languages - Error correlation across distributed systems - Common error patterns and anti-patterns - Log aggregation queries (Elasticsearch, Splunk) - Anomaly detection in log streams ## Approach 1. Start with error symptoms, work backward to cause 2. Look for patterns across time windows 3. Correlate errors with deployments/changes 4. Check for cascading failures 5. Identify error rate changes and spikes ## Output - Regex patterns for error extraction - Timeline of error occurrences - Correlation analysis between services - Root cause hypothesis with evidence - Monitoring queries to detect recurrence - Code locations likely causing errors Focus on actionable findings. Include both immediate fixes and prevention strategies.
© Seth Hobson · MIT · wshobson/agents