performance-profiler — субагент для Claude Code: профилирование
Субагент для Claude, который ищет узкие места в производительности, утечки памяти и просадки под нагрузкой. Пригодится, когда приложение тормозит, а причина неочевидна.
npx claude-code-templates@latest --agent development-tools/performance-profilerЧто делает performance-profiler
Субагент работает по нескольким направлениям: время ответа и пропускная способность, утечки памяти и сборка мусора, загрузка CPU, ответы API, запросы к базе и метрики фронтенда вроде размера бандла. Сначала он снимает базовые замеры, потом сравнивает с ними результаты после правок.
Внутри — готовые скрипты профилирования для Node.js. Они используют perf_hooks, v8-profiler-next и @airbnb/node-memwatch, поэтому эти пакеты должны быть в проекте. Скрипт пишет отчёты в каталог ./performance-reports: профиль CPU в .cpuprofile, снимок кучи в .heapsnapshot. Есть замер задержки event loop и порог предупреждения, если средняя задержка превышает 10 мс.
Субагент вызывается проактивно — сам подключается, когда задача пахнет производительностью. Инструменты у него ограничены чтением, записью, правкой файлов и Bash, так что запускать внешние сервисы мониторинга он не станет. Для анализа профиля CPU нужен файл, который скрипт уже сохранил: без запуска профилировщика в вашем приложении разбирать будет нечего.
Какие задачи решает
- найти функцию, которая съедает больше всего CPU
- поймать утечку памяти и снять снимок кучи
- замерить задержку event loop под нагрузкой
- сравнить производительность до и после правок
- разобрать медленные запросы к базе и ответы API
Примеры запросов агенту
- профилируй CPU этого Node.js-сервиса и покажи топ горячих функций
- проверь, нет ли утечки памяти в обработчике очереди
- сравни метрики до и после оптимизации запроса к базе
Как установить performance-profiler
1Через claude-code-templates
npx claude-code-templates@latest --agent development-tools/performance-profiler2Вручную: положить файлы
.claude/agents/performance-profiler.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/performance-profiler.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/performance-profiler.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о performance-profiler
Как установить performance-profiler в Claude?
Через шаблоны: npx claude-code-templates@latest --agent development-tools/performance-profiler. Файл субагента появится по пути .claude/agents/performance-profiler.md.
Что делает performance-profiler?
Профилирует приложение: замеряет время ответа, загрузку CPU, утечки памяти, задержку event loop и работу с базой. По результатам предлагает, что оптимизировать.
Что нужно для работы скриптов профилирования?
Node.js-скрипты опираются на пакеты v8-profiler-next и @airbnb/node-memwatch, а также на встроенный perf_hooks. Отчёты складываются в ./performance-reports.
