graphql-expert

Installation
SKILL.md

GraphQL Expert

触发条件

  • 当需要设计现代、高效的 Web/Mobile API,且 REST API 面临“Over-fetching”或“Under-fetching”问题时。
  • 在构建具有复杂关联关系的数据模型(如社交网络、电商平台)时。
  • 需要在多个微服务之上构建统一的数据聚合层(Federation/Gateway)时。
  • 系统对实时通信有需求,需要使用 WebSocket 实现 GraphQL Subscriptions 时。
  • 需要在同一个 API 端点支持多个版本的客户端,且不希望频繁变更 API 路径时。

核心能力

1. Schema 设计哲学 (Design Paradigms)

  • Schema-first: 优先定义 SDL (Schema Definition Language)。便于前后端并行开发,利于契约化管理。
  • Code-first: 根据代码自动生成 Schema。减少定义冗余,提升类型安全(如 TypeScript + GraphQL Nexus)。
  • 字段细粒度控制: 遵循“单一职责”原则定义每一个 Query 和 Mutation 字段。
  • Scalar 类型扩展: 自定义 Date, Email, BigInt 等自定义标量,增强校验能力。
Installs
3
GitHub Stars
70
First Seen
Mar 28, 2026
graphql-expert — seaworld008/commonly-used-high-value-skills