WordPress Agent Skills:官方出品的WordPress全栈开发AI技能库

WordPress/agent-skills 是 WordPress 官方在 2026 年 1 月发布的 AI 编码助手技能库,旨在教会 Claude、Copilot、Codex、Cursor 等 AI 工具「用正确的方式」开发 WordPress。AI 编程助手虽然强大,但在 WordPress 开发场景里极易踩坑:生成过时代码(Gutenberg 之前的写法)、忽略插件安全规范、跳過 block 废弃处理导致 “Invalid block” 报错、忽视项目已有工具链。WordPress 官方出手做了这件事——把 WordPress 开发的专家级知识打包成可安装的 SKILL.md,让 AI 在任何时候都能调用经过验证的流程,而不是靠训练数据的记忆「猜」答案。截至 2026 年 8 月,该仓库已积累 2,008 颗 GitHub Star、297 个 Fork、44 个 open issue,且过去一周仍有活跃提交,是当前最值得关注的专业领域 Agent Skills 之一。

功能与设计原则

该项目的核心价值是把 WordPress 官方文档和 Gutenberg 贡献者的实战经验,转化为 AI 助手可理解、可执行的技能模块。每个 Skill 都是一个自包含的文件夹,包含主指令文件(SKILL.md)、参考资料目录(references/)和可选的验证脚本(scripts/)。AI 在处理 WordPress 项目时,会自动读取对应的 SKILL.md,获取何时使用、如何执行、结果如何验证的完整指导,而不是每次都重新解释背景。

设计原则上有两个关键点:一是渐进式披露(Progressive Disclosure),SKILL.md 只描述核心流程和检查清单,深度资料放在 references/,AI 按需读取,避免一次性塞满上下文;二是作用域隔离,Skill 可以全局安装(所有项目共享)或项目级安装(提交到仓库,团队统一使用),两种方式可以同时生效,项目级优先。

认可度

  • GitHub Star:2,008(截至 2026-08-15)
  • Fork:297
  • 官方背书:WordPress 官方组织(WordPress)发布,AI 内容由 GPT-5.2 Codex 生成、经 WordPress 贡献者审核
  • 活跃度:最近一次提交为 2026-08-15,17 个技能均处于维护状态
  • 安装方式支持 skills.sh / npx skills add / Git clone 手动安装,覆盖 Claude Code、Cursor、Copilot、Codex 等主流 Agent

链接

GitHub:https://github.com/WordPress/agent-skills

原作者

WordPress 官方组织(github.com/WordPress)维护,AI 生成内容遵循 WordPress AI Guidelines,由 Gutenberg 和 WordPress 文档审核后发布。贡献者包括 WordPress 核心贡献者和主题/插件开发者。

介绍

WordPress 是全球最流行的 CMS,市场占有率超过 40%,但其开发模式高度专业化——Gutenberg 编辑器、Block Themes、Interactivity API、Abilities API 等新范式与旧版 WordPress 写法差异巨大。AI 编程助手在训练时接触到的 WordPress 代码大量来自旧教程和过时示例,导致生成的结果要么功能残缺,要么存在安全隐患。

WordPress/agent-skills 的做法是:由 GPT-5.2 Codex(高推理模式)从官方 Gutenberg 文档和 WordPress 手册中提取知识,生成初版 SKILL.md,再由 WordPress 贡献者人工审核修正,最后在实际 AI 助手中测试并迭代改进。目前已覆盖 17 个技能领域,从基础的插件开发、REST API 到前沿的 Abilities API 和 WordPress Playground 集成,每一项都附带验证步骤,确保 AI 的输出经过检查而非凭空生成。

项目采用 MIT 协议开源,任何人都可以克隆、修改、分发。Skill 文件夹结构统一(SKILL.md + references/ + scripts/),方便社区贡献新的技能或改进现有内容。

特点

  • 官方背书:WordPress 组织直接维护,不是第三方爱好者作品,权威性有保证
  • 覆盖全栈:17 个技能覆盖 blocks、themes、plugins、REST API、Interactivity API、WP-CLI、PHPStan、Playground 等 WordPress 开发所有核心领域
  • AI 原生设计:从第一天起就是为 AI 助手设计的,不是把人类文档直接丢给 AI,而是按 AI 的认知和执行方式重新组织
  • 渐进式上下文:SKILL.md 只放流程和检查清单,深度文档放 references/,避免 token 浪费
  • 验证脚本内置:每个技能都包含确定性辅助脚本(如 list_blocks.mjs),AI 执行后可直接验证结果正确性
  • 安装简单:一条 npx skills add WordPress/agent-skills --skill <skill-name> 即可安装,支持全局和项目级两种作用域
  • 社区驱动改进:所有 Skill 都标注了 AI 生成来源,并开放 pull request 渠道,技能质量随社区使用而提升

使用方法

快速安装单个技能(以 wp-plugin-development 为例):

npx skills add WordPress/agent-skills --skill wp-plugin-development

查看所有可用技能:

npx skills add WordPress/agent-skills --list

同时安装多个技能:

npx skills add WordPress/agent-skills --skill wp-plugin-development wp-abilities-api wp-playground

全局安装(跨项目可用):

npx skills add WordPress/agent-skills --skill wp-plugin-development --global

手动安装(克隆 + 构建):

git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
node shared/scripts/skillpack-build.mjs --clean
node shared/scripts/skillpack-install.mjs --global --skills=wp-block-development,wp-plugin-development

安装后,在 Claude Code、Cursor 或其他支持的 Agent 中,只要对话涉及 WordPress 开发,AI 会自动读取对应的 SKILL.md 并按文档流程执行。

使用场景与人群

适用场景:

  • WordPress 插件开发(特别是需要调用 REST API、使用 Abilities API 做权限控制的场景)
  • Gutenberg Block 开发(block.json、attributes、rendering、deprecations 全流程)
  • Block Theme 主题开发(theme.json、模板、patterns、style variations)
  • WordPress 性能优化(profiling、caching、数据库优化、Server-Timing)
  • WordPress Playground 集成和自动化测试

目标用户:

  • WordPress 开发者,想让 AI 助手生成符合当前 WordPress 最佳实践的代码
    -Agency 或团队,想统一 AI 辅助开发的 WordPress 代码质量标准
  • AI 编程工具研究者,关注官方如何将领域知识结构化给 AI 使用

输入与输出案例

案例 1:让 AI 写一个 Gutenberg Block

Input:

请用 Gutenberg 的最新方式创建一个名为 featured-post 的动态 Block,从 REST API 获取文章列表并渲染卡片。

未安装技能时,AI 可能用 pre-Gutenberg 的 register_block_type() 直接写,缺少 block.json、deprecations 处理和 Interactivity API 集成。

安装 wp-block-development 技能后,AI 读取 SKILL.md,按流程执行:先创建 block.json 定义属性和 API,再实现编辑器和前端渲染,加入废弃(deprecation)处理,最终输出符合 Gutenberg 规范、可直接放入 WordPress 插件目录的完整 Block 代码。

案例 2:WordPress 插件安全审计

Input:

审计一下这个插件的 REST API 端点,找出权限控制的漏洞。

安装 wp-abilities-audit 技能后,AI 读取技能文档,按步骤:枚举所有 REST 路由 → 检查每个端点的权限回调 → 对比 WordPress Abilities API 的最佳实践 → 输出具体漏洞列表和修复建议,并附带 wp-abilities-verify 技能的验证命令确认修复有效。


GitHub: https://github.com/WordPress/agent-skills

评论区

0 条评论

登录后可评论。

Skill超级捕获手 13 阅读