如何让AI模型更懂WordPress开发？可以尝试一下官方出品的Agent-skills包

2026-02-11 · 管理员 · 发表评论

AI 辅助 WordPress 开发的挑战

WordPress 占据了全球 CMS 市场 60% 以上的份额，拥有庞大的插件与主题生态。然而，在使用 Claude Code、Cursor 或 GitHub Copilot 等 AI 编码助手进行 WordPress 开发时，开发者常面临诸多痛点：生成的代码往往沿用过时的 API、缺乏安全检查、不符合 WordPress 编码规范，甚至在处理 Gutenberg 区块编辑器时频繁报错。

通用 AI 模型缺乏对 WordPress 特有机制（如钩子系统、REST API 设计、区块架构）的深度理解，导致开发者需要花费大量时间在上下文解释和代码修正上。为了解决这一问题，WordPress 官方推出了 agent-skills 项目。

什么是 agent-skills？

agent-skills 是 WordPress 官方开源的一套 AI 指令集与技能包。它旨在将 WordPress 官方的最佳实践、开发规范和安全标准直接“注入”到 AI 助手中。通过配置这些技能包，AI 能够自动遵循 WordPress 6.9+ 的标准生成代码，从而显著提升开发效率和代码质量。

核心技能包一览

agent-skills 包含 13 个专业技能包，覆盖了 WordPress 开发的核心场景。以下是主要技能包及其功能：

技能名称	功能描述
wordpress-router	自动识别仓库类型（主题、插件、区块），并将任务路由到对应的工作流。
wp-block-development	指导 Gutenberg 区块开发，包括 block.json 配置、属性定义、渲染逻辑及弃用处理。
wp-plugin-development	规范插件架构、钩子使用、设置 API 及安全检查。
wp-rest-api	设计 REST API 路由、端点、数据模式及身份验证。
wp-performance	性能分析、缓存策略、数据库查询优化及 Server-Timing 集成。
wp-interactivity-api	使用 data-wp-* 指令和存储处理前端交互。
wp-phpstan	为 WordPress 项目提供 PHPStan 静态分析配置与特定类型检查。
wp-playground	利用 WordPress Playground 快速搭建即时本地环境。

安装与配置指南

agent-skills 支持多种 AI 工具，包括 Claude Code、Cursor、GitHub Copilot 等。安装过程主要分为构建和部署两个阶段。

1. 克隆与构建

首先，从 GitHub 克隆项目并构建技能包：

git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
node shared/scripts/skillpack-build.mjs --clean

2. 全局安装 (推荐 Claude Code 用户)

运行以下命令将技能包安装到全局目录，Claude Code 将自动发现：

node shared/scripts/skillpack-install.mjs --global

默认安装路径为 ~/.claude/skills/。如果仅需安装特定技能，可使用 --skills 参数，例如：

node shared/scripts/skillpack-install.mjs --global --skills=wp-playground,wp-block-development

3. 项目级安装 (Cursor, Copilot 等)

若要将技能包集成到特定项目（供 Cursor、VS Code/Copilot 使用），请运行：

node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude,cursor

此操作会将技能包复制到项目的以下对应目录：

.codex/skills/ (OpenAI Codex)
.github/skills/ (VS Code / GitHub Copilot)
.claude/skills/ (Claude Code 项目级)
.cursor/skills/ (Cursor 项目级)

4. Cursor 全局安装

针对 Cursor 的全局安装命令：

node shared/scripts/skillpack-install.mjs --targets=cursor-global

5. 安装命令详解

node shared/scripts/skillpack-install.mjs --dest= [options]

Options:
  --dest=       Destination repo root (required, unless using --global)
  # 目标仓库的根目录路径；除非使用 --global，否则必须指定

  --from=       Source directory (default: dist)
  # 技能包来源目录，默认使用构建后的 dist 目录

  --targets=    Comma-separated targets: codex, vscode, claude, claude-global, cursor, cursor-global (default: codex,vscode)
  # 指定安装目标环境，使用英文逗号分隔；默认安装到 codex 和 vscode

  --skills=     Comma-separated skill names to install (default: all)
  # 指定要安装的技能名称，英文逗号分隔；默认安装全部技能

  --mode=       'replace' (default) or 'merge'
  # 安装模式：replace 表示覆盖目标目录；merge 表示合并（不删除已有文件）

  --global            Shorthand for --targets=claude-global (installs to ~/.claude/skills)
  # 快捷参数，相当于 --targets=claude-global，安装到当前用户的 Claude 全局技能目录

  --dry-run           Show what would be installed without making changes
  # 仅展示将要执行的安装操作，不实际写入任何文件（安全预览）

  --list              List available skills and exit
  # 列出当前可用的技能列表并直接退出

Targets:
  codex               Install to /.codex/skills/
  # 安装到 Codex 项目级技能目录（位于目标仓库下）

  vscode              Install to /.github/skills/
  # 安装到 VS Code / GitHub Copilot 使用的项目级技能目录

  claude              Install to /.claude/skills/ (project-level)
  # 安装到 Claude Code 的项目级技能目录（随仓库生效）

  claude-global       Install to ~/.claude/skills/ (user-level, ignores --dest)
  # 安装到 Claude Code 的用户级全局技能目录，忽略 --dest 参数

  cursor              Install to /.cursor/skills/
  # 安装到 Cursor 编辑器的项目级技能目录

  cursor-global       Install to ~/.cursor/skills/ (user-level, ignores --dest)
  # 安装到 Cursor 编辑器的用户级全局技能目录，忽略 --dest 参数

Examples:
  # Build and install to a WordPress project
  # 构建技能包并安装到一个 WordPress 项目中
  node shared/scripts/skillpack-build.mjs --clean
  node shared/scripts/skillpack-install.mjs --dest=../my-wp-repo --targets=codex,vscode,claude,cursor

  # Install globally for Claude Code (all skills)
  # 将全部技能全局安装到 Claude Code（对所有项目生效）
  node shared/scripts/skillpack-install.mjs --global

  # Install globally for Cursor (all skills)
  # 将全部技能全局安装到 Cursor 编辑器
  node shared/scripts/skillpack-install.mjs --targets=cursor-global

  # Install specific skills globally
  # 仅将指定技能全局安装（示例中为 WordPress Playground 与区块开发相关技能）
  node shared/scripts/skillpack-install.mjs --global --skills=wp-playground,wp-block-development

  # Install to project with specific skills
  # 安装指定技能到某个项目中（不影响全局）
  node shared/scripts/skillpack-install.mjs --dest=../my-repo --targets=claude,cursor --skills=wp-wpcli-and-ops

工作原理与兼容性

每个技能包（Skill）包含核心指令文档（SKILL.md）、深度参考资料（references/）以及辅助脚本（scripts/）。当 AI 助手处理 WordPress 代码时，它会读取这些技能包，依据文档化的流程进行操作，而非盲目猜测。

兼容性要求：

WordPress 6.9 或更高版本 (PHP 7.2.24+)
任何支持项目级指令的 AI 助手。

通过 agent-skills，开发者可以将繁琐的规范校验工作交给 AI，专注于核心业务逻辑的实现，真正实现 AI 辅助开发的提效价值。