摘要
AI 编码助手（如 Claude Code、GitHub Copilot、Codex、Cursor 等）正在改变我们的开发方式，但在 WordPress 这种生态复杂、历史悠久的系统里，AI 往往会生成不符合规范、甚至存在安全隐患的代码。
为了解决这个问题，WordPress 官方推出了 Agent Skills 项目。它通过结构化“技能包”的方式，把插件开发规范、Block 开发流程、测试步骤、CLI 操作等最佳实践直接教给 AI，让智能助手在写代码前就具备“专家级知识”。
本文将全面介绍 Agent Skills 是什么、为什么值得使用，以及如何在你的 WordPress 项目中安装并落地使用。
什么是 Agent Skills ？
简单来说：
Agent Skills = 给 AI 准备的「开发说明书 + 操作流程 + 规则集合」
传统 AI 写代码的方式是：
根据提示词“猜测”你想要什么。
而 Agent Skills 的方式是：
在特定任务下，先读取一份详细的执行规范，再严格按照流程操作。
这就像：
- ❌ 普通 AI：新手工程师，靠经验乱写
- ✅ Agent Skills：熟悉 WordPress 规范的资深开发者
因此生成的代码更稳定、更安全、更符合官方标准。
为什么 WordPress 特别需要它？
如果你经常让 AI 帮你写 WordPress 代码，大概率遇到过这些问题：
- 使用过时 Hook 或 API
- 插件目录结构错误
- 忘记 nonce 或权限校验
- Block 注册方式不规范
- 没考虑多站点或缓存问题
- 忽略 WordPress Coding Standards
这些问题不是 AI 不聪明，而是：
👉 它不知道 WordPress 的「行业规则」
Agent Skills 的目的，就是把这些规则系统化地提供给 AI。
Agent Skills 的工作原理
每个 Skill 本质上是一个目录，里面包含：
- SKILL.md（详细说明书）
- 可选 scripts（自动化脚本）
- 可选 references（参考资料）
结构示例：
agent-skills/
├── skills/
│ ├── wp-plugin-development/
│ ├── wp-block-development/
│ ├── wp-project-triage/
│ ├── wordpress-router/
│ └── wp-playground/当 AI 识别到：
- 你在写插件
- 你在开发 Block
- 你需要启动测试环境
它就会自动读取对应 Skill 的说明文件，再按步骤执行，而不是随便生成代码。
官方内置的核心技能
下面是几个非常实用的内置模块：
wp-project-triage
自动识别当前目录是不是 WordPress 项目，并判断：
- 插件 / 主题 / Block
- 使用的构建工具
- 测试环境
相当于“项目体检”。
wordpress-router
根据项目类型自动路由到正确流程。
例如：
- 插件 → 插件开发规范
- Block → Block 开发流程
相当于“智能导航”。
wp-plugin-development
插件开发最佳实践，包括：
- 标准目录结构
- 激活 / 停用 Hook
- Settings API
- 安全校验
- 国际化
- 代码规范
如果你经常写插件，这个 Skill 非常有价值。
wp-block-development
专门针对 Gutenberg Block：
- block.json
- 属性定义
- 动态渲染
- 构建流程
- 向后兼容
适合做 Block 插件或主题开发。
wp-playground
可以自动启动一个 WordPress 测试环境：
- 快速运行实例
- 自动加载代码
- 自动化测试验证
实现：写完代码 → 立即运行 → 自动验证。效率非常高。
实战教程：从零开始安装
下面进入最关键的实操部分。
第一步：克隆仓库
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills第二步：构建技能包（可选）
node shared/scripts/skillpack-build.mjs --clean
用于生成统一的技能包文件。
第三步：安装到你的项目（推荐）
进入你的 WordPress 项目目录：
npx openskills install WordPress/agent-skills安装完成后，项目里会出现类似：
.codex/skills/
.github/skills/
.claude/skills/不同 AI 工具会读取对应目录。
第四步：同步技能
npx openskills sync这样 AI 才能正式加载这些 Skill。
使用示例
以后你可以直接对 AI 说：
- 帮我创建一个符合规范的 WordPress 插件
- 生成一个 Gutenberg Block
- 启动测试环境验证插件
- 检查当前项目结构问题
AI 会自动触发对应 Skill，按标准流程操作。
你会明显发现：
- 代码更规范
- 结构更合理
- 安全细节更完整
- 出错率更低
实际开发建议
结合我的使用经验，推荐这样做：
先执行项目识别
再生成代码
最后自动测试验证
也就是：
triage → develop → test → fix这套流程比“直接生成代码”稳定很多。
另外要注意：
Agent Skills 只是辅助工具，不是替代人工审查。
安全相关逻辑仍建议自己复核。
总结
Agent Skills 可以理解为：
👉 给 AI 安装 WordPress 专业知识插件
它把多年积累的最佳实践，系统化地注入到智能助手中，让 AI 从“会写代码”升级为“懂 WordPress 的工程师”。
如果你：
- 经常用 AI 写插件
- 做 Gutenberg 开发
- 想提高自动化测试效率
- 希望减少低级错误
那么强烈建议把 Agent Skills 加入你的开发流程。
在 AI 时代，会用工具的人，效率会指数级提升。