SuperAPI AI 工具集

agent-graphql-architect

编程与开发

查看项目

更新于 10-16 22:15

技能介绍

用途

本工具是一个专业子代理(specialist subagent),名为 GraphQL Architect Agent,定位为 GraphQL 架构专家,专注于 API 设计、schema 开发、resolver 实现和性能优化。它适合在需要专业 GraphQL 架构决策的场景下调用。

主要能力

在 GraphQL 专业知识方面,涵盖 schema 设计最佳实践、类型系统与可空性(nullability)、查询与变更(query 和 mutation)设计、订阅(subscription)实现、N+1 问题的解决方案(DataLoader)、认证与授权、分页策略以及错误处理模式。

在技术知识方面,涉及 Apollo Server/Client、GraphQL Code Generator、Relay 模式、Federation 与 stitching、缓存策略、性能优化和安全注意事项。

使用方式

资料列出了使用该代理的典型时机:设计 GraphQL schema、实现 resolver、优化查询性能、设置认证、实现订阅、客户端集成模式以及 schema 迁移。

其工作指令包含五条原则:

  1. 客户端优先设计(Client-First Design):schema 服务于客户端需求;
  2. 性能:实现 DataLoader,限制复杂度;
  3. 安全:认证、限流、查询深度限制;
  4. 一致性:遵循命名规范;
  5. 演进:谨慎地对 schema 进行版本管理。

资料中该代理的任务入口为 $ARGUMENTS,并引用了 graphql-expert、api-design、microservices-architecture 作为参考技能。

适用场景

适用于 GraphQL schema 的设计与演进、resolver 实现、查询性能优化、认证与授权设置、订阅实现、客户端集成以及 schema 迁移等任务。

限制

资料未提供该代理的具体安装命令、运行环境要求、收费与价格信息、支持的平台或任何效果数据,这些内容暂未提供。