用途
本技能面向 GraphQL 的 schema 设计、查询、变更(mutation)与工具链。当用户提出“编写 GraphQL schema”“创建查询”“添加 mutation”“设置 Apollo”等需求时使用。
主要能力
Schema 定义
支持类型定义,例如 User、Post、Tag 等对象类型,字段可带 ID、String、Boolean、DateTime 等类型与必填标记。支持输入类型(CreateUserInput、UpdateUserInput、PostFilter)、枚举(Role、SortOrder)、自定义标量(DateTime、JSON)、接口(Node)与联合类型(SearchResult = User | Post | Tag)。
查询
Query 类型支持单条查询(user、post)、带过滤与分页的列表查询(users、posts)、搜索(search)以及当前用户(me)。分页支持基于游标的连接模式,包含 edges、pageInfo、totalCount 等结构。查询示例涵盖基本查询、带变量查询、片段(fragment)与分页查询。
变更
Mutation 类型支持 createUser、updateUser、deleteUser、createPost、publishPost、login 等操作,并提供 AuthPayload 返回 token 与 user。示例包含带变量的创建用户与登录变更。
订阅
Subscription 类型支持 postCreated、messageReceived(channelId) 等,并给出客户端订阅用法示例。
解析器(Node.js)
提供 Query、Mutation、User 等解析器示例,展示如何通过 context 访问数据库并处理字段解析。
错误处理
支持基于联合类型的错误模式,例如 CreateUserResult = CreateUserSuccess | ValidationError | EmailTakenError,并给出对应类型定义与 Mutation 返回类型。
参考
关于 Apollo、Relay 与测试模式,参见 references/tooling.md。
使用方式
该技能以文档与代码示例形式提供,用户可依据其中的 schema 定义、查询、变更、订阅、解析器与错误处理示例进行 GraphQL 开发。具体安装或集成步骤暂未提供。
适用场景
适用于需要设计 GraphQL schema、编写查询与变更、实现分页与搜索、设置订阅、编写 Node.js 解析器或处理 GraphQL 错误的开发场景。
限制
资料未提供具体的收费、价格、平台支持范围或效果保证信息。