Agent Skills
返回列表
💻

WPGraphQL WordPress GraphQL API

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/wpgraphql-graphql-api-wordpress。

技能介绍

解决的问题

无头WordPress开发中，传统REST API往往带来诸多痛点：字段冗余导致响应体过大，端点分散需频繁切换接口，且无严格类型校验，手动拼装参数易出现字段缺失或格式错误。尤其当需要查询自定义文章类型、菜单或分类数据时，定制化适配成本高，难以满足前端结构化取数需求。

技能工作方式

该技能围绕开源WPGraphQL插件构建无头工作流，核心是通过GraphQL查询语句替代零散的REST端点调用。其关键能力包括：

  • 精准查询WordPress内置文章、自定义文章类型（如产品、案例）
  • 获取菜单、分类体系及自定义字段数据
  • 依托GraphQL的类型系统，自动校验查询字段合法性

使用时只需定义符合GraphQL语法的查询结构，指定所需字段层级，即可直接返回结构化JSON数据，无需额外编写解析逻辑。

适用边界与注意点

  • 需提前部署WPGraphQL插件，技能能力依赖插件本身的功能支持
  • 自定义文章类型、自定义字段需先注册到WPGraphQL的schema中，否则无法被查询
  • 复杂嵌套查询可能影响数据库性能，需合理控制查询深度与字段数量
  • 需关注WPGraphQL插件的版本更新，避免因API变更导致查询语句失效

使用场景

  • 前端工程师为 Nuxt/Next 项目接入 WordPress 时，需要一次性拉取文章正文、分类和特色图片，避免多次 REST 请求。
  • 技术负责人为定制案例展示页做数据层，需要查询自定义文章类型“case_study”及其自定义字段。
  • 小程序开发者为首页菜单和分类导航取数，需要通过 GraphQL 一次拿到菜单层级与分类名称。
  • 内容平台工程师做站内搜索列表，需要按分类筛选文章并返回指定字段，保持响应结构稳定。

适合人员

  • 前端工程师，希望用类型化 GraphQL 替代零散 REST 请求，减少联调成本。
  • WordPress 技术负责人，需要统一无头架构数据查询层并控制返回字段。
  • 小程序或移动端开发者，需要稳定获取菜单、分类和文章内容用于展示。
  • 内容平台工程师，负责把 WordPress 数据接入搜索或列表页，关注 schema 稳定性。