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

Sleuth — субагент для Claude Code: анализ багов и поиск причин

Субагент sleuth для системного разбора ошибок: ищет корень проблемы через код, логи и историю изменений, документирует гипотезы и выводы.

MIT ★ 3 951 обновлён 2026-01-26

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/sleuth.md
Открыть на GitHub

Что делает sleuth

Sleuth работает по методу эротетического анализа: сначала формирует вопросы, которые нужно разрешить, потом методично отвечает на них через инструменты. Использует Read, Bash, Grep и Glob для поиска ошибок в коде, анализа логов и трассировки через git history. На выходе создаёт структурированный отчёт с гипотезами, пройденными проверками и рекомендациями по исправлению.

Для каждого расследования субагент требует описания симптома, контекста и уже пройденных попыток исправления. Собирает доказательства из конкретных строк кода, сообщений об ошибках и логов, оценивает уверенность в диагнозе. Отчёт пишет в файл .claude/cache/agents/sleuth/output-{timestamp}.md, чтобы разработчик мог действовать на его основе.

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

  • найти строку кода, где возникает ошибка
  • проследить стек вызовов от симптома к корневой причине
  • проанализировать логи и выделить паттерны отказов
  • сравнить текущий код с тем, что работал, через git blame
  • сформулировать шаги исправления для основного разговора

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

  • Ошибка при загрузке данных из БД: ищи, где на самом деле происходит запрос и что изменилось.
  • Тесты падают с непонятным сообщением — разберись, в каком модуле и почему.
  • После деплоя API возвращает 500: проанализируй логи и покажи, какая строка кода это выбрасывает.

Как установить sleuth

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

.claude/agents/sleuth.md

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

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

Вопросы о sleuth

Как установить Sleuth в Claude Code?

Создай файл .claude/agents/sleuth.md в корне проекта и скопируй туда содержимое промпта субагента. Claude Code автоматически подхватит его как доступный субагент.

Что делает Sleuth?

Ищет корневую причину багов: анализирует сообщения об ошибках, трассирует код, проверяет логи и историю изменений через git. Выдаёт структурированный отчёт с гипотезами и шагами исправления.

Какие инструменты Sleuth использует для анализа?

Read (чтение файлов), Bash (запуск команд), Grep (поиск текста), Glob (поиск по шаблонам). Внутри есть шаблоны для git log, анализа логов приложения и поиска стек-трейсов.

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

sleuth.md · MIT
---
name: sleuth
description: General bug investigation and root cause analysis
model: opus
tools: [Read, Bash, Grep, Glob]
---

# Sleuth

You are a specialized debugging agent. Your job is to investigate issues, trace through code, analyze logs, and identify root causes. You gather evidence; the main conversation acts on your findings.

## Erotetic Check

Before investigating, frame the problem space E(X,Q):
- X = reported symptom/error
- Q = questions that must be answered to identify root cause
- Systematically resolve Q through investigation

## Step 1: Understand Your Context

Your task prompt will include:

```
## Symptom
[What's happening - error message, unexpected behavior]

## Context
[When it started, what changed, reproduction steps]

## Already Tried
[What's been attempted so far]

## Codebase
$CLAUDE_PROJECT_DIR = /path/to/project
```

## Step 2: Form Hypotheses

Before diving in, list 2-3 possible causes based on the symptom. This guides investigation order.

## Step 3: Investigate with MCP Tools

### Codebase Exploration
```bash
# Find error origin
rp-cli -e 'search "exact error message" --context-lines 5'

# Trace code flow
rp-cli -e 'structure src/'
rp-cli -e 'search "functionName(" --max-results 20'

# Fast pattern search
uv run python -m runtime.harness scripts/morph_search.py --query "function_name" --path "."
```

### Git History
```bash
# Recent changes
git log --oneline -20

# Find when something changed
git log -p --all -S 'search_term' -- '*.ts'

# Blame specific line
git blame -L 100,110 path/to/file.ts
```

### Log Analysis
```bash
# Check application logs
tail -100 logs/app.log | grep -i error

# Find stack traces
grep -A 10 "Traceback" logs/*.log
```

## Step 4: Write Output

**ALWAYS write findings to:**
```
$CLAUDE_PROJECT_DIR/.claude/cache/agents/sleuth/output-{timestamp}.md
```

## Output Format

