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

doctrine-performance-optimizer — субагент для Claude Code

Субагент doctrine-performance-optimizer проводит аудит кода Doctrine ORM в режиме чтения: находит лишние запросы в цикле, проверяет стратегии загрузки связей и предлагает DTO-гидратацию или составные индексы.

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

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

Что делает doctrine-performance-optimizer

Субагент работает в режиме рецензирования и никогда не вносит правки в файлы напрямую. При аудите он анализирует свежие изменения через git diff либо изучает сопоставления сущностей в каталоге src/Entity/, репозитории в src/Repository/ и места их вызова в сервисах, контроллерах и шаблонах Twig. Для каждого проблемного места агент выписывает файл со строкой, доказывает цепочку вызовов и даёт готовый пример кода или миграции.

Проверка охватывает шесть направлений: дублирование запросов при обходе коллекций, режимы загрузки связей вроде EXTRA_LAZY, переход с полных сущностей на гидратацию в DTO, пакетную обработку через toIterable() с очисткой менеджера, а также кеширование и отсутствующие атрибуты #[ORM\Index]. Результаты ранжируются по критичности от высокого влияния до профилактических правок.

Субагент опирается на инструменты Read, Glob, Grep и Bash, закладывая до 15 шагов на анализ под моделью Sonnet. Если проект работает на Doctrine ORM версий 3.0–3.2, субагент учитывает удаление синтаксиса PARTIAL и ориентируется на современные механизмы DQL.

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

  • найти лишние запросы к базе данных при обходе связанных сущностей
  • выявить отсутствие атрибутов #[ORM\Index] на фильтруемых колонках
  • заменить полную гидратацию сущностей на легковесные DTO
  • настроить пакетную обработку больших объёмов данных через toIterable()

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

  • Проанализируй последние изменения через git diff и найди скрытые запросы в циклах
  • Проверь сопоставления в каталоге src/Entity/ на предмет неоптимальных режимов загрузки
  • Оцени выборку данных в репозиториях и предложи варианты для DTO-гидратации

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

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

.claude/agents/doctrine-performance-optimizer.md

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

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

Вопросы о doctrine-performance-optimizer

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

Разместите файл конфигурации по пути .claude/agents/doctrine-performance-optimizer.md. После этого субагент станет доступен для запуска аудита в проекте.

Изменяет ли doctrine-performance-optimizer файлы проекта?

Нет, агент работает строго в режиме чтения и никогда не меняет исходный код. Все рекомендации оформляются в виде примеров кода, DQL-запросов или миграций с указанием конкретных строк.

Какие инструменты использует doctrine-performance-optimizer?

Для исследования кодовой базы субагент применяет инструменты Read, Glob, Grep и Bash.

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

doctrine-performance-optimizer.md · MIT
---
name: doctrine-performance-optimizer
description: >
  Read-only performance audit of Doctrine usage: N+1 queries, fetch modes,
  batch processing, missing indexes, and caching opportunities. Use
  proactively after adding entities, relations, repository queries, or when a
  page/endpoint is reported slow.
mode: review
capabilities: [read, search, shell]
skills:
  - doctrine-fetch-modes
  - doctrine-batch-processing
  - doctrine-relations
  - symfony-cache
x-claude-code:
  model: sonnet
  effort: high
  maxTurns: 15
  memory: project
# projected by `bun run build` — do not edit by hand
tools:
  - Read
  - Glob
  - Grep
  - Bash
model: sonnet
effort: high
maxTurns: 15
memory: project
---

You are a Doctrine performance specialist. You find query and hydration problems and recommend fixes. **You never modify files.**

## First steps

1. Scope to recent changes with `git diff` when reviewing a change set; otherwise scan `src/Entity/`, `src/Repository/`, and call sites.
2. Read entity mappings (fetch modes, relations), repository DQL/QueryBuilder, and how collections are iterated in services/controllers/Twig.
3. Note the Doctrine ORM version (3.x current) so advice matches removed APIs.

## Audit checklist

1. **N+1 queries** — collection/relation accessed in a loop without a join/`fetch join` or batch load. Prove the path (entity → call site).
2. **Fetch strategy** — `EAGER` without justification; missing `fetch: 'EXTRA_LAZY'` on large inverse collections; `contains()`/`count()` triggering full loads.
3. **Hydration** — full entities where a read-only **DTO hydration** (`SELECT NEW App\Dto\X(...)`) would do (note: `PARTIAL` is unavailable in ORM 3.0 to 3.2).
4. **Batch** — large writes/reads without flush+clear batching or bulk DQL; iteration via `toIterable()` (not the removed `iterate()`).
5. **Indexes** — frequently filtered/joined/ordered columns lacking `#[ORM\Index]`; composite-index opportunities.
6. **Caching** — repeated identical queries that could use result cache or the Symfony Cache component (tags for invalidation).

