WordPress Agent Skills 安装全指南全局 vs 项目作用域适配 Claude/Copilot/Cursor【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skillsWordPress Agent Skills 是专为 AI 编程助手打造的 WordPress 专家级技能包把区块、主题、插件、REST API 等官方开发最佳实践打包成 AI 可直接加载的技能。本文手把手教你 3 步完成 WordPress Agent Skills 安装并讲清全局作用域与项目作用域的区别让它同时适配 Claude Code、GitHub Copilot、Cursor 等主流 AI 编程工具从此告别 AI 生成的远古版WordPress 代码。一、先搞懂WordPress Agent Skills 是什么用 AI 助手写 WordPress 代码时你是否遇到过这些坑️ 生成 Gutenberg 之前的老式区块写法️ 插件开发漏掉关键的安全校验️ 跳过区块弃用deprecation处理导致 Invalid block 报错WordPress Agent Skills 的解法很简单给 AI 装上专家级 WordPress 知识库。项目内置 17 个技能覆盖开发全流程技能教会 AI 什么wordpress-router自动识别仓库类型路由到正确的工作流wp-block-development区块开发block.json、属性、弃用机制wp-block-themes区块主题theme.json、模板、样式变体wp-plugin-development插件架构、钩子、Settings API、安全wp-rest-apiREST API 路由、Schema、认证wp-abilities-api基于能力Ability的权限与 REST 认证wp-wpcli-and-opsWP-CLI 命令、自动化、多站点wp-performance性能分析、缓存、数据库优化wp-phpstanPHPStan 静态分析配置与 WP 类型标注完整清单见 README.md。每个技能都是一个自包含的文件夹包含主说明文档、参考文档和辅助脚本skills/wp-block-development/ ├── SKILL.md # 主指令何时使用、步骤、验证方式 ├── references/ # 细分主题的深度文档 │ ├── block-json.md │ └── deprecations.md └── scripts/ # 确定性辅助脚本检测、校验 └── list_blocks.mjs当你让 AI 处理 WordPress 代码时它会读取这些技能并按文档化的流程操作而不是靠猜。二、安装作用域对比全局 vs 项目怎么选这是安装前唯一需要做的决定。技能支持两种作用域且可以同时使用维度全局作用域 项目作用域 安装位置~/.claude/skills/、~/.cursor/skills/.claude/skills/、.github/skills/、.cursor/skills/生效范围你的所有项目仅当前项目可否提交到 Git否在用户主目录✅ 可提交整个团队共享适用人群每个仓库都想用上 WP 知识的个人开发者团队协作、需要统一 AI 行为的项目 关键点当同一个技能在两个作用域都存在时项目级版本优先生效。所以团队可以全局装一套基础技能再在特定项目里放定制版本。各 AI 工具对应的目录如下这也是后面--targets参数的含义工具项目级目录全局目录Claude Code.claude/skills/~/.claude/skills/VS Code / GitHub Copilot.github/skills/—Cursor.cursor/skills/~/.cursor/skills/OpenAI Codex.codex/skills/—Antigravity.agents/skills/~/.gemini/antigravity/skills/三、最快安装方式npx skills 一条命令不想碰构建脚本用官方推荐的npx skills命令最快 3 秒安装一个技能1️⃣ 安装单个技能npx skills add WordPress/agent-skills --skill wp-plugin-development2️⃣ 查看有哪些技能可装npx skills add WordPress/agent-skills --list3️⃣ 一次安装多个技能npx skills add WordPress/agent-skills --skill wp-plugin-development wp-abilities-api wp-playground命令默认走项目作用域装进当前仓库的.claude/skills/或.cursor/skills/可以直接提交到版本控制与团队共享。想装到全局加上--global即可npx skills add WordPress/agent-skills --skill wp-plugin-development --global四、进阶用构建脚本精准控制安装目标npx满足不了需求时仓库自带一套 Node.js 脚本可精确指定安装到哪个工具、哪些技能、什么模式。核心是两个文件构建脚本shared/scripts/skillpack-build.mjs安装脚本shared/scripts/skillpack-install.mjs4.1 克隆仓库并构建分发包git clone https://gitcode.com/gh_mirrors/agents/agent-skills cd agent-skills # 构建分发包生成 dist/ 目录含各工具的目录布局 node shared/scripts/skillpack-build.mjs --clean4.2 按目标安装全局安装到 Claude Code--global是 Claude 全局的快捷方式装到~/.claude/skills/node shared/scripts/skillpack-install.mjs --global全局安装到 Cursor装到~/.cursor/skills/node shared/scripts/skillpack-install.mjs --targetscursor-global项目级安装到你的 WordPress 仓库一次性覆盖 4 个工具node shared/scripts/skillpack-install.mjs --dest../your-wp-project --targetscodex,vscode,claude,cursor只装指定技能 指定工具比如只给 Claude 和 Cursor 装 WP-CLI 技能node shared/scripts/skillpack-install.mjs --dest../my-repo --targetsclaude,cursor --skillswp-wpcli-and-ops4.3 实用选项速查选项作用--list列出当前可安装的所有技能--dry-run干跑预览只显示将安装什么不实际写入--skillsa,b,c只安装列表中的技能默认全装--modereplace默认模式覆盖已存在的同名技能目录--modemerge合并模式保留已有内容⚠️ 小提醒安装脚本从dist/取文件所以必须先跑skillpack-build.mjs否则会提示 Missing source skillpack dir。五、安装后如何验证是否成功✅ 第一步看目录。检查目标路径下是否出现了技能文件夹每个都含SKILL.mdClaude 项目级.claude/skills/wp-plugin-development/SKILL.mdCursor 全局~/.cursor/skills/✅ 第二步问 AI 试一把。打开你的 AI 助手问一个 WordPress 问题比如如何正确弃用一个区块版本。如果回答里出现deprecations、render_callback、区块迁移流程等具体术语而非泛泛而谈说明技能已生效。✅ 第三步兼容性检查。技能默认面向 WordPress 7.0PHP 7.4.0详见 docs/compatibility-policy.md。运行安装脚本还需要本机装有Node.js脚本均为.mjs。六、常见问题快速答疑Q1不想全装 17 个技能怎么办用--skills只装需要的例如--skillswp-playground,wp-block-development。Q2项目级和全局级的同名技能会冲突吗不会。项目级版本优先正好用来覆盖团队定制逻辑。Q3能完全手动安装吗可以。把 skills/ 下任意技能文件夹直接复制到你所用 AI 助手的指令目录即可——这就是技能自包含文件夹设计的意义零依赖、无符号链接。Q4团队如何统一 AI 的 WordPress 开发规范选择项目作用域安装第四节的--dest方式把生成的.claude/skills/、.github/skills/等目录提交到 Git每个成员拉取代码后 AI 自动获得相同技能。总结个人开发者图省事npx skills add ... --global一条命令搞定全局安装团队协作则用构建脚本做项目级安装并提交到仓库。装好 WordPress Agent Skills 后你的 AI 助手将按官方最佳实践写区块、建主题、开发插件——快、稳、不出错。更多技能设计原理可参考 docs/principles.md 与 docs/packaging.md。【免费下载链接】agent-skillsExpert-level WordPress knowledge for AI coding assistants - blocks, themes, plugins, and best practices项目地址: https://gitcode.com/gh_mirrors/agents/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
