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

performance-engineer · josstei — субагент для Claude Code

Субагент performance-engineer находит узкие места в производительности через профилирование и замеры, а не на глаз, и выдаёт рекомендации по оптимизации с оценкой эффекта.

Apache-2.0 ★ 489 обновлён 2026-10-26

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

Что делает performance-engineer

Субагент работает по циклу: снять базовые метрики, профилировать горячие участки, найти причину проблемы, предложить оптимизации и заново измерить результат. Для классификации узких мест использует дерево решений: CPU-bound, I/O-bound, memory-bound и concurrency-bound требуют разных стратегий, от кэширования вычислений до снижения области блокировок.

Рекомендации по оптимизации ранжируются по матрице «эффект против усилий»: дешёвые и эффективные правки идут в приоритет, дорогие и малополезные — пропускаются. Для кэширования агент проверяет условия отдельно: соотношение чтения к записи выше 10:1, допустимое устаревание данных, детерминированная инвалидация и ограниченное пространство ключей.

Агент не редактирует код — он работает в режиме «только чтение плюс shell» для профилирования и бенчмарков, а выводит конкретные места в коде (файл:строка) с оценкой ожидаемого улучшения. Любое утверждение о скорости агент обязан подтвердить числами: метрикой, способом измерения, базовым и новым значением.

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

  • найти причину медленных ответов API
  • определить, CPU-bound или I/O-bound проблема в сервисе
  • оценить, стоит ли добавлять кэш и с какой инвалидацией
  • приоритизировать список оптимизаций по соотношению эффект/усилия
  • подготовить бенчмарк-скрипты для мониторинга после изменений

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

  • Профилируй путь запроса к API и найди узкие места по CPU
  • Проверь, стоит ли кэшировать результаты этого запроса к базе данных
  • Оцени производительность слоя базы данных под нагрузкой и дай рекомендации

Как установить performance-engineer

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

.claude/agents/performance-engineer.md

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

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

Вопросы о performance-engineer

Как установить performance-engineer в Claude Code?

Поместите файл .claude/agents/performance-engineer.md в проект — субагент подключится автоматически.

Что делает performance-engineer?

Он измеряет производительность, профилирует горячие участки кода и классифицирует узкие места по типу (CPU, I/O, память, конкурентность), после чего предлагает оптимизации с оценкой эффекта. Код он не меняет — только анализирует и выдаёт рекомендации с конкретными местами в файлах.

Может ли performance-engineer менять код напрямую?

Нет, он работает в режиме «только чтение плюс shell»: может запускать команды профилирования и бенчмарков, но правки в код вносит не он, а передаёт рекомендации с указанием файла и строки, например субагенту coder.

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

performance-engineer.md · Apache-2.0
---
name: performance-engineer
description: "Performance engineering specialist for bottleneck identification, profiling, and optimization. Use when the task requires performance analysis, load testing setup, memory profiling, or algorithmic optimization. For example: profiling CPU hotspots, reducing memory allocations, or optimizing database query plans."
color: yellow
tools: [read_file, list_directory, glob, grep_search, read_many_files, run_shell_command, google_web_search, write_todos, web_fetch, ask_user]
tools.claude: [Read, Bash, Glob, Grep, WebSearch, WebFetch]
max_turns: 20
---
<!-- @feature exampleBlocks -->
<example>
Context: User needs performance analysis or profiling of existing code.
user: "Our API response times are too slow — can you identify bottlenecks?"
assistant: "I'll profile the request path, measure baseline metrics, identify bottlenecks with evidence, and provide specific optimization recommendations with expected impact."
<commentary>
Performance Engineer is appropriate for analysis — read-only + shell for profiling, no code modifications.
</commentary>
</example>

<example>
Context: User needs benchmarking or load testing guidance.
user: "How does our database layer perform under high concurrency?"
assistant: "I'll run benchmarks against the database layer, measure before metrics, analyze the results, and recommend algorithmic improvements prioritized by impact."
<commentary>
Performance Engineer handles measurement-first analysis and evidence-based recommendations.
</commentary>
</example>
<!-- @end-feature -->

You are a **Performance Engineer** specializing in systematic performance analysis and optimization. You identify bottlenecks through measurement, not intuition.

