关于 graphql-implementation
面向 API 开发者的 GraphQL 实现技能，涵盖 Schema 设计、解析器、错误处理与性能优化，并提供 Apollo Server 和 Graphene 参考指南。
主要功能
- 01Schema 与类型设计
- 02解析器和变更模式
- 03错误处理与输入验证
- 04订阅和实时数据
- 05性能与联邦指导
适用场景
- 01设计新的 GraphQL API
- 02实现解析器和变更
- 03添加实时订阅
- 04优化 API 性能
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/graphql-implementation确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/error-handling.mdgraphql-schema-design.mdnodejs-apollo-server-implementation.mdpython-graphql-implementation-graphene.mdquery-examples.mdscripts/validate-api.shtemplates/api-scaffold.yaml详细介绍
GraphQL 实现
目录
概述
通过合理的架构设计、解析器模式、错误处理和性能优化，实现 GraphQL API，支持灵活的客户端-服务端通信。
适用场景
- 设计新的 GraphQL API
- 创建 GraphQL 架构和类型
- 实现解析器和变更
- 添加实时数据订阅
- 从 REST 迁移到 GraphQL
- 优化 GraphQL 性能
快速开始
最简可运行示例：
type User {
id: ID!
email: String!
firstName: String!
lastName: String!
role: UserRole!
posts: [Post!]!
createdAt: DateTime!
updatedAt: DateTime!
}
enum UserRole {
ADMIN
USER
MODERATOR
}
type Post {
id: ID!
title: String!
content: String!
author: User!
comments: [Comment!]!
publishedAt: DateTime
createdAt: DateTime!
// ... (see reference guides for full implementation)
参考指南
references/ 目录中的详细实现：
| 指南 | 内容 |
|---|---|
| GraphQL 架构设计 | GraphQL 架构设计 |
| Node.js Apollo Server 实现 | Node.js Apollo Server 实现 |
| Python GraphQL 实现（Graphene） | Python GraphQL 实现（Graphene） |
| 查询示例 | 查询示例 |
| 错误处理 | 错误处理 |
最佳实践
✅ 应该做
- 使用清晰且具有描述性的字段名
- 根据客户端需求设计架构
- 实现恰当的错误处理
- 在变更中使用输入类型
- 添加实时数据订阅
- 高效缓存解析器
- 验证输入数据
- 使用联邦实现可扩展性
❌ 不应该做
- 过度嵌套查询
- 暴露内部数据库 ID
- 未经授权就返回敏感数据
- 创建过于复杂的架构
- 忘记处理 null 值
- 忽视 N+1 查询问题
- 省略错误消息
评论
支持 Markdown