⚡

GraphQL模式设计专家Skill graphql-schema-designer

GraphQL模式设计专家技能专注于GraphQL API的模式设计、优化与维护，支持联邦模式和高级设计模式。核心功能包括类型安全设计、查询复杂度优化、分页实现、实时订阅配置以及自动化文档生成。适用于微服务架构下的API整合、高性能数据查询场景以及多客户端SDK开发。关键词：GraphQL模式设计、API优化、联邦模式、类型安全、查询性能、微服务集成、Apollo、模式拼接、数据解析器、实时API。

后端开发 0 次安装 0 次浏览 更新于 2/25/2026

name: graphql-schema-designer description: 支持联邦模式的GraphQL模式设计与优化 allowed-tools:

  • Read
  • Write
  • Edit
  • Glob
  • Grep
  • Bash

GraphQL模式设计专家技能

概述

此技能专精于设计、优化和维护GraphQL模式，支持模式拼接、联邦模式和高级设计模式。确保构建类型安全、高性能且文档完善的GraphQL API。

能力范围

  • 遵循最佳实践设计类型安全的GraphQL模式
  • 实现模式拼接和Apollo联邦模式
  • 优化查询复杂度并配置深度限制
  • 生成全面的模式文档
  • 设计高效的数据解析器模式
  • 实现分页功能（Relay连接、基于偏移量）
  • 配置订阅和实时功能
  • 根据设计指南验证模式

目标流程

  • API设计规范
  • 多语言SDK策略
  • SDK架构设计

集成点

  • Apollo Server/Client
  • Hasura GraphQL引擎
  • graphql-codegen用于类型生成
  • GraphQL Inspector用于模式验证
  • Relay编译器

输入要求

  • 领域模型或实体定义
  • 查询需求和使用场景
  • 性能要求（复杂度限制）
  • 联邦模式要求（如微服务架构）

输出成果

  • GraphQL SDL模式文件
  • 联邦子图配置
  • 用于客户端生成的类型定义
  • 模式文档
  • 查询复杂度分析报告

使用示例

skill:
  name: graphql-schema-designer
  context:
    domainModel: ./docs/domain-model.md
    federationEnabled: true
    complexityLimit: 1000
    depthLimit: 10
    generateDocumentation: true

最佳实践

  1. 使用有意义的类型和字段名称
  2. 实施适当的可空性模式
  3. 从一开始就为分页进行设计
  4. 记录所有类型和字段
  5. 使用接口实现多态性
  6. 使用联合类型实现适当的错误处理