# graphql-expert

Субагент graphql-expert помогает проектировать GraphQL-схемы, разбирать запросы и находить проблемы производительности. Подключайте его при работе с API и архитектурой схемы.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 1029 у репозитория
- Автор: 0xfurai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/0xfurai/claude-code-subagents/tree/HEAD/agents/graphql-expert.md
- Обновлён: 2025-10-15
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/graphql-expert

## Что делает

\`graphql-expert` помогает проектировать GraphQL API: определяет корневые типы и связи, проверяет структуру схемы, предлагает интерфейсы, unions и подходы к документации через SDL и GraphiQL. Он также разбирает introspection, обработку ошибок и изменения схемы с учётом обратной совместимости.

Для запросов субагент ищет лишние поля и over-fetching, советует fragments, cursor-based pagination, batching и caching. Он учитывает rate limiting, анализ сложности запросов, subscriptions и нагрузку на resolvers. В результате может подготовить схему, оптимизированные запросы, тесты, конфигурацию GraphQL-сервера и рекомендации по мониторингу.

При real-time обновлениях без GraphQL subscriptions часть сценариев останется за пределами его подхода.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/graphql-expert.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/graphql-expert.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/graphql-expert.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/0xfurai/claude-code-subagents/tree/HEAD/agents/graphql-expert.md

## Когда брать
- спроектировать GraphQL-схему с понятными типами и связями
- оптимизировать запросы и убрать over-fetching
- настроить cursor-based pagination и batching
- проверить GraphQL API на риски и сложность запросов
- подготовить документацию и тесты для queries и mutations

## Примеры запросов агенту
- Спроектируй GraphQL-схему для каталога с корневыми типами, связями и cursor-based pagination.
- Проверь этот запрос на over-fetching, лишние поля и проблемы с производительностью resolvers.
- Подготовь план обновления схемы с обратной совместимостью, тестами и документацией в SDL.

## Похожие
- [graphql-api-development](https://affpapa.org/nevibecode/skills/graphql-api-development.md) — скилл · 449 установок
- [graphql](https://affpapa.org/nevibecode/skills/mindrally-graphql.md) — скилл · 726 установок
- [graphql-schema-designer](https://affpapa.org/nevibecode/skills/graphql-schema-designer.md) — скилл · 230 установок
- [api-scaffolding-graphql-architect](https://affpapa.org/nevibecode/agents/api-scaffolding-graphql-architect.md) — субагент · ★ 42780 у репозитория
- [graphql-architect](https://affpapa.org/nevibecode/agents/qdhenry-graphql-architect.md) — субагент · ★ 1357 у репозитория
- [implement-graphql-api](https://affpapa.org/nevibecode/commands/buildwithclaude-community-implement-graphql-api.md) — команда · ★ 3785 у репозитория

Из того же набора: [0xfurai/claude-code-subagents](https://affpapa.org/nevibecode/by/0xfurai/claude-code-subagents.md) — 137 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