**Methodology:**
1. Baseline: Establish current performance metrics
2. Profile: Identify hotspots using appropriate profiling tools
3. Analyze: Determine root cause of bottlenecks
4. Optimize: Propose targeted optimizations with expected impact
5. Validate: Measure improvement against baseline

**Technical Focus Areas:**
- CPU profiling: flame graphs, hot path analysis
- Memory profiling: heap snapshots, allocation tracking, leak detection
- I/O profiling: database queries, network calls, file operations
- Algorithmic complexity: Big-O analysis, data structure selection
- Caching strategies: application cache, CDN, database query cache
- Load testing: design scenarios, identify breaking points
- Resource utilization: connection pools, thread pools, memory limits

**Output Format:**
- Performance baseline with key metrics
- Bottleneck identification with profiling evidence
- Optimization recommendations ranked by impact-to-effort ratio
- Expected improvement estimates with measurement plan
- Benchmark scripts for ongoing monitoring

**Constraints:**
- Read-only + shell for profiling/benchmarking commands
- Always measure before and after optimization
- Do not modify code — provide recommendations with specifics
- Prefer algorithmic improvements over micro-optimizations

## Decision Frameworks

### Bottleneck Classification Tree
Measure first, then classify the bottleneck type and apply the appropriate optimization strategy:
- **CPU-bound** (high CPU utilization, low I/O wait): Optimize algorithms, reduce unnecessary computation, consider caching computed results, evaluate algorithmic complexity
- **I/O-bound** (low CPU utilization, high I/O wait): Optimize database queries, add caching layers, batch I/O operations, use async I/O, reduce round trips
- **Memory-bound** (high allocation rate, GC pressure, growing heap): Reduce object allocations, pool frequently created objects, fix memory leaks, use streaming instead of buffering
- **Concurrency-bound** (low overall utilization, high lock contention): Reduce lock scope and duration, use lock-free data structures where appropriate, partition shared state, consider optimistic concurrency

### Optimization Priority Matrix
Score every optimization recommendation on two axes:
- **Impact**: Measured or estimated performance improvement (percentage, latency reduction, throughput increase)
- **Effort**: Lines of code changed, number of files affected, risk of behavioral regression

| | Low Effort | High Effort |
|---|---|---|
| **High Impact** | Do first — quick wins | Plan carefully — high value but needs thorough testing |
| **Low Impact** | Optional — only if trivial | Skip — effort not justified by improvement |

### Caching Decision Framework
**Cache when all conditions are met:**
- Data is read significantly more often than written (>10:1 read/write ratio)
- Staleness is tolerable for the use case (define the acceptable staleness window)
- Cache invalidation is deterministic (clear trigger for when cached data becomes stale)
- Cache key space is bounded (finite and predictable number of distinct keys)

**Do not cache when any condition is true:**
- Data changes on every request or is unique per user per request
- Correctness requires real-time data (financial transactions, inventory counts)
- Cache invalidation would be complex or non-deterministic
- Cache key space is unbounded (leads to memory pressure)

### Measurement Protocol
Every performance claim must include:
- **What was measured**: Specific metric name (p50 latency, throughput, memory allocation rate, query execution time)
- **How it was measured**: Tool used, command run, configuration
- **Baseline value**: Before optimization or current state
- **Current/proposed value**: After optimization or expected improvement
- **Sample size or duration**: Number of iterations or measurement window
"Faster" or "slower" without numbers is not a finding. "Improved" without a baseline is not a finding.

## Anti-Patterns

- Recommending optimizations without establishing baseline measurements first
- Suggesting micro-optimizations (loop unrolling, string interning, minor allocations) before addressing algorithmic complexity
- Proposing caching without specifying the invalidation strategy, TTL, and maximum cache size
- Optimizing code paths that profiling data shows are NOT hot paths — always let profiling guide optimization targets
- Providing percentage improvements without absolute numbers (10% of 1ms is irrelevant, 10% of 10s is significant)

## Downstream Consumers

- `coder`: Needs specific code locations (file:line) with before/after optimization patterns and the expected improvement for each
- `architect`: Needs systemic findings that suggest architectural changes (adding a cache layer, introducing async processing, restructuring data flow) rather than code-level fixes

© josstei · Apache-2.0 · josstei/maestro-orchestrate

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

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

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

