AIKraft/AI/Войти
AIKraft/Skills/Операции GraphQL

Операции GraphQL

Guide for writing GraphQL operations (queries, mutations, fragments) following best practices. Use this skill when: (1) writing GraphQL queries or mutations, (2) organizing operations with fragments, (3) optimizing data fetching patterns, (4) setting up type generation or linting, (5) reviewing operations for efficiency.

apollographql official Документы

Что делает навык

Навык предоставляет руководство по написанию эффективных, типобезопасных и поддерживаемых GraphQL-операций (запросов, мутаций, подписок) для клиентских разработчиков. Он обеспечивает соблюдение лучших практик, начиная с работы с реальной схемой проекта и заканчивая оптимизацией структуры запросов.

Когда применять

  • Написание новых GraphQL-запросов или мутаций на основе актуальной схемы проекта.
  • Организация операций с использованием фрагментов для улучшения читаемости и переиспользования кода.
  • Оптимизация паттернов получения данных для повышения эффективности запросов.
  • Настройка генерации типов или линтинга для обеспечения типобезопасности.
  • Проверка операций на эффективность и соответствие стандартам проекта.

Как работает

  1. Найти схему проекта, проверив конфигурационные файлы (codegen.ts, graphql.config.*, apollo.config.*) или файлы SDL (*.graphql).
  2. Использовать только поля, аргументы и значения перечислений, определенные в схеме проекта, избегая иллюстративных примеров.
  3. Сохранить документ с операцией рядом с существующими операциями клиента.
  4. Не изменять схему сервера, если пользователь явно не запросил изменения схемы.
  5. Структурировать запросы и мутации в соответствии с лучшими практиками для обеспечения типобезопасности и поддерживаемости.

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

Напиши GraphQL-запрос для получения списка пользователей с их именами и датами создания, используя схему из codegen.ts.
Создай мутацию для обновления профиля пользователя с использованием фрагментов для полей профиля.
Проверь эффективность следующего GraphQL-запроса и предложи оптимизации на основе схемы проекта.

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «graphql-operations» из репозитория: # https://github.com/apollographql/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r graphql-operations/ ~/.claude/skills/graphql-operations/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.