wp-plugin-development – WordPress 插件开发 Skill

Skill 详细介绍

automattic/agent-skills#wp-plugin-development 是 Automattic 在 agent-skills 仓库中提供的一个 WordPress 插件开发类 Skill。它不是一个可以独立运行的软件、也不是一个 npm 包或 WordPress 插件本体，而是一套面向 AI Agent 的开发指令与工作流集合，用来指导 Agent 按照 WordPress 官方约定的方式完成插件的搭建、编写与调整。

换句话说，它给 Agent 增加的能力是：在 WordPress 插件这类具体开发任务上，提供更贴近 WordPress 生态习惯的指导和代码组织方式，而不是让 Agent 学会全新的语言或框架。

它是什么

• 一个 Agent Skill，属于 Automattic agent-skills 仓库中的一个子项，Skill 名称可识别为 wp-plugin-development。
• 面向 WordPress 插件开发场景的指令集 / 工作流。
• 服务于 Claude Code 等支持 Agent Skills 机制的客户端。

它不是什么

• 不是 WordPress 插件本身，不会直接在你的 WordPress 站点上新增功能。
• 不是独立程序或服务，不能脱离 AI Agent 单独运行。
• 不是 WordPress 核心、WooCommerce、Gutenberg 等官方项目的替代品。
• 不是一个会自动帮你部署、发布插件的工具。

核心用途

• 让 Agent 在编写 WordPress 插件时遵循 WordPress 的目录结构、钩子机制、命名与编码约定。
• 帮助梳理一个插件从需求到骨架、从函数到钩子、从后台页面到前端输出的开发流程。
• 在修改已有插件、排查插件结构问题时提供一致的参考框架。

主要解决的问题

• 通用 Agent 在写 WordPress 插件时容易产出“像 PHP 但不像 WordPress”的代码，例如滥用全局函数、忽略 hooks、目录结构随意。
• 插件开发涉及较多约定（plugin header、enqueue、activation / deactivation hook、nonce、capability 检查等），没有专门指令时 Agent 容易遗漏。
• 团队希望 Agent 生成的插件代码风格更统一，减少人工二次返工。

典型任务

• 生成一个 WordPress 插件的基础结构，包括主插件文件、插件头信息、目录组织。
• 基于需求编写具体的功能代码，例如注册自定义文章类型、添加后台设置页、注册 shortcode、挂载 hook。
• 对已有插件代码进行重构，使其更符合 WordPress 的编码规范。
• 解释某段插件代码的作用，或指出可能违反 WordPress 约定的地方。

适合哪些用户

• 使用 Claude Code 等支持 Skills 的 Agent 进行 WordPress 插件开发的开发者。
• 需要在 Agent 辅助下快速搭建插件骨架、验证插件结构的团队。
• 希望 Agent 输出的 WordPress 代码更规范、更贴近官方约定的用户。

不太适合的需求

• 只想给自己的 WordPress 站点装现成插件、不想写代码的用户。
• 使用完全不了解 Agent Skills 机制的工具，且没有对应的 Skill 加载能力。
• 期望一键完成插件发布、上架 WordPress.org 的全自动流程。

和普通 Agent 能力的区别

通用 Agent 已经能写 PHP 和 WordPress 相关代码，但缺少针对插件开发的专门指令。这个 Skill 的价值在于把 WordPress 插件开发的约定、结构和流程前置到 Agent 的上下文里，让输出更贴近 WordPress 生态的写法，而不是让 Agent 从零开始判断。

Skill 安全评估

总体判断：该 Skill 来自 Automattic 官方 agent-skills 仓库，属于指令类的 Skill，本身不是可执行程序。它不包含需要联网上传数据、也不包含内置的第三方 API 凭证。主要风险取决于你把 Agent 的权限开到了什么程度，而不是 Skill 本身。

来源可信度

• Skill 位于 automattic/agent-skills 仓库，由 Automattic 维护，属于官方一手来源，来源可信度相对较高。
• 使用时建议以该仓库中当前的 SKILL.md 与说明为准，避免使用来路不明的同名副本或第三方重新打包版本。

与当前 Skill 相关的安全点

