前言¶
在接口层引入 GraphQL 时，常见工作包括梳理查询与变更边界、对齐类型与字段命名、把 REST 或内部 RPC 映射成可执行的 Schema 草案。这些步骤往往分散在文档、示例代码和口头约定里，Agent 若缺少统一指引，容易产出与项目规范不一致的 Schema，或遗漏分页、错误类型等基础结构。
下面介绍 SkillHub 上的社区 Skill「Graphql设计」。它面向 Agent 执行 GraphQL 设计类任务，通过标准 SKILL.md 向模型注入领域约束与流程，减少反复对齐成本。
这是什么¶
「Graphql设计」是 SkillHub 分类 dev-programming 下的社区技能，坐标为 @user_3c6cb52e/graphql-design-sh-4mq9ya，当前版本 1.0.0，发布者为 user_3c6cb52e，来源标记为 community。
官方简介为：Graphql设计专用技能，帮助 AI Agent 高效完成相关任务。 页面标签标明 requires_api_key=false，安装与使用不依赖额外 API Key。
SkillHub 展示页：https://www.skillhub.cn/skills/user_3c6cb52e/graphql-design-sh-4mq9ya
核心功能¶
公开资料中，除上述简介外，未单独列出子能力清单或脚本目录。据此可确认的定位如下：
- 领域聚焦：任务范围落在 GraphQL「设计」相关工作，由 Skill 正文（安装后的
SKILL.md）指导 Agent 如何组织输出与步骤。 - Agent 原生：遵循 SkillHub 通用的 Skill 格式，供 Cursor、Claude Code、Codex 等支持 Skills 的客户端加载。
- 无 Key 门槛：
requires_api_key=false，适合在本地或内网环境直接安装试用。
若需了解具体检查项、模板或命令，应在安装后阅读该 Skill 包内的 SKILL.md；列表页未展开更细条目时，不宜自行臆测实现细节。
安装与启用¶
SkillHub 推荐两种方式：让 Agent 按安装文档操作，或使用 skillhub CLI 指定 skills 目录安装。
方式一：提示词安装（官方页面文案）¶
将下面意图发给当前使用的 AI，由其按 SkillHub 安装说明拉取技能：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3c6cb52e/graphql-design-sh-4mq9ya`。
方式二：CLI 安装¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装技能时必须用 --dir 指向当前 Agent 实际识别的 skills 目录；默认装到 ./skills/ 可能不会被客户端加载。常用路径如下（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
在对应目录下执行安装（将 <skills 目录> 替换为上表路径或你项目内约定目录）：
skillhub install @user_3c6cb52e/graphql-design-sh-4mq9ya --dir <skills 目录>
文档亦支持用短名搜索后再安装，例如 skillhub search 与 skillhub install <名称> --dir <skills 目录>；本技能的确定坐标为 @user_3c6cb52e/graphql-design-sh-4mq9ya，可避免搜到同名条目时装错包。
安装完成后，按你所用客户端的要求重启或刷新 Agent，使新 Skill 进入可用列表。
典型用法¶
公开页面未提供独立的业务场景剧本，可复现的用法与安装流程一致：
- 按上一节将 Skill 装入当前 Agent 的 skills 目录。
- 在对话中说明 GraphQL 设计目标（例如现有 REST 资源、期望的 Query/Mutation 边界、团队命名规范等）。
- 显式要求 Agent 遵循已安装的 Graphql设计 Skill 组织步骤与交付物（Schema 草案、类型说明等），具体产出形态以包内
SKILL.md为准。
若 CLI 与提示词安装结果不一致，以实际解压到 skills 目录中的 SKILL.md 为权威说明。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的工具，希望把 GraphQL 设计类重复劳动交给 Agent 的团队或个人。
- 希望从 SkillHub 拉取社区技能、且不想配置额外 API Key 的环境。
限制与注意
- 来源为 community，质量与更新节奏依赖发布者
user_3c6cb52e；升级可用skillhub的更新能力，并在安装前确认版本（当前列表为 v1.0.0）。 - SkillHub 统计（以抓取资料为准）：评分 100000，下载约 1292 次；页面展示的「安装」计数为 0，仅作平台统计参考，不代表本地不可用。
- 列表页简介较概括，深度能力需安装后阅读
SKILL.md；写作或评审 Schema 时仍建议人工对照 GraphQL 规范与自家网关、鉴权策略做终审。
结尾¶
「Graphql设计」把 GraphQL 设计类任务封装成 Agent 可加载的 Skill，坐标 @user_3c6cb52e/graphql-design-sh-4mq9ya，无需 API Key 即可按 SkillHub 标准流程安装。若你正在整理 Schema 或让 Agent 参与接口设计，可从官方展示页与安装文档入手：
- Skill 页面：https://www.skillhub.cn/skills/user_3c6cb52e/graphql-design-sh-4mq9ya
- 安装说明：https://skillhub.cn/install/skillhub.md
- API 条目：https://api.skillhub.cn/user_3c6cb52e/graphql-design-sh-4mq9ya