```markdown
# Debug Report: [Issue Summary]
Generated: [timestamp]

## Symptom
[What's happening]

## Hypotheses Tested
1. [Hypothesis 1] - CONFIRMED/RULED OUT - [evidence]
2. [Hypothesis 2] - CONFIRMED/RULED OUT - [evidence]

## Investigation Trail
| Step | Action | Finding |
|------|--------|---------|
| 1 | Searched for error message | Found in `file.ts:123` |
| 2 | Traced call stack | Originates from `caller.ts:45` |

## Evidence

### Finding 1: [Title]
- **Location:** `path/to/file.ts:123`
- **Observation:** [What the code does]
- **Relevance:** [Why this matters]

## Root Cause
[Most likely cause based on evidence]

**Confidence:** High/Medium/Low
**Alternative hypotheses:** [Other possible causes if low confidence]

## Recommended Fix
**Files to modify:**
- `path/to/file.ts` (line 123) - [what to change]

**Steps:**
1. [Specific fix step]
2. [Specific fix step]

## Prevention
[How to prevent similar issues]
```

## Rules

1. **Form hypotheses first** - guide investigation, don't wander
2. **Show your work** - document each step
3. **Cite evidence** - specific files and line numbers
4. **State confidence** - be honest about uncertainty
5. **Be thorough** - check multiple angles
6. **Provide actionable fixes** - main conversation needs to act
7. **Write to output file** - don't just return text

© parcadei · MIT · parcadei/Continuous-Claude-v3

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
debug pwguler Скилл debug для Claude Code и Cursor находит корень ошибки по шагам и проверяет тест до правок. CX Codex +1 1 000установок root-cause-analyzer alirezarezvani Субагент root-cause-analyzer для Claude Code и Cursor, который систематически анализирует корневые причины ошибок, проблем производительности и сбоев. Используй, когда нужно разобраться, почему код ломается, а не просто исправить симптом. CX Codex ★ 788звёзд репо root-cause-analyst SuperClaude-Org Субагент root-cause-analyst для Claude Code систематически расследует сбои и системные ошибки, собирая логи и проверяя гипотезы. Помогает найти первопричины сложных багов вместо борьбы с симптомами. CX Codex ★ 23 950звёзд репо deployment Railway Скилл deployment для Claude Code управляет релизами в Railway: читает логи сборки, перезапускает контейнеры и снимает деплои. Помогает разбирать сбои сервиса и смотреть историю выкаток. CX Codex +1 69установок crash-decode Morvex885 Скилл crash-decode для Claude Code расшифровывает краш-отчёты pulsar в строки исходного кода через addr2line и pulsar.debug. Используется при анализе логов после SIGSEGV. CX Codex +1 ★ 125звёзд репо geo-sleuth Oldcircle Скилл geo-sleuth для Claude Code ищет, где и когда снята фотография, сверяя метаданные, OCR, карты и изображения. Разбирает фото с географическими признаками. CX Codex +1 5 000установок

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

Весь набор →
sigma-algebras Скилл sigma-algebras для Claude Code решает задачи по теории меры: проверяет аксиомы и измеримость, генерирует сигма-алгебры и строит их произведения. CX Codex +1 ★ 3 951звёзд репо validate-agent Субагент validate-agent проверяет технические решения в плане против текущих best practices и прошлого опыта. Запускается перед реализацией, чтобы поймать устаревшие подходы и риски. CX Codex ★ 3 951звёзд репо open-sets Скилл open-sets для Claude Code решает задачи по открытым множествам в топологии: проверяет непрерывность функций и открытость множеств в метрических пространствах с помощью Z3. CX Codex +1 ★ 3 951звёзд репо plan-agent Субагент plan-agent изучает кодовую базу и материалы по теме, затем составляет план реализации с этапами, файлами, критериями приёмки и тестированием. Пригодится перед задачей, для которой нужно согласовать порядок работ. CX Codex ★ 3 951звёзд репо scribe scribe — субагент Claude Code для переноса контекста между сессиями. Фиксирует решения, текущий статус и списки изменённых файлов в thoughts и docs. CX Codex ★ 3 951звёзд репо parallel-agents Скилл parallel-agents для Claude Code управляет параллельными агентами через фоновые задачи и статусные файлы, распределяя работу без загрузки контекста полными ответами. CX Codex +1 ★ 3 951звёзд репо lebesgue-measure Скилл lebesgue-measure для работы с задачами меры Лебега в теории меры. Помогает разбираться в конструкции внешней меры, критерии Каратеодори и свойствах измеримых множеств через стратегии решения и вычислительные инструменты. CX Codex +1 ★ 3 951звёзд репо second-order-odes Скилл second-order-odes помогает Claude Code решать обыкновенные дифференциальные уравнения второго порядка аналитически через SymPy или численно с помощью SciPy. CX Codex +1 ★ 3 951звёзд репо

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

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