Навыки GraphQL Architect
📦

GraphQL Architect

Безопасно

Проектирование масштабируемых GraphQL API с использованием корпоративных паттернов

Создание производственных систем GraphQL требует экспертизы в области федерации, производительности и безопасности. Этот навык предоставляет проверенные паттерны для масштабируемого проектирования схем и оптимизации.

Поддерживает: Claude Codex Code(CC)
📊 69 Адекватно
1

Скачать ZIP навыка

2

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

3

Включите и начните использовать

Протестировать

Использование «GraphQL Architect». Спроектируйте схему профиля пользователя с публикациями и комментариями

Ожидаемый результат:

  • type User {
  • id: ID!
  • username: String!
  • email: String!
  • profile: Profile
  • posts: [Post!]!
  • createdAt: DateTime!
  • }
  •  
  • type Profile {
  • bio: String
  • avatar: String
  • location: String
  • }
  •  
  • type Post {
  • id: ID!
  • title: String!
  • content: String!
  • author: User!
  • comments: [Comment!]!
  • }

Использование «GraphQL Architect». Оптимизируйте получение резольвером публикаций пользователя

Ожидаемый результат:

  • Используйте DataLoader для пакетного получения и кэширования публикаций пользователя:
  •  
  • const postLoader = new DataLoader(async (userIds) => {
  • const posts = await Post.findAll({
  • where: { userId: userIds },
  • include: [User],
  • });
  • return userIds.map(id => posts.filter(p => p.userId === id));
  • });
  •  
  • Это сокращает N запросов до 1 пакетного запроса.

Аудит безопасности

Безопасно
v1 • 2/25/2026

Static analysis scanned 0 files with 0 lines and detected no suspicious patterns. This is a prompt-only skill containing instructional content for GraphQL architecture guidance. No executable code, network access, filesystem operations, or external command execution present.

0
Просканировано файлов
0
Проанализировано строк
0
находки
1
Всего аудитов
Проблем безопасности не найдено
Проверено: claude

Оценка качества

38
Архитектура
100
Сопровождаемость
87
Контент
32
Сообщество
100
Безопасность
74
Соответствие спецификации

Что вы можете построить

Архитектура корпоративной федерации

Спроектируйте много командную федеративную GraphQL-архитектуру с композицией подграфов, управлением схемой и паттернами межкомандного сотрудничества.

Аудит оптимизации производительности

Проанализируйте существующие GraphQL-схемы на наличие N+1 запросов, реализуйте паттерны DataLoader и настройте многоуровневые стратегии кэширования.

Реализация усиления безопасности

Реализуйте авторизацию на уровне полей, анализ сложности запросов, ограничение частоты и конфигурации безопасности для продакшена.

Попробуйте эти промпты

Базовое проектирование схемы 
Спроектируйте GraphQL-схему для [тип ресурса] с операциями CRUD. Включите соответствующие скалярные типы, типы ввода для мутаций и следуйте соглашениям об именовании. Объясните связи между типами.
Планирование подграфа федерации 
Спланируйте подграф Apollo Federation v2 для [домен]. Определите сущности, директивы key и внешние ссылки на типы. Покажите, как этот подграф интегрируется в общую федеративную архитектуру.
Аудит оптимизации производительности 
Проверьте эту GraphQL-схему и реализацию резольверов на наличие проблем с производительностью. Определите паттерны N+1 запросов, предложите реализации DataLoader и рекомендуйте стратегии кэширования на уровне полей и запросов.
Аудит конфигурации безопасности 
Проверьте конфигурацию этого GraphQL-сервера на наличие уязвимостей. Проверьте настройки интроспекции, конфигурацию CORS, ограничение частоты запросов, ограничение глубины запросов и авторизацию на уровне полей. Предоставьте конкретные шаги по исправлению.

Лучшие практики

  • Проектируйте схемы с учетом версионирования и эволюции — используйте устаревание перед удалением
  • Реализуйте DataLoader для всех получений резольверов для предотвращения проблем с N+1 запросами
  • Настройте анализ сложности запросов и ограничение частоты запросов перед развертыванием в продакшен

Избегать

  • Представление моделей базы данных напрямую в GraphQL-схеме без слоев абстракции
  • Возврат неограниченных списков без паттернов подключения или пагинации
  • Реализация бизнес-логики в резольверах вместо выделенных сервисных слоев

Часто задаваемые вопросы

Что такое Apollo Federation и когда его следует использовать?
Apollo Federation позволяет разделить GraphQL-схему между несколькими сервисами. Используйте его, когда несколько команд владеют разными доменами или когда микросервисам нужно предоставлять унифицированные GraphQL API.
Как предотвратить проблемы с N+1 запросами в GraphQL?
Используйте DataLoader для пакетирования и кэширования запросов к базе данных. DataLoader собирает отдельные запросы и выполняет их как один пакетный запрос, значительно сокращая количество обращений к базе данных.
Какие меры безопасности необходимы для GraphQL API в продакшене?
Реализуйте ограничение глубины запросов, анализ сложности запросов, ограничение частоты, авторизацию на уровне полей, отключите интроспекцию в продакшене и настройте правильные заголовки CORS.
Как обрабатывать аутентификацию в GraphQL-резольверах?
Извлеките аутентификацию из контекста в настройке Apollo Server. Получите доступ к информации о пользователе через context.user в резольверах и реализуйте проверки на уровне полей с использованием промежуточного ПО или паттернов директив.
В чем разница между запросами и мутациями?
Запросы получают данные и могут быть закэшированы. Мутации изменяют данные и всегда выполняются. Используйте запросы для операций чтения и мутации для операций создания, обновления или удаления.
Как реализовать функции реального времени в GraphQL?
Используйте GraphQL-подписки с WebSocket-соединениями. Определите типы подписок в вашей схеме, реализуйте механизмы pubsub и обеспечьте правильную авторизацию и очистку при отключении.

Сведения для разработчиков

Автор

sickn33

Лицензия

MIT

Репозиторий

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/graphql-architect

Ссылка

main

Структура файлов

📄 SKILL.md