• 文件读取与写入：插件开发任务通常需要 Agent 读取你的项目目录、创建或修改 PHP 文件。这类权限是任务正常需要，但意味着 Agent 可能改到你已有的插件文件。
• Shell 权限：如果 Agent 被允许执行 Shell，可能在开发过程中运行 PHP、Composer 或 WP-CLI 之类的命令。是否开启由你决定，不是 Skill 强制要求。
• 网络访问：开发本身不一定需要联网。若 Agent 联网，通常是去查 WordPress 文档或依赖，这类行为由 Agent 的联网权限控制。
• 代码注入 / 生成的代码质量：Agent 生成的插件代码默认是可信度未知的第三方程式。涉及 nonce、capability、SQL 拼接等安全写法时，建议自行审查后再启用。
• Prompt Injection：如果 Agent 在处理你不完全信任的插件代码或文件时被诱导，存在被注入指令的可能。对来源不明的代码库要谨慎。

降低风险的建议

• 如果只是想让 Agent 帮忙写插件代码，可以关闭 Agent 自动执行 Shell 的权限，由你手动运行安装、构建、测试命令。
• 在独立的开发环境或版本控制下工作，让 Agent 修改前先提交一次，方便回滚。
• 生成的插件代码在真正上到生产站点前，自行过一遍 nonce、权限、SQL 与输出转义。
• 不要直接使用来源不明的同名 Skill 副本，优先从 Automattic 官方仓库获取。

不建议的表述

无法对该 Skill 给出“完全无风险”“绝对安全”之类的结论。安全与否主要取决于你的 Agent 权限配置、运行环境，以及你对生成代码的审查程度。

Skill 使用要求

一、Agent / 客户端

• 该 Skill 来自 Automattic 的 agent-skills 仓库，属于通用 Agent Skills 形式。由于 Automattic 同时也是 Claude 相关生态的重要参与方，实际使用中通常会优先在 Claude Code 这类支持 Agent Skills 的客户端中使用。
• 官方没有公布完整的第三方 Agent 兼容列表。从 Agent Skill 的工作方式看，在支持 Skills、自定义 Skill 或类似指令加载机制的环境中，通常也可以尝试在 Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 AI Agent 中使用。
• 不同 Agent 的 Skill 加载方式和兼容程度可能不同，具体以对应 Agent 当前版本为准。是否“完美适配”，没有官方依据，不要轻信宣传性的说法。

二、运行环境 / 依赖

• 该 Skill 本身是指令类内容，不强制要求本机安装 Node.js、Python 或 Docker。
• 但你在开发 WordPress 插件时，实际的运行环境通常需要以下条件（是否必需取决于你打算怎么用）：

官方没有为这个 Skill 公布硬性的版本号要求，遇到具体版本问题时以 WordPress 官方文档和你的运行环境为准。

三、权限

• 文件读取：必需。Agent 需要读取你的项目目录。
• 文件写入：必需。插件开发通常要创建或修改 PHP、CSS、JS 等文件。
• Shell：可选。是否允许 Agent 执行命令由你决定，不开启也能完成大部分代码编写任务。
• 网络：可选。开发本身不依赖网络。
• GitHub：可选。仅当你想让 Agent 直接和远程仓库交互时才需要。

四、账号 / API Key

• 该 Skill 本身不需要账号、API Key 或 Token。
• 如果你在开发过程中使用到某些第三方服务（例如某个外部 API 的 WordPress 客户端），相关的 Key 是你所开发项目需要的，与 Skill 本身无关。
• 不要把这个 Skill 与“需要使用某些云服务”划等号。

最小使用条件

1. 一个支持 Agent Skills 的 Agent 客户端（Claude Code 等）。
2. 一个可以写入的插件开发目录。
3. 可选的本地 WordPress 环境，用于验证插件行为。

Skill 安装、使用与卸载教程

一、安装

LemonAIKit 的 Skill 详情页已经单独提供该 Skill 的安装指令，可以直接复制本页提供的安装指令，粘贴到对应的 Agent 或终端执行。无需再手动 git clone 或复制目录。

如果你不确定自己的 Agent 应该怎么装，可以直接问当前 Agent：

如何安装 automattic/agent-skills#wp-plugin-development？

