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 等自定义标量,增强校验能力。