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

error-detective · voltagent/awesome-codex-subagents — субагент для Codex: анализ ошибок и логов

Субагент error-detective для быстрого разбора логов, исключений и stack-trace'ов. Находит вероятный источник сбоя, отделяя первичную ошибку от каскадных эффектов.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/error-detective.toml
Открыть на GitHub

Что делает error-detective

error-detective анализирует логи как доказательства, а не как чеклист. Он строит карту границ поведения, отделяет подтверждённые факты от гипотез и рекомендует минимальное исправление с максимальным снижением риска.

Субагент работает с корреляцией логов по correlation-id и меткам времени между сервисами, кластеризует сигнатуры ошибок, чтобы отличить основной дефект от вторичного шума, и определяет, где логирование даёт слепые зоны. Результат — точная область анализа, ключевые находки с подтверждением, наименьшее исправление и что всё ещё нужно проверить в runtime.

Устанавливается в .codex/agents/error-detective.toml или как .claude/agents/error-detective.md для Claude Code и Cursor. Не выдаёт гипотезы как установленные причины, если только не попросят явно.

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

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

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

  • Разбери эти логи и найди, откуда начинается сбой
  • Проанализируй stack-trace'и за последний час, выделив главное и касающееся вторичное
  • Отследи ошибку 502 через логи фронтенда, API и БД, покажи, на каком уровне она возникает

Как установить error-detective

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

.codex/agents/error-detective.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

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

Вопросы об error-detective

Как установить error-detective в Codex?

Создай файл .codex/agents/error-detective.toml в корне проекта с конфигурацией субагента. Для Claude Code используй .claude/agents/error-detective.md, для Cursor — .cursor/agents/error-detective.md.

Что делает error-detective?

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

Чем error-detective отличается от просто поиска по логам?

Он stitches логи через границы сервисов по correlation-id и времени, кластеризует сигнатуры ошибок, чтобы выделить шум, и проверяет, есть ли в логировании слепые зоны. Результат — не список совпадений, а ранжированная гипотеза с доказательствами и конкретными шагами проверки.

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

error-detective.toml · MIT
# error-detective

Use when a task needs log, exception, or stack-trace analysis to identify the most probable failure source quickly.

Own error and log forensics work as evidence-driven quality and risk reduction, not checklist theater.

Prioritize the smallest actionable findings or fixes that reduce user-visible failure risk, improve confidence, and preserve delivery speed.

Working mode:
1. Map the changed or affected behavior boundary and likely failure surface.
2. Separate confirmed evidence from hypotheses before recommending action.
3. Implement or recommend the minimal intervention with highest risk reduction.
4. Validate one normal path, one failure path, and one integration edge where possible.

Focus on:
- log signature clustering to separate primary faults from secondary noise
- correlation-id and timestamp stitching across service boundaries
- first-failure identification versus downstream cascade effects
- error-frequency, recency, and blast-radius prioritization
- exception context quality: missing fields, redaction, and parsing gaps
- likely trigger conditions inferred from logs and surrounding telemetry
- fast triage output suitable for immediate debugging handoff

Quality checks:
- verify candidate causes are ranked by evidence strength and impact
- confirm timeline includes earliest known failure and spread pattern
- check for logging blind spots that can mislead incident diagnosis
- ensure recommendations include concrete next-query/instrumentation steps
- call out uncertainty where logs alone cannot prove causality

Return:
- exact scope analyzed (feature path, component, service, or diff area)
- key finding(s) or defect/risk hypothesis with supporting evidence
- smallest recommended fix/mitigation and expected risk reduction
- what was validated and what still needs runtime/environment verification
- residual risk, priority, and concrete follow-up actions

Do not present log-correlation guesses as confirmed root cause unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

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

Все субагенты по теме «Код-ревью и рефакторинг» →

Сначала — error-detective от других авторов.

error-detective VoltAgent Community Субагент error-detective для Claude Code, который разбирает ошибки в распределённых системах: коррелирует сбои между сервисами, ищет корневые причины и предлагает меры, чтобы сбои не повторялись. CX Codex 7 557установок error-detective rohitg00 Субагент error-detective, который разбирается в stack trace, воспроизводит ошибки и находит корень проблемы. Помогает когда нужно быстро от крипто-сообщения об ошибке перейти к чёткому багу. CX Codex ★ 2 858звёзд репо distributed-debugging-error-detective Seth Hobson Субагент distributed-debugging-error-detective ищет ошибки в логах и коде, сопоставляет сбои между сервисами и помогает найти первопричину при отладке. CX Codex ★ 42 780звёзд репо error-coordinator VoltAgent Community Субагент Claude Code error-coordinator разбирает логи и вывод агентов, выявляя повторяющиеся ошибки и цепочки сбоев. Готовит план восстановления на основе свидетельств из файлов. CX Codex 205установок debugging-wizard https://github.com/Jeffallan Скилл debugging-wizard разбирает ошибки, стек-трейсы и логи, чтобы найти причину сбоя. Нужен при падениях, исключениях и неожиданном поведении кода. CX Codex +1 5 600установок error-debugging Seth Hobson Плагин error-debugging анализирует ошибки, трассирует исполнение и диагностирует сбои во взаимодействии агентов. Пригодится при поиске причин неполадок в сложных сценариях. CX Codex ★ 42 780звёзд репо error-diagnostics-smart-debug sickn33 Скилл error-diagnostics-smart-debug разбирает сбои по шагам воспроизведения, трассировкам, логам и коду, затем помогает проверить гипотезу и зафиксировать исправление. CX Codex +1 1установок error-discovery ai-evals-course Скилл error-discovery для интерактивного разбора датасета с выводами LLM: строит UI для просмотра, отбирает разные примеры и помогает собрать типы сбоев. CX Codex +1 1 200установок

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

Весь набор →
powershell-security-hardening Субагент powershell-security-hardening проверяет и ужесточает безопасность PowerShell-скриптов, админских задач и Windows-настроек. Полезен при аудите изменений и контролей выполнения. CX Codex ★ 6 505звёзд репо performance-engineer Субагент performance-engineer для диагностики медленных запросов, критических путей и регрессий рендеринга. Находит узкие места в латентности, памяти и базах данных, даёт минимальные рекомендации с расчётом риска. CX Codex ★ 6 505звёзд репо penetration-tester Субагент penetration-tester проводит прикладной аудит безопасности кода, ищет сценарии злоупотреблений и уязвимые места до релиза. CX Codex ★ 6 505звёзд репо gdpr-ccpa-compliance Субагент gdpr-ccpa-compliance для Codex проверяет обработку персональных данных, согласия и права пользователей по GDPR и CCPA/CPRA. Проводит аудит перед изменениями или продажами. CX Codex ★ 6 505звёзд репо debugger Субагент debugger изолирует баги по трассировкам стека, упавшим тестам и рантайм-логам. Находит причину сбоя и предлагает минимальное исправление. CX Codex ★ 6 505звёзд репо compliance-auditor Субагент compliance-auditor проверяет контролы, аудитопригодность и пробелы в доказательствах. Подходит для регулируемых рабочих процессов. CX Codex ★ 6 505звёзд репо code-reviewer Субагент code-reviewer для комплексной проверки кода: анализирует поддерживаемость, дизайн и риски, а не только синтаксис. Выявляет проблемы в логике обработки ошибок, контрактах данных и побочных эффектах. CX Codex ★ 6 505звёзд репо chaos-engineer Субагент chaos-engineer анализирует устойчивость кода к сбоям зависимостей, планирует контролируемое внедрение отказов и находит слабые места в таймаутах или логике деградации сервиса. CX Codex ★ 6 505звёзд репо

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

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