如何在 Claude Code 中安装 automattic/agent-skills#wp-plugin-development？

如何在 Cursor 中安装 automattic/agent-skills#wp-plugin-development？

让当前 Agent 根据自己的 Skill 加载 / 管理机制指导安装，通常比照着通用教程逐条敲命令更稳妥。不同 Agent 的 Skill 安装位置、加载方式可能不一样。

二、安装后如何使用

安装后，当你在对话中提出 WordPress 插件开发相关的任务时，Agent 会在需要的时候调用该 Skill 的指令。你不需要记住具体的触发命令，直接用自然语言描述需求即可。常见的描述方式例如：

使用 wp-plugin-development，帮我生成一个 WordPress 插件骨架，用来注册一个自定义文章类型。

使用 wp-plugin-development，检查这个插件目录的结构是否符合 WordPress 插件开发约定，并指出可以改进的地方。

使用 wp-plugin-development，给这个插件加一个后台设置页面，用 Settings API 保存选项。

适合交给它的任务类型包括：插件骨架生成、钩子与钩子函数的对应、后台页面、shortcode、自定义文章类型、插件代码重构等。描述需求时，尽量说明清楚插件要做什么、在哪个 WordPress 版本、是否需要和现有主题或插件配合。

三、卸载

该 Skill 的卸载方式取决于你使用的 Agent 如何管理 Skill。通用做法是：

• 使用对应 Agent / Skill 管理器提供的删除或禁用方式，移除该 Skill。
• 或直接询问当前 Agent：“如何卸载 automattic/agent-skills#wp-plugin-development？”由它按本机的 Skill 管理机制处理。

不同 Agent 的 Skill 安装位置和管理方式可能不同。如果官方没有提供统一卸载命令，直接询问当前 Agent 通常比照搬某个平台的删除步骤更稳妥。这里不提供未经确认的卸载命令。

常见问题

1. 这个 Skill 会直接修改我现有的 WordPress 站点吗？

不会。它只是 Agent 的指令类 Skill，本身没有任何运行时行为。是否会修改文件、是否执行命令，取决于你在 Agent 里给了哪些权限，以及你的任务描述。如果只想让它输出代码而不落盘，可以在提示里明确说明“只给代码，不要修改文件”。

2. 可以同时装到 Claude Code 和 Cursor 吗？

可以，前提是这两个客户端都支持 Agent Skills 或类似的指令加载机制。分别按各自的安装方式装一次即可，互不影响。使用体验可能因 Agent 对 Skill 的支持程度不同而有差异。

3. 和中国大陆的网络环境有关吗？

该 Skill 来自 Automattic 的 GitHub 仓库。安装时是否需要访问 GitHub、是否需要处理网络可达性问题，取决于你所在环境和 Agent 的获取方式。Skill 本身的开发任务（写 WordPress 插件）不依赖境外网络。

4. Skill 更新后需要重新安装吗？

取决于你的 Agent 如何管理 Skill。有的方式是本地快照，更新需要重新拉取；有的会跟随源同步。没有统一答案，建议按你所用 Agent 的 Skill 管理说明操作，或直接问当前 Agent。

5. 它和直接让 Agent 写 WordPress 插件代码有什么区别？

区别在于是否带针对插件开发的专门指令。通用 Agent 也能写 PHP 和 WordPress 代码，但可能忽略插件头、钩子、目录结构、nonce / capability 等约定。该 Skill 的作用是把这些约定前置到 Agent 的上下文里，让输出更贴近 WordPress 插件开发的习惯写法。最终代码质量仍然需要你自己审查。

6. 安装后 Agent 没识别到这个 Skill，怎么办？

先确认 Agent 版本是否支持 Agent Skills；再确认 Skill 的放置位置和加载方式是否符合该 Agent 的要求；最后确认当前会话是否已经重新加载。不同 Agent 的排查方式不同，最直接的办法是问当前 Agent：“为什么没有加载 wp-plugin-development 这个 Skill？”

7. 生成的插件代码可以直接上生产吗？

不建议不加审查直接上生产。Agent 生成的代码属于可信度未知的第三方程式，涉及数据库写入、权限判断、输出转义的部分建议人工过一遍，并在测试环境先验证行为。