Skill 安装
多 Agent 安装npx skills add https://github.com/apollographql/skills --skill apollo-connectors使用 npx skills 快速安装，支持将 Skill 添加到多个兼容的 AI Agent。
Skill 调研报告
Skill 详细介绍
apollographql/skills#apollo-connectors 是 Apollo GraphQL 官方 skills 仓库中的一项 Skill，名称可以识别为 apollo-connectors。它面向 Apollo Connectors 相关工作，帮助 AI Agent 在需要把 REST API 接入 GraphQL 的场景中提供 Apollo Connectors 相关的指导、配置思路与实现辅助。
它本质上属于技能指令 / 开发指南类 Skill，不是一个可以独立运行的软件，也不是一个独立的 CLI 工具。安装后，Agent 增加的是围绕 Apollo Connectors 的专门能力，而不是新增一个可执行程序。
核心用途
– 帮助理解 Apollo Connectors 的用途和工作方式
– 辅助编写和调整 Apollo Connectors 相关配置
– 在 GraphQL 项目中把已有 REST 服务接入到 GraphQL 层
– 协助排查 Connectors 配置中的常见问题
它不是什么
– 不是 Apollo GraphQL 官方完整的运行时或部署平台
– 不是独立运行的软件包
– 不能替代 Apollo Router、Apollo Federation 等实际运行组件
– 不能替代对 REST API 本身的理解、认证与后端实现
适合的用户
– 正在使用 Apollo GraphQL 或 Apollo Federation 的开发者
– 需要把既有 REST API 快速暴露为 GraphQL 能力的团队
– 想在 Agent 辅助下编写、检查 Connectors 配置的工程师
不适合的需求
– 完全不涉及 GraphQL、只想做通用 REST 开发
– 希望 Skill 直接托管服务或代替运行时
– 需要图形化界面或托管平台产品
由于当前可确认的官方资料以 Apollo GraphQL 官方仓库内容为准，具体支持的配置字段、语法细节和版本行为，请以 Apollo Connectors 当前官方文档为准。
Skill 安全评估
从来源看，该 Skill 属于 apollographql 官方 skills 仓库，可信度较高。它本身是技能指令类内容，不是可执行二进制，不会因为安装动作本身就在系统里运行任意代码。
需要关注的点主要有：
– 该 Skill 主要服务于 Apollo Connectors 配置相关任务，通常会涉及读取和修改项目中的 GraphQL / Connectors 配置文件。
– 如果 Agent 被授予文件写入权限，它可能直接改动你的 Schema、Connectors 定义或路由相关配置。建议在版本控制下操作，改动前先提交或备份。
– 如果 Agent 被授予执行 Shell 命令的权限，并且任务涉及安装依赖或启动 Apollo Router 等运行时，会实际执行命令。建议只在需要时开启，或由用户自己手动执行。
– 如果 Connectors 指向的 REST 服务需要 API Key、Token 或 OAuth 凭证，这些凭证属于被接入服务的安全边界，与 Skill 本身无关，但需要按最小权限配置，避免把生产凭证写入可提交的文件。
实操建议：
– 只在受控的项目目录中使用，避免让 Agent 接触无关敏感文件
– 让 Agent 生成或修改配置时优先走代码审查流程
– 关闭不必要的自动执行 Shell 权限，安装和运行步骤由用户手动完成
– 不要把生产环境的密钥、Token 硬编码进仓库
总体判断：来源可信，主要是配置与开发辅助性质，风险主要取决于你授予 Agent 的文件写入与 Shell 执行权限。
Skill 使用要求
一、Agent / 客户端
该 Skill 来自 apollographql 官方 skills 仓库，属于 Agent Skill 类内容，本质上通过 Skills 或类似指令加载机制被 Agent 使用。官方没有公布完整的第三方 Agent 兼容列表。从 Agent Skill 的通用工作方式来看，在支持 Skills、自定义 Skill 或类似指令加载机制的环境中，通常可以在 Claude Code、Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中尝试使用。不同 Agent 的 Skill 加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。
二、运行环境 / 依赖
| 项目 | 要求 |
|—|—|
| Agent | 支持 Skills 或自定义 Skill 的 Agent |
| 项目技术栈 | 涉及 Apollo GraphQL / Apollo Connectors 的工程 |
| 网络 | 视任务而定，若需查阅 Apollo 官方文档或拉取依赖则需要 |
| Node.js / 包管理器 | 若项目本身是 Node 工程，则按项目要求准备 |
该 Skill 本身不强制要求固定版本的 Node.js、Python 或特定 CLI。
三、权限
– 文件读取：必需，用于读取项目中的 GraphQL / Connectors 配置
– 文件写入：可选，用于生成或修改配置，建议在版本控制下进行
– Shell 执行：可选，仅在涉及安装依赖或运行 Apollo 相关命令时需要
– 网络访问：可选，用于查阅官方文档或拉取依赖
四、账号 / API Key
Skill 本身不需要 Apollo 账号或 API Key。是否需要在后续任务中提供凭证，取决于你所接入的 REST 服务以及项目本身的鉴权方式，与 Skill 无关。
最小使用条件
– 一个支持 Skills 或自定义 Skill 的 Agent
– 一个涉及 GraphQL / Apollo Connectors 的项目或明确任务
– 允许 Agent 读取相关配置文件
Skill 安装、使用与卸载教程
一、安装
可以直接复制本页面提供的 Skill 安装指令，粘贴到对应 Agent 或终端执行。
如果不清楚当前 Agent 如何安装，可以直接向 Agent 提问：
如何安装 apollographql/skills#apollo-connectors？
如何在 Claude Code 中安装 apollographql/skills#apollo-connectors？
如何在 Cursor 中安装 apollographql/skills#apollo-connectors？
让当前 Agent 根据自己的 Skill 加载与管理机制指导安装即可。
二、安装后如何使用
安装后，在与 Apollo Connectors、GraphQL Federation、REST 转 GraphQL 相关的任务中提及该 Skill 即可触发。适合交给它的任务包括：梳理 Connectors 配置、生成或调整 Connectors 定义、排查配置问题。
自然语言使用示例：
使用 apollo-connectors，帮我把这个 REST API 接入到 GraphQL，并给出 Apollo Connectors 配置示例。
使用 apollo-connectors，检查我这段 Connectors 配置有没有问题。
使用 apollo-connectors，解释一下这个 Connectors 文件里各个字段的作用。
三、卸载
不同 Agent 的 Skill 安装位置和管理方式可能不同。可以优先使用对应 Agent / Skill 管理器提供的删除方式移除该 Skill，如果没有统一卸载命令，直接询问当前 Agent 会更稳妥：
如何卸载 apollographql/skills#apollo-connectors？
常见问题
这个 Skill 和 Apollo GraphQL 官方是同一来源吗？
是，它来自 apollographql 官方 skills 仓库，属于官方发布的 Skill。
安装后会不会自动修改我的项目？
取决于你授予的权限。仅安装 Skill 不会自动改动项目。只有在任务中让 Agent 修改文件并授予写入权限时，才可能产生改动，建议在版本控制下操作。
可以同时安装到多个 Agent 吗？
通常可以各自在其环境中安装，但不同 Agent 的加载机制不同，是否冲突以各自环境为准。
Skill 更新后需要重新安装吗？
视 Agent 的 Skill 管理方式而定。有的会跟随上游更新，有的需要重新拉取，具体以你使用的 Agent 为准。
中国大陆使用是否有网络要求？
该 Skill 本身不强制联网。若任务需要查阅 Apollo 官方文档或拉取相关依赖，可能需要能访问对应站点的网络环境。
为什么安装后 Agent 没有识别到 Skill？
常见原因包括安装位置不对、Agent 未启用 Skills 加载、或当前 Agent 版本不支持该加载方式。可以先确认安装路径与加载机制，再重新尝试。
可以关闭 Shell 权限使用吗？
可以。如果只需要它协助编写或检查 Connectors 配置，关闭自动执行 Shell 权限，由你自己手动执行安装和运行命令，是更稳妥的做法。
Skill 更新日志
版本列表
v1.2.10 最新
## 变更内容
* chore(deps): 将依赖 prettier 更新至 v3.9.8，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/79
* docs: 将 connectors 技能指向最新的 Federation 和 Connectors LTS，由 @mabuyo 提交于 https://github.com/apollographql/skills/pull/80
## 新贡献者
* @mabuyo 在 https://github.com/apollographql/skills/pull/80 中做出了首次贡献
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.9...v1.2.10
v1.2.9
## 变更内容
* feat: 添加 authz、safelisting、config-as-code，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/69
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.8...v1.2.9
v1.2.8
## 变更内容
* chore: 将 CLAUDE.md 符号链接到 AGENTS.md 并记录版本升级，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/78
* docs: 将 rust-best-practices 技能与上游手册同步，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/76
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.7...v1.2.8
v1.2.7
## 变更内容
* chore(deps): 将依赖 prettier 更新至 v3.9.4，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/73
* chore(deps): 将依赖 prettier 更新至 v3.9.5，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/74
* chore(deps): 将依赖 prettier 更新至 v3.9.6，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/75
* docs: 澄清 federation 链接版本是下限，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/77
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.6...v1.2.7
v1.2.6
## 变更内容
* chore(deps): 将依赖 prettier 更新至 v3.8.5，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/70
* chore(deps): 将依赖 prettier 更新至 v3.9.3，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/71
* 修复 list-apollo-kotlin-versions.sh 的链接，由 @jvanderwee 提交于 https://github.com/apollographql/skills/pull/72
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.5...v1.2.6
v1.2.5
## 变更内容
* docs: 记录 rover schema --coord 形式，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/68
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.4...v1.2.5
v1.2.4
## 变更内容
* Rover schema 探索，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/67
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.3...v1.2.4
v1.2.3
## 变更内容
* 更新 Apollo Kotlin 技能以包含迁移指南，由 @martinbonnin 提交于 https://github.com/apollographql/skills/pull/66
## 新贡献者
* @martinbonnin 在 https://github.com/apollographql/skills/pull/66 中做出了首次贡献
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.2...v1.2.3
v1.2.2
## 变更内容
* docs: 将 gh 技能固定切换为 --pin 标志，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/62
* docs: 澄清 gh cli 注释与多技能安装匹配，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/63
* docs: 修复无效的 SDL 和不匹配的复杂度库，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/64
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.1...v1.2.2
v1.2.1
## 变更内容
* feat: 将 gh skill cli 与自动发布集成，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/60
* fix(apollo-ios): 记录不受信任内容的威胁模型，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/61
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.2.0...v1.2.1
v1.2.0
## 变更内容
* ci: 强制升级插件版本，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/59
* 添加 apollo-ios 技能，由 @AnthonyMDev 提交于 https://github.com/apollographql/skills/pull/58
## 新贡献者
* @AnthonyMDev 在 https://github.com/apollographql/skills/pull/58 中做出了首次贡献
**完整变更日志**: https://github.com/apollographql/skills/compare/v1.0.0...v1.2.0
v1.0.0
## 变更内容
* 处理 Apollo Client 技能反馈：AC4 模式、TypedDocumentNode、缓存最佳实践，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/2
* 更新 README.md，由 @debergalis 提交于 https://github.com/apollographql/skills/pull/4
* 处理 PR #1 反馈：修复 Apollo Client 4.x 文档问题，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/3
* 为 Next.js、React Router 和 TanStack Start 添加框架特定的 Apollo Client 设置指南，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/6
* chore: 配置 Renovate，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/9
* 使文档语气与 Apollo Voice 指南保持一致，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/8
* 添加针对 Apollo Client 技能的 Copilot 指令，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/12
* 添加 skill-creator 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/10
* 从恢复的文档访问中添加完整的 Apollo Client Suspense hooks 文档，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/11
* 添加强调共置而非复用的 fragments 参考指南，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/13
* 分离客户端和 SSR 集成指南，将 setup 重命名为 integration，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/16
* 用完整手册章节替换 rust-best-practices 摘要，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/15
* 为 JavaScript/TypeScript 代码示例添加 Prettier 格式化，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/17
* 将 apollo-client 技能与上游提交 7f665110 同步，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/18
* 使 Apollo Server 技能与 Apollo Server 5.x 文档保持一致，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/19
* 更新一些导入，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/20
* 将 `skill-creator` 技能添加到活跃的 Copilot Skills，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/23
* 修复 apollo-mcp-server 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/21
* 为 PR 添加 skills-ref 验证工作流，由 @Copilot 提交于 https://github.com/apollographql/skills/pull/25
* 添加 Apollo Kotlin 技能，由 @BoD 提交于 https://github.com/apollographql/skills/pull/26
* Apollo Kotlin 技能：添加脚本以获取最新版本，由 @BoD 提交于 https://github.com/apollographql/skills/pull/28
* 标准化技能版本格式，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/29
* 更新指令信息，由 @dariuszkuc 提交于 https://github.com/apollographql/skills/pull/32
* chore(deps): 将依赖 prettier 固定到 3.8.1，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/33
* 修复拼写错误，由 @jvanderwee 提交于 https://github.com/apollographql/skills/pull/31
* 添加 apollo-federation 技能，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/5
* feat: 为联邦 GraphQL 超级图添加 apollo-router 技能，由 @gocamille 提交于 https://github.com/apollographql/skills/pull/22
* 添加 Claude Code 插件支持，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/34
* 修复 apollo-mcp-server 技能配置示例中不正确的字段名，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/35
* feat(apollo-router): 使交接和快速开始以技能为先，由 @gocamille 提交于 https://github.com/apollographql/skills/pull/36
* feat(skill): apollo-router-plugin-creator，由 @samuelAndalon 提交于 https://github.com/apollographql/skills/pull/30
* 从允许的工具中移除 curl，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/38
* 更新 apollo-mcp-server 技能以确保准确性，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/39
* fix: 修正 apollo-mcp-server 参考中的 CORS 配置选项，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/40
* fix: 修复损坏的链接和语法/拼写问题，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/41
* ci: 添加 AI 驱动的技能同步工作流，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/42
* refactor: 直接将技能与产品源进行比较，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/43
* ci: 在技能同步中包含新功能覆盖，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/44
* fix: 对分诊结果使用 structured_output，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/45
* fix: 将多操作示例拆分为每个文件一个操作，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/46
* 用 Claude CLI 替换 claude-code-action，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/47
* feat: 添加 GraphQL LSP 服务器配置，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/49
* chore(deps): 将依赖 prettier 更新至 v3.8.2，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/50
* chore(deps): 将依赖 prettier 更新至 v3.8.3，由 @svc-secops 提交于 https://github.com/apollographql/skills/pull/51
* feat: 从 apollo-client 仓库同步 apollo-client 技能，由 @phryneas 提交于 https://github.com/apollographql/skills/pull/52
* fix(apollo-router): 围绕 Cache-Control 头重构响应缓存，由 @abernix 提交于 https://github.com/apollographql/skills/pull/53
* docs(apollo-router): 扩展可观测性和 Redis 部署指南，由 @abernix 提交于 https://github.com/apollographql/skills/pull/54
* sync: 从 apollo-client@47c63b9795770ad581f77d892932f97b1cb2eb87 同步 apollo-client 技能，由 @github-actions[bot] 提交于 https://github.com/apollographql/skills/pull/55
* 为 apollo-router 技能添加响应缓存覆盖，由 @DaleSeo 提交于 https://github.com/apollographql/skills/pull/37
* sync: 从 apollo-client@de252731ffdc61026b01dd4be9f8d11a98daf43e 同步 apollo-client 技能，由 @github-actions[bot] 提交于 https://github.com/apollographql/skills/pull/57
## 新贡献者
* @Copilot 在 https://github.com/apollographql/skills/pull/2 中做出了首次贡献
* @debergalis 在 https://github.com/apollographql/skills/pull/4 中做出了首次贡献
* @svc-secops 在 https://github.com/apollographql/skills/pull/9 中做出了首次贡献
* @phryneas 在 https://github.com/apollographql/skills/pull/12 中做出了首次贡献
* @DaleSeo 在 https://github.com/apollographql/skills/pull/10 中做出了首次贡献
* @BoD 在 https://github.com/apollographql/skills/pull/26 中做出了首次贡献
* @dariuszkuc 在 https://github.com/apollographql/skills/pull/32 中做出了首次贡献
* @jvanderwee 在 https://github.com/apollographql/skills/pull/31 中做出了首次贡献
* @gocamille 在 https://github.com/apollographql/skills/pull/22 中做出了首次贡献
* @samuelAndalon 在 https://github.com/apollographql/skills/pull/30 中做出了首次贡献
* @abernix 在 https://github.com/apollographql/skills/pull/53 中做出了首次贡献
**完整变更日志**: https://github.com/apollographql/skills/commits/v1.0.0
相关 Skills
aws-sdk-js-v3-usage – AWS SDK for JavaScript v3 使用 Skill
aws-sdk-js-v3-usage 是指导 AI Agent 正确使用 AWS SDK for JavaScript v3 的开发型 Skill，帮助处理 AWS 服务的客户端配置、命令调用与凭证管理，适合在 Node.js 项目中集成和操作 AWS 云服务的开发场景。
aws-sdk-python-usage – AWS Python SDK 用法指南 Skill
aws-sdk-python-usage 是指导 AI Agent 使用 AWS SDK for Python（Boto3）编写代码的参考型 Skill，涵盖客户端创建、凭证配置、分页器与等待器、错误处理及常见 AWS 服务调用，适合需要生成或调试 Python 代码来操作 AWS 资源的开发任务。
dashboard-create-screen – WordPress 仪表盘页面创建 Skill
WordPress.com 仪表盘创建屏幕 Skill 用于指导 AI Agent 构建 Calypso 后台仪表盘的创建界面，适合开发新增站点、新建页面等仪表盘初始化流程的页面与组件。
pr – WordPress ActivityPub 代码审查与提交 Skill
用于让 AI Agent 协助开发 WordPress ActivityPub 插件的 Skill，适合需要实现或调试 ActivityPub 联邦发布、关注者投递与相关兼容性问题的 WordPress 开发者。
code-style – 代码风格规范与格式化 Skill
code-style 是用于指导 AI Agent 遵循 WordPress ActivityPub 插件代码规范的开发型 Skill，帮助在编写、修改或审查该插件代码时保持统一的编码风格与提交约定。
wp-rest-api – WordPress REST API 开发 Skill
wp-rest-api 是指导 AI Agent 通过 WordPress REST API 读写站点内容的开发型 Skill，适合文章发布、媒体管理、用户与评论操作等自动化任务。
wp-interactivity-api – WordPress 交互性 API 开发 Skill
wp-interactivity-api 是指导 AI Agent 使用 WordPress Interactivity API 开发交互式前端功能的开发型 Skill，适合为 WordPress 区块和主题构建无需额外框架的动态交互界面。
暂无评论...