agent-skills

让 AI 助手秒变 WordPress 开发专家，少踩坑

agent-skills 是一个为 AI 编程助手提供 WordPress 专家级知识的开源项目。它把 WordPress 开发中分散在文档、教程和社区经验里的知识，整理成 AI 助手可直接调用的技能包，覆盖区块（Blocks）、主题（Themes）、插件（Plugins）以及最佳实践。解决的核心问题是：通用 AI 助手在写 WordPress 代码时经常过时、不符合官方规范、忽略安全与性能细节。项目通过结构化技能定义，让助手在生成代码、审查代码或回答问题时，能引用准确的 API、目录结构和开发约定。核心能力包括区块开发指导、主题模板层级说明、插件架构建议、钩子与过滤器用法、安全转义与国际化规范等。适合用 AI 辅助 WordPress 开发、希望减少返工和低级错误的开发者。

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 2144

维护状态活跃

是否开源是

定价模式 free

项目数据

分类编程开发

开发团队WordPress

所属国家

官网地址

GitHubhttps://github.com/WordPress/agent-skills

定价模式free

价格说明开源免费

访问状态

是否开源是

开源协议NOASSERTION

主要语言JavaScript

技术栈/模型

GitHub 星标★ 2144

30天Star增速

HF 下载量

上线时间2026-01-20 00:00:00

最近更新2026-09-16 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-13

浏览次数0

使用教程

难度：入门约 10 分钟部署方式：命令行工具 7 步

环境要求

Node.js 环境（npx 可用）
已安装任一支持的 AI 编程助手：Claude Code、GitHub Copilot / VS Code、Codex、Cursor 或 Antigravity
若要使用仓库内的 skillpack 脚本，需把 agent-skills 仓库克隆到本地
项目级安装时需要一个目标仓库路径（如 ../your-wp-project）

安装与启动步骤

1列出可用技能

先用 --list 查看仓库里所有技能名，不实际安装，确认要装哪些。
```
npx skills add WordPress/agent-skills --list
```
2安装单个技能

用 --skill 指定技能名，例如插件开发技能 wp-plugin-development，npx 会自动拉取安装。
```
npx skills add WordPress/agent-skills --skill wp-plugin-development
```
3一次装多个技能

--skill 后可跟多个技能名，用空格分隔，如插件开发、Abilities API、Playground。
```
npx skills add WordPress/agent-skills --skill wp-plugin-development wp-abilities-api wp-playground
```
4克隆仓库

README 中的 skillpack 脚本位于仓库 shared/scripts/ 目录，需先克隆并在仓库根目录执行。
```
git clone https://github.com/WordPress/agent-skills
```
5全局装到Claude

加 --global 会把技能装到 ~/.claude/skills/，Claude Code 会自动发现，所有项目共用。
```
node shared/scripts/skillpack-install.mjs --global
```
6装进你的WordPress项目

用 --dest 指向目标项目，--targets 指定助手；会写入各助手的技能目录，需在仓库根目录执行。
```
node shared/scripts/skillpack-install.mjs --dest=../your-wp-project --targets=codex,vscode,claude,cursor
```
7手动安装

不想用脚本时，直接把仓库 skills/ 下的技能文件夹复制到 AI 助手对应的指令目录即可。

关键配置

配置项	必填	说明	示例
`--list`	否	列出仓库中全部可用技能，不执行安装	`npx skills add WordPress/agent-skills --list`
`--skill`	是	指定要安装的技能名，可空格分隔多个	`wp-plugin-development wp-abilities-api`
`--global`	否	全局安装，技能放到 ~/.claude/skills/ 供所有项目使用	`--global`
`--dest`	否	指定安装目标项目路径，实现项目级安装	`--dest=../your-wp-project`
`--targets`	否	指定目标 AI 助手，可选 codex、vscode、claude、cursor、antigravity	`--targets=codex,vscode,claude,cursor`
`--skills`	否	skillpack 脚本用逗号分隔的技能列表	`--skills=wp-playground,wp-block-development`

如何确认成功

检查技能是否出现在对应目录，如 ~/.claude/skills/ 或项目下 .cursor/skills/、.github/skills/，并让 AI 助手确认能读到该技能。

常见问题

Q：npx skills add 需要先安装什么？

A：需要本机有 Node.js 环境（自带 npx）。无需手动下载仓库，npx 会从 GitHub 拉取 WordPress/agent-skills 并安装指定技能。

Q：全局安装和项目内安装有什么区别？

A：全局安装（--global）把技能放到 ~/.claude/skills/，所有项目共用；项目安装（--dest）只写入目标仓库的助手目录，随项目走。

Q：支持哪些 AI 编程助手？

A：README 提到 Claude、Copilot、Codex、Cursor 等。脚本 targets 支持 codex、vscode、claude、cursor，Antigravity 需显式加入。

Q：为什么 Antigravity 技能没被装进项目？

A：Antigravity 在项目级安装中是选择性加入的，需要在 build 和 install 的 --targets 中显式写 antigravity，才会复制到 .agents/skills/。

Q：这些技能内容可靠吗？

A：技能由 GPT-5.2 Codex 依据 Gutenberg 与 WordPress 官方文档生成，再由 WordPress 贡献者审阅编辑，属 v1 版本，会随社区反馈迭代。

注意事项

node shared/scripts/... 的脚本路径是相对仓库根目录的，必须先克隆仓库并在仓库根目录执行。
Antigravity 的项目级安装默认不启用，需把 antigravity 加入 --targets 才会生成 .agents/skills/。
技能内容为 AI 生成后经人工审阅，v1 版本仍会随社区反馈更新，使用前建议核对官方文档。
可用 --dry-run 预览安装结果而不实际写入（README 中 skillpack-install 支持该参数）。

核心亮点

把 WordPress 区块、主题、插件知识结构化，AI 助手可直接调用，减少过时 API 和错误写法
覆盖安全转义、国际化、性能等最佳实践，帮助生成更符合官方规范的代码
以技能包形式组织，便于按需扩展和集成到不同 AI 编程工具中

不足之处

知识更新依赖维护者手动跟进 WordPress 版本，可能存在滞后
主要面向 AI 助手集成，普通开发者直接阅读和使用的体验有限

适用场景

用 AI 助手开发 WordPress 自定义区块时，获取准确的 block.json 和渲染逻辑指导
让 AI 审查现有主题或插件代码，指出不符合 WordPress 规范的写法
在 AI 辅助下快速搭建插件骨架，了解钩子和过滤器的最佳使用方式

替代项目

WordPress/wordpress-develop、wptrainingteam/developer-handbook

项目介绍

agent-skills 是一个编程开发领域的开源项目，官方简介：Expert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices。项目使用 JavaScript 开发，在 GitHub 上获得 2129 星标。

上一篇：OpenSpec

下一篇：open-spdd