GraphQL 模式文档构建器

要解决的问题

GraphQL 的 SDL 写到最后，字段加了又删、类型互相引用，团队里没人愿意再维护一份静态文档。手写文档容易和 schema 脱节，审查时也看不出字段被弃用或关系链断裂。

这个技能做什么

• 用 graphql-js 的内省查询读取 SDL，生成可交互的 API 文档。
• 渲染类型关系图，把 Query、Mutation 和各类型字段之间的依赖画清楚。
• 自动产出查询示例，减少手动补例子的成本。
• 对标记为 deprecated 的字段输出弃用提示，避免调用方继续使用。
• 关键步骤：内省 → 结构化 → SpectaQL 渲染 → 输出静态页面。

适用边界

• 输入必须是合法的 GraphQL schema，最好来自 .graphql 文件或可解析的 SDL 字符串。
• 依赖上游 graphql 包；跨环境安装时要按 Node 服务是 CommonJS 还是 ESModule 选对应方式。
• 文档质量取决于内省结果，schema 本身不规范时，图表和示例也会失真。