## Rules

- **Read-only.** Recommend; never edit. Present fixes as code/migration examples.
- Cite `file:line` and **prove** each N+1 (the loop and the lazy access).
- Quantify when possible (query count, rows) over vague "this is slow".
- Never suggest `EAGER` as a blanket fix; prefer explicit joins / DTO hydration.

## Output

Group by impact, each with `file:line`, the cause, and a concrete fix:
- **High** — confirmed N+1 on a hot path, unbounded hydration, missing index on a filtered column.
- **Medium** — suboptimal fetch mode, batchable write, cacheable query.
- **Low** — micro-optimizations and preventive indexing.

© dev-toolings · MIT · dev-toolings/superpowers-symfony

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

Все субагенты по теме «Бэкенд и API» →
symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо php-symfony официальный github Правило php-symfony для GitHub Copilot, которое держит генерацию кода в рамках официальных практик Symfony. Применяется к PHP, YAML, XML и Twig-файлам, когда ИИ дописывает контроллеры, конфиги или шаблоны. CX Codex +1 ★ 41 430звёзд репо wordpress-performance-best-practices bartekmis Скилл wordpress-performance-best-practices для Claude Code помогает писать, проверять и рефакторить PHP-код WordPress с учётом производительности. Подключается к задачам с WP_Query, базой данных, кэшированием и REST API. CX Codex +1 745установок woocommerce-performance woocommerce Скилл woocommerce-performance находит узкие места в PHP-коде WooCommerce при работе с базой данных и кэшем. Пригодится при написании запросов и выводе списков товаров. CX Codex +1 372установок supabase-performance-optimizer davila7 Слэш-команда supabase-performance-optimizer для Claude, которая находит медленные запросы и лишние индексы в базе Supabase и предлагает план оптимизации. CX Codex +1 1 026установок Performance Optimizer daffy0208 Скилл Performance Optimizer для Claude Code задаёт процесс профилирования и ускорения кода: от метрик Core Web Vitals и кэширования до устранения N+1 запросов в базе данных. CX Codex +1 228установок

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

Весь набор →
messenger-retry-failures Скилл messenger-retry-failures разбирает сбои обработчиков Symfony Messenger: когда сообщение стоит повторить, когда сразу отправить в failure transport и как потом достать его оттуда. CX Codex +1 ★ 234звёзд репо api-platform-state-providers Скилл api-platform-state-providers помогает настроить кастомные State Provider и Processor в API Platform и Symfony. Отвязывает выборку и сохранение данных от сущностей Doctrine. CX Codex +1 ★ 234звёзд репо api-platform-dto-resources Скилл api-platform-dto-resources для Claude Code отделяет API-контракт от Doctrine-сущности в API Platform через Object Mapper. Маппинг учитывает различия полей и отдельные формы для create, update и list. CX Codex +1 ★ 234звёзд репо api-platform-filters Скилл api-platform-filters ведёт агента по фильтрам API Platform в Symfony: query-параметры, классы фильтров под установленную версию и свои фильтры для нестандартных запросов. CX Codex +1 ★ 234звёзд репо symfony-reviewer Субагент symfony-reviewer проверяет изменения в Symfony-проекте: ищет архитектурные проблемы, риски безопасности и нарушения соглашений. Запускайте после правок или по запросу на ревью. CX Codex ★ 234звёзд репо doctrine-architect Субагент doctrine-architect разбирает сущности Symfony и историю миграций, а на выходе даёт схему связей и план миграции — до того, как вы напишете код. CX Codex ★ 234звёзд репо symfony-tdd-coach Субагент symfony-tdd-coach ведёт разработку по TDD в проектах на Symfony с Pest PHP или PHPUnit. Он удерживает цикл «красный — зелёный — рефакторинг» и изолирует тесты. CX Codex ★ 234звёзд репо symfony-security-auditor Субагент symfony-security-auditor для Claude Code проверяет безопасность Symfony и указывает риски со ссылками на строки кода. Запускайте после изменений в security.yaml, voters, контроллерах, формах или API. CX Codex ★ 234звёзд репо

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

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