AIKraft/AI/Войти
AIKraft/Skills/Схема GraphQL

Схема GraphQL

Guide for designing GraphQL schemas following industry best practices. Use this skill when: (1) designing a new GraphQL schema or API, (2) reviewing existing schema for improvements, (3) deciding on type structures or nullability, (4) implementing pagination or error patterns, (5) ensuring security in schema design.

apollographql official Дизайн

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

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

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

  • Проектирование новой схемы или API GraphQL с нуля.
  • Анализ существующей схемы на предмет улучшений и соответствия best practices.
  • Выбор правильных структур типов и правил nullability (обязательности полей).
  • Реализация пагинации (Connection pattern) или паттернов обработки ошибок.
  • Обеспечение безопасности и эволюционируемости схемы без нарушения обратной совместимости.

Как работает

  1. Проектируйте типы на основе концепций домена и потребностей клиентов, а не структуры базы данных.
  2. Используйте явные имена, описания (descriptions) для всех типов и полей, а также намеренно задавайте nullability.
  3. Применяйте паттерн [Type!]! для списков, чтобы избежать null-элементов и использовать пустой список вместо null.
  4. Разделяйте типы ввода (input) и вывода (output), используя input-типы для мутаций с единственным аргументом.
  5. Планируйте эволюцию схемы: используйте deprecation перед удалением и избегайте добавления обязательных аргументов без значений по умолчанию.
  6. Реализуйте пагинацию для списков, которые могут расти без ограничений, используя Connection pattern и курсоры.

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

Как спроектировать схему GraphQL для системы пользователей, чтобы она была удобна для клиента и легко расширялась?
Проанализируй мою текущую схему GraphQL на предмет нарушений принципов nullability и пагинации.
Какие best practices следует применить для мутаций, чтобы обеспечить безопасность и четкое разделение ввода и вывода?

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

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

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

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