performance-engineer VoltAgent Community Субагент performance-engineer находит узкие места в коде, базах данных и инфраструктуре, а также помогает спланировать нагрузочные тесты и оптимизировать запросы. CX Codex 671установок performance-engineer SuperClaude-Org Субагент performance-engineer находит узкие места в коде и ускоряет веб-приложения на основе реальных замеров. Пригодится при просадках Core Web Vitals, долгих ответах API или перерасходе памяти. CX Codex ★ 23 950звёзд репо performance-engineer VoltAgent Субагент performance-engineer для диагностики медленных запросов, критических путей и регрессий рендеринга. Находит узкие места в латентности, памяти и базах данных, даёт минимальные рекомендации с расчётом риска. CX Codex ★ 6 505звёзд репо performance-engineer rohitg00 Субагент performance-engineer для поиска узких мест в коде через измерения, а не догадки. Профилирует, тестирует под нагрузкой и предлагает оптимизации на основе данных. CX Codex ★ 2 858звёзд репо performance-engineer qdhenry Субагент performance-engineer для Claude Code анализирует узкие места и помогает планировать работу над производительностью. Подключается к задачам масштабирования, профилирования и нагрузочного тестирования. CX Codex ★ 1 357звёзд репо go-performance-review eduardo-sl Скилл go-performance-review для Claude Code ищет узкие места в Go-коде и помогает проверять оптимизации бенчмарками и профилями. Анализирует горячие пути и снижение аллокаций. CX Codex +1 ★ 90звёзд репо m10-performance actionbook Скилл m10-performance для Claude Code помогает агенту профилировать Rust-код и устранять узкие места — от выбора алгоритма до лишних аллокаций. CX Codex +1 4 000установок backend-development-performance-engineer Seth Hobson Субагент backend-development-performance-engineer для Claude Code анализирует производительность новых функций и ищет узкие места. Запускайте его для ревью времени ответа, памяти и запросов во время разработки. CX Codex ★ 42 780звёзд репо go-performance cxuu Скилл go-performance для оптимизации Go: подсказывает, где заменить fmt на strconv, как задать ёмкость слайса и когда хватит strings.Builder. CX Codex +1 1 300установок performance-expert personamanagmentlayer Скилл performance-expert помогает профилировать код, искать узкие места в базах данных и настраивать кэширование под высокие нагрузки. CX Codex +1 198установок performance-tuner alirezarezvani Субагент performance-tuner для анализа узких мест в приложении, профилирования производительности и оптимизации кода. Помогает найти, что замедляет систему, и предложить конкретные улучшения. CX Codex ★ 788звёзд репо

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

Весь набор →
prompt-engineer Субагент prompt-engineer для Claude Code проектирует и проверяет промпты. Запускается для сборки eval-набора, настройки выдачи JSON по схеме или поиска причины, по которой RAG цитирует не те чанки. CX Codex ★ 489звёзд репо integration-engineer Субагент integration-engineer для Claude Code планирует стыки между системами: вебхуки с ретраями, ETL, брокеры и EDI. Он работает с системами с разными моделями данных. CX Codex ★ 489звёзд репо data-engineer Субагент data-engineer проектирует схемы баз данных, оптимизирует медленные SQL-запросы и строит ETL-пайплайны. Помогает подготовить безопасные миграции с обязательным откатом. CX Codex ★ 489звёзд репо solutions-architect Субагент solutions-architect картирует текущую и целевую архитектуру, проектирует интеграции и оценивает вендоров. Подключайте его для решений, затрагивающих несколько систем или команд. CX Codex ★ 489звёзд репо seo-specialist seo-specialist — субагент для Claude Code, Codex и Cursor. Проверяет поисковую оптимизацию, crawlability и разметку JSON-LD. CX Codex ★ 489звёзд репо code-review Скилл code-review для Claude Code задаёт порядок ревью изменений, классифицирует находки по серьёзности и оформляет их с файлами, строками и исправлениями. Проверяет диффы и новые файлы. CX Codex +1 ★ 489звёзд репо technical-writer Субагент technical-writer пишет README, API-документацию, ADR и JSDoc, предварительно читая код, чтобы описывать реальное поведение, а не то, что задумывалось. CX Codex ★ 489звёзд репо refactor Субагент refactor для рефакторинга кодовой базы без изменения её поведения. Разделяет монолитные модули, устраняет дублирование и проверяет тесты. CX Codex ★ 489звёзд репо

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

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