GraphQL设计
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/kunlun-graphql-api-design。
技能介绍
要解决什么问题
GraphQL 服务上线后,常见问题并不是「会不会写 query」,而是 schema 怎么演进、resolver 评审有没有统一标准、以及 N+1、越权、错误码不可机读 这类联调与线上问题反复出现。团队在 PR 里改类型与 DataLoader 时,往往先争论命名风格,却漏掉并发边界和鉴权路径;写技术方案时也缺少把「为什么不用 REST 聚合」讲清楚的结构。
技能如何工作
本技能以 @kunlungrowth/kunlun-graphql-api-design 为 GraphQL 设计场景,用触发词路由到六类能力:听到 review/评审/CR 时对 diff/PR 产出 阻断/建议/可选 分级清单;设计/方案/架构 时按背景/目标/选型/风险填方案模板;debug/报错/排查 时走 稳定复现 → 隔离变量 → 看日志链路 → 假设验证;接口/API/契约 侧重类型、字段、变更操作与错误契约;选型/对比/架构 输出利弊与成本表;规范/最佳实践 给清单与反模式。
文档中的 3.1 代码评审 与 3.2 线上排错 工作流可直接套在 GraphQL 改动上:先读意图与正确性,再谈风格;排错时禁止未复现就改 resolver。
适用边界
输出是方法论、模板与检查清单,不接入付费服务、不处理真实密钥,也不替代合并决策或专业资质判断。若结果不够贴场景,在输入里补充人群、流量规模与 schema 约束即可让对应能力收紧交付物。
使用场景
- 新模块要定 GraphQL 类型与 query/mutation 字段契约,需按模板写出可评审的方案说明
- PR 改动 resolver 与 DataLoader,要用分级清单查 N+1、空值边界与鉴权遗漏
- 线上 GraphQL 查询超时或 partial error,需按复现与链路证据做二分定位
- 在网关、Federation 与单体 schema 之间选型,需利弊与运维成本对比表支撑评审
适合人员
- 维护 GraphQL BFF 的后端工程师,发版前要对 schema 与 resolver 变更做结构化 CR
- 全栈工程师接手遗留 GraphQL 服务,需补背景、选型理由与回滚策略的技术方案
- 技术负责人对 REST 聚合与 GraphQL 并存做架构决策,要可讨论的对比表而非口头拍板
- 独立开发者自建 SaaS API,希望用契约清单统一命名、错误码与版本兼容策略