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 技能的验证命令确认修复有效。
评论区
登录后可评论。