技能介绍

它解决什么问题

在联邦 GraphQL 架构下，一个聚合图（supergraph）由多个子图（subgraph）组合而成。子图一旦各自独立演进，常见的痛点就会浮出水面：模式组合校验缺失，问题直到线上才暴露；字段删除或类型收窄这类破坏性变更无人察觉；各子图命名风格不一致，Code Review 变成风格之争。这个技能把这些校验工作从临时 CI 脚本和团队记忆里抽出来，交给统一的代理流程处理。

核心能力

模式组合校验：借助 Apollo Studio API 与 Hive Schema Registry，校验子图能否正确组合成可用的聚合图
破坏性变更检测：识别字段删除、类型变更等 breaking changes，避免波及下游消费者
命名规范约束：跨子图服务强制统一的命名约定，减少协作摩擦

关键步骤

将子图 schema 注册到 Hive Schema Registry
通过 Apollo Studio API 触发组合校验
与历史版本比对，输出破坏性变更清单
按命名规范扫描各子图并报告违规项

适用边界与注意点

能力发挥依赖 Apollo Studio API 与 Hive Schema Registry 的可用配置，未接入这两个系统时流程无法完整运转
GraphQL.js 是通用库，Node 服务中 CommonJS（require()）与 ESModule（import）文件均可使用，模块解析方式需要自行确认
资料注明该技能源自上游文档抽取，覆盖范围以官方文档为准，使用前建议对照官方说明核对