graphql-performance-optimizer — субагент для Claude Code: скорость
Субагент разбирает медленные GraphQL-запросы: находит N+1, ставит DataLoader, настраивает кеширование. Пригодится, когда список пользователей грузится секундами.
npx claude-code-templates@latest --agent api-graphql/graphql-performance-optimizerЧто делает graphql-performance-optimizer
Субагент работает с готовым кодом: читает файлы резолверов, ищет вызовы базы на каждую запись и переписывает их на пакетную загрузку через DataLoader. Схему при этом не трогает. Ещё он умеет включать Automatic Persisted Queries на Apollo Server, подключать Redis-хранилище и расставлять cache-control по полям, чтобы ответы коротких GET-запросов забирал CDN.
Для федеративного графа у него другой набор приёмов: кеш плана запроса на роутере, DataLoader в контексте каждого запроса и пакетная загрузка через __resolveReference для сущностей. Так схлопываются межсервисные выборки, из-за которых p95 упирается в сотни миллисекунд.
Инструменты у агента — Read, Grep, Glob, Edit, Write, Bash, модель sonnet, режим прав acceptEdits. То есть он сам правит файлы, и это повод держать проект под git перед запуском. Есть отдельная оговорка: темы безопасности — allowlisting запросов, кеш авторизации, контроль introspection — он не берёт, для них есть graphql-security-specialist.
Какие задачи решает
- найти N+1 в резолвере и переписать его на DataLoader
- сократить число обращений к origin на публичном API
- закешировать план запроса в федеративном графе
- убрать лишний
SELECT COUNT(*)в connection-полях - сравнить число запросов до и после правки
Примеры запросов агенту
- Найди N+1 в резолверах списка пользователей и перепиши их на DataLoader
- Настрой APQ и кеш CDN для нашего Apollo Server
- Добавь кеш плана запроса на роутере и пакетную загрузку сущностей
Как установить graphql-performance-optimizer
1Через claude-code-templates
npx claude-code-templates@latest --agent api-graphql/graphql-performance-optimizer2Вручную: положить файлы
.claude/agents/graphql-performance-optimizer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/graphql-performance-optimizer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/graphql-performance-optimizer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Из того же набора184
Весь набор →Похожие
Рядом в теме «Бэкенд и API»
Все субагенты по теме «Бэкенд и API» →Вопросы о graphql-performance-optimizer
Как установить graphql-performance-optimizer в Claude?
Через шаблоны: npx claude-code-templates@latest --agent api-graphql/graphql-performance-optimizer. Файл агента появится по пути .claude/agents/graphql-performance-optimizer.md.
Что делает graphql-performance-optimizer?
Анализирует производительность GraphQL API и правит код: N+1 в резолверах, стратегии кеширования, пакетную загрузку сущностей. Схему он не меняет.
Он трогает темы безопасности?
Нет. Контроль allowlisting запросов, кеш авторизации и управление introspection он оставляет агенту graphql-security-specialist.
