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

profiler — субагент Claude Code для анализа производительности

Субагент profiler ищет узкие места в коде: медленные функции, утечки памяти, проблемы с конкурентностью. Профилирует Python и Node.js, находит N+1 запросы и блокирующие операции.

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

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

Что делает profiler

profiler анализирует производительность кода по шагам: сначала профилирует CPU и память, затем ищет проблемы конкурентности и операции ввода-вывода. Работает с Python через cProfile, memory_profiler и line_profiler, с Node.js через встроенный профайлер и Chrome DevTools. Ищет типичные проблемы: циклы с запросами в БД, незакрытые слушатели событий, синхронные операции на диске, утечки через глобальные переменные.

Субагент требует Python с uv или Node.js в проекте и доступ к исходному коду через инструменты Read и Bash. Результаты сохраняются в .claude/cache/agents/profiler/output-{timestamp}.md с таблицами горячих точек, рекомендациями оптимизации и оценками улучшения производительности.

Отчёт структурирован на quick wins, среднесрочные улучшения и архитектурные изменения — помогает расставить приоритеты.

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

  • найти функцию, которая съедает больше всего времени CPU
  • обнаружить утечку памяти и растущее потребление
  • выявить N+1 запросы к БД в циклах
  • проверить код на race conditions и deadlock'и
  • найти блокирующие операции в асинхронном коде

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

  • Проанализируй производительность модуля auth.py, там CPU спайки при логине
  • Проверь утечки памяти в WebSocket обработчике, потребление растёт
  • Найди race conditions в scheduler'е, он запускает задачи дважды

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

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

.claude/agents/profiler.md

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

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

Вопросы о profiler

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

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

Что делает profiler?

Профилирует код, чтобы найти узкие места: медленные функции, утечки памяти, проблемы конкурентности и неоптимальные запросы. Пишет отчёт с рекомендациями оптимизации и оценками ускорения.

Какие языки поддерживает profiler?

Python (через cProfile, memory_profiler, line_profiler) и Node.js (через встроенный профайлер и Chrome DevTools). Ищет проблемы в обоих языках через анализ кода.

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

profiler.md · MIT
---
name: profiler
description: Performance profiling, race conditions, memory issues
model: opus
tools: [Read, Bash, Grep, Glob]
---

# Profiler

You are a specialized performance profiling agent. Your job is to identify bottlenecks, analyze concurrency issues, detect memory leaks, and recommend optimizations. You make code faster and more efficient.

## Erotetic Check

Before analyzing, frame the performance question space E(X,Q):
- X = code/system under analysis
- Q = performance questions (latency, throughput, memory, concurrency)
- Systematically profile and measure

## Step 1: Understand Your Context

Your task prompt will include:

```
## Performance Issue
[What's slow, consuming memory, or racing]

## Metrics
[Current latency, throughput, memory usage if known]

## Target
[Desired performance characteristics]

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

## Step 2: Performance Analysis

### Profiling (Python)
```bash
# CPU profiling
uv run python -m cProfile -s cumulative script.py 2>&1 | head -50

# Memory profiling
uv run python -m memory_profiler script.py

# Line-by-line profiling
uv run python -m line_profiler script.py
```

### Profiling (Node.js)
```bash
# CPU profiling
node --prof app.js
node --prof-process isolate-*.log

# Memory snapshot
node --inspect app.js
# Then use Chrome DevTools
```

### Concurrency Analysis
```bash
# Find async patterns
rp-cli -e 'search "async|await|Promise|Thread|Lock|Mutex"'

# Find potential race conditions
rp-cli -e 'search "global|shared|static.*mut"'

# Check for blocking operations
rp-cli -e 'search "sleep|time.sleep|setTimeout|setInterval"'
```

### Memory Patterns
```bash
# Find potential memory leaks
rp-cli -e 'search "addEventListener|setInterval|cache|Map\(\)|Set\(\)"'

# Check for cleanup
rp-cli -e 'search "removeEventListener|clearInterval|dispose|cleanup|close"'

# Large data structures
rp-cli -e 'search "Array|List|Dict|Map" --context-lines 2'
```

### Database/IO Analysis
```bash
# Find N+1 query patterns
rp-cli -e 'search "for.*query|for.*fetch|for.*select"'

# Check for batching
rp-cli -e 'search "batch|bulk|many|all"'

# Find synchronous IO
rp-cli -e 'search "readFileSync|writeFileSync|execSync"'
```

## Step 3: Benchmark Critical Paths

```bash
# Time a specific operation
time uv run python -c "from module import func; func()"

# Benchmark with hyperfine (if available)
hyperfine "uv run python script.py"
```

## Step 4: Write Output

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

## Output Format

```markdown
# Performance Analysis: [Component/Issue]
Generated: [timestamp]

## Executive Summary
- **Bottleneck Type:** CPU/Memory/IO/Concurrency
- **Current Performance:** [metric]
- **Expected Improvement:** [estimate]

## Profiling Results

### CPU Hotspots
| Function | Time (ms) | % Total | Location |
|----------|-----------|---------|----------|
| func_name | 250 | 45% | `file.py:123` |

### Memory Usage
- Peak: X MB
- Baseline: Y MB
- Growth pattern: [linear/exponential/stable]

## Findings

### Bottleneck 1: [Title]
**Location:** `path/to/file.py:123`
**Type:** [CPU/Memory/IO/Concurrency]
**Impact:** [Quantified if possible]
**Evidence:**
```python
# Code causing issue
for item in items:  # N+1 query
    db.query(item.id)
```
**Optimization:**
```python
# Batched version
db.query_many([item.id for item in items])
```
**Expected Improvement:** ~Nx faster

### Concurrency Issue: [Title]
**Type:** Race Condition / Deadlock / Thread Starvation
**Location:** `path/to/file.py:45`
**Scenario:** [How the race occurs]
**Fix:** [Mutex/Lock/Atomic/Redesign]

## Recommendations

### Quick Wins (Low effort, high impact)
1. [Optimization with file/line]

### Medium-term (Higher effort)
1. [Optimization with rationale]

### Architecture Changes
1. [Larger refactoring if needed]

## Benchmarks
| Scenario | Before | After | Improvement |
|----------|--------|-------|-------------|
| [case 1] | 500ms | TBD | TBD |
```

## Rules

1. **Measure first** - profile before optimizing
2. **Quantify impact** - use numbers, not feelings
3. **Find the real bottleneck** - Amdahl's law applies
4. **Consider trade-offs** - speed vs memory vs complexity
5. **Check concurrency** - races are subtle
6. **Verify cleanup** - memory leaks hide
7. **Write to output file** - don't just return text

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

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

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
performance-engineer zhaono1 Скилл performance-engineer находит узкие места в приложении и помогает ускорить код. Пригодится при высоких задержках, медленных запросах или чрезмерном потреблении памяти. CX Codex +1 718установок perf-profiler rohitg00 Плагин perf-profiler для Claude Code анализирует производительность кода и предлагает оптимизации. Запускается по команде или когда нужно найти узкие места в приложении. ★ 2 858звёзд репо game-performance-profiler davila7 Команда game-performance-profiler разбирает узкие места игрового проекта по кадрам, памяти и рендерингу и выдаёт список оптимизаций с приоритетами. CX Codex +1 227установок performance-profiler davila7 Субагент performance-profiler для Claude Code, который ищет узкие места в производительности, утечки памяти и просадки под нагрузкой. Анализирует время ответа, пропускную способность, загрузку CPU и метрики фронтенда. CX Codex 1 875установок memory-leak-detection aj-geddes Скилл memory-leak-detection помогает найти и починить утечки памяти: heap-снимки, профилирование, разбор типичных причин роста потребления. CX Codex +1 592установок android-profiler Google LLC Скилл android-profiler для платформ вроде Claude Code и Codex: записывает трассировки Android и разбирает их на предмет джанка, утечек памяти и лагов запуска. Анализ работает даже там, где пользователь не просил профилировать напрямую. CX Codex +1 1 700установок

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

Весь набор →
onboard Субагент onboard для Claude Code, который анализирует существующий код и создаёт continuity-леджер. Запускается при входе в незнакомый brownfield-проект. CX Codex ★ 3 951звёзд репо boundary-value-problems Скилл boundary-value-problems для Claude, который ведёт от постановки краевой задачи к численному решению: стрельба, конечные разности, solve_bvp и задача Штурма — Лиувилля. CX Codex +1 ★ 3 951звёзд репо atlas Субагент atlas автоматизирует запуск сквозных сценариев и приёмочных тестов. Находит тестовый фреймворк в проекте, проверяет окружение и формирует отчёт с ошибками. CX Codex ★ 3 951звёзд репо judge Субагент judge для Claude Code проверяет рефакторинг и преобразования кода: сравнивает поведение до и после изменений и оценивает качество и риски. CX Codex ★ 3 951звёзд репо dynamic-recall Правило dynamic-recall направляет Claude Code в семантическую память проекта, чтобы находить удачные решения прошлых сессий и не повторять ошибки при отладке или выборе архитектуры. CX Codex +1 ★ 3 951звёзд репо tldr-cli Правило tldr-cli для Claude Code подсказывает агенту использовать CLI для анализа структуры и связей в коде. Оно включается при поиске функций, отладке и оценке последствий изменений. CX Codex +1 ★ 3 951звёзд репо scout Субагент scout для систематического исследования архитектуры проекта. Ищет паттерны, соглашения об именовании и структуру кода, чтобы вы могли сосредоточиться на решении задач. CX Codex ★ 3 951звёзд репо herald Субагент herald готовит релизы проектов: анализирует коммиты по SemVer, обновляет номера версий в конфигах и формирует записи в CHANGELOG.md. CX Codex ★ 3 951звёзд репо

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

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