让 AI 编码助手按正确方式构建 WordPress。

Agent Skills 是一组可移植的说明、检查清单和脚本，用来帮助 AI 助手（Claude、Copilot、Codex、Cursor 等）理解现代 WordPress 开发模式，避免常见坑，并遵循官方最佳实践。

AI 创作披露： 这些技能最初由 GPT-5.2 Codex（High Reasoning）基于官方 Gutenberg 与 WordPress 文档生成，随后由 WordPress 贡献者审阅和编辑。我们在多种 AI 助手中对技能进行了测试，并根据结果迭代优化。当前为 v1 版本，随着社区使用和反馈，技能会持续改进。详情见 docs/ai-authorship.md 与 WordPress AI Guidelines。

为什么需要 Agent Skills？

AI 编码助手很强大，但在 WordPress 场景下经常会：

  • 生成过时的 WordPress 代码模式（如 Gutenberg 之前、区块主题之前的写法）
  • 在插件开发中忽略关键安全要点
  • 跳过正确的区块废弃（deprecations）流程，导致 “Invalid block” 错误
  • 忽视你仓库中已经存在的工具链和配置

Agent Skills 通过提供专家级的 WordPress 知识，并以 AI 助手易于消费的格式呈现，来解决这些问题。

可用技能一览

Skill 主要内容
wordpress-router 识别 WordPress 仓库类型，并路由到合适的工作流
wp-project-triage 自动检测项目类型、工具链和版本信息
wp-block-development Gutenberg 区块开发：block.json、属性、渲染、废弃策略等
wp-block-themes 区块主题：theme.json、模板、Pattern、样式变体
wp-plugin-development 插件架构、Hooks、设置 API、安全实践
wp-rest-api REST API 路由/端点、Schema、认证与响应结构
wp-interactivity-api 使用 data-wp-* 指令和 stores 的前端交互性开发
wp-abilities-api 基于能力（Capability）的权限控制与 REST API 鉴权
wp-wpcli-and-ops WP-CLI 命令、自动化、多站点、search-replace 等运维操作
wp-performance 性能分析、缓存、数据库优化、Server-Timing
wp-phpstan 在 WordPress 项目中使用 PHPStan 静态分析（配置、基线、WP 特定类型）
wp-playground 使用 WordPress Playground 快速搭建本地环境
wpds WordPress Design System 相关内容

快速上手

在本机为 Claude Code 全局安装

# 克隆 agent-skills
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

# 或仅安装指定技能
node shared/scripts/skillpack-install.mjs --global --skills=wp-playground,wp-block-development

上述命令会将技能安装到 ~/.claude/skills/，Claude Code 会自动从该目录中发现并加载技能。

安装到你的项目仓库

# 克隆 agent-skills
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills

# 构建分发包
node shared/scripts/skillpack-build.mjs --clean

# 安装到你的 WordPress 项目
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 使用（项目级）

为 Cursor 全局安装

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

这会将技能安装到 ~/.cursor/skills/，Cursor 会自动从该目录中发现技能。

常用安装选项

# 列出可用技能
node shared/scripts/skillpack-install.mjs --list

# 预览安装（不真正写入文件）
node shared/scripts/skillpack-install.mjs --global --dry-run

# 仅为某个项目安装指定技能（例如 Claude + Cursor）
node shared/scripts/skillpack-install.mjs --dest=../my-repo --targets=claude,cursor --skills=wp-wpcli-and-ops

手动安装

你也可以不使用脚本，直接从 skills/ 目录中拷贝任意技能文件夹到对应 AI 助手的项目说明目录中即可。例如：

  • 将 skills/wp-block-development/ 拷贝到项目的 .claude/skills/ 或 .cursor/skills/ 等目录。

工作原理

每个技能大致包含如下结构：

skills/wp-block-development/
├── SKILL.md              # 主说明文档（使用场景、步骤、验证方式）
├── references/           # 深入主题的参考文档
│   ├── block-json.md
│   ├── deprecations.md
│   └── ...
└── scripts/              # 可复用的确定性脚本（检测、校验等）
    └── list_blocks.mjs

当你让 AI 助手处理 WordPress 相关代码时，它会读取这些技能文件，按照其中记录的流程执行，而不是凭经验“猜”实现方式。

兼容性

  • WordPress 6.9+（PHP 7.2.24+）
  • 适用于任何支持“项目级说明/指令”的 AI 助手

如何参与贡献

欢迎任何形式的贡献！

这个项目是分享你 WordPress 经验的好方式，并不要求你是“代码大神”。大多数技能都只是 Markdown 文档，重点在于清晰的步骤和最佳实践说明。

参与方式详见仓库中的 CONTRIBUTING.md。

常用开发命令：

# 脚手架创建一个新技能
node shared/scripts/scaffold-skill.mjs  ""

# 校验现有技能
node eval/harness/run.mjs

更多文档