wp-performance – WordPress 性能优化 Skill

Skill 详细介绍

automattic/agent-skills#wp-performance 是 Automattic 官方 agent-skills 仓库中的一个 WordPress 性能优化 Skill。Automattic 是 WordPress.com 和 WooCommerce 的母公司，同时也维护 Jetpack 等 WordPress 生态核心产品，因此这个 Skill 出自 WordPress 生态中最权威的一方。

它不是一款可以独立运行的软件，也不是 WordPress 插件。它本质上是一套面向 AI Agent 的指令与知识集，安装后让 Agent 在处理 WordPress 站点时具备更系统、更贴合 WordPress 官方实践的判断能力，而不是泛泛地给通用 Web 优化建议。

核心用途

• 帮助识别 WordPress 站点的性能瓶颈，例如数据库查询、插件冲突、缓存配置、资源加载等问题。
• 优化页面加载速度相关的配置，包括缓存策略、图片与静态资源、脚本与样式加载方式。
• 审查 WordPress 主题与插件的性能影响，指出可能是性能元凶的具体组件。
• 给出符合 WordPress 官方技术路线的优化建议，而不是脱离 WordPress 架构的通用建议。

安装后 Agent 增加的能力

• 能用 WordPress 术语和概念体系分析问题，例如 hooks、transients、object cache、autoloaded options、enqueue 等。
• 能按 WordPress 的实际运行机制判断性能问题，而不是把 WordPress 当作一个普通 PHP 应用处理。
• 能在使用 WP-CLI、查询数据库、检查主题和插件代码时，按照性能视角给出更有针对性的建议。

它不是什么

• 不是一个自动扫描服务，不会在后台持续监控站点。
• 不是 WordPress 插件，不安装到 WordPress 站点本身。
• 不是托管平台或 CDN，不提供服务器侧的能力。
• 不能替代真实的性能测试工具（如 Lighthouse、WebPageTest、Query Monitor）。它更像是一个具备 WordPress 性能知识的协作者。

典型使用场景

• WordPress 站点加载慢，想定位可能的原因。
• 主题或插件数量多，想评估哪些对性能影响最大。
• 想把一个 WordPress 站点的配置调整到更符合性能优化方向的架构。
• 在开发或维护 WordPress 主题、插件时，希望 Agent 从性能角度审查代码。

适合的用户

• WordPress 站长、开发者、运维人员。
• 使用 WordPress 建站并关注 Core Web Vitals 的团队。
• 需要经常处理 WordPress 站点性能问题的自由职业者或代理公司。

不适合的需求

• 非 WordPress 站点的性能优化（例如纯静态站点、Next.js、Shopify 等）。这里说的是 WordPress 性能优化，不是通用 Web 性能优化。
• 希望一键自动修复所有性能问题的场景。Skill 提供的是 Agent 侧的分析和建议能力，具体改动仍需人来确认和执行。

Skill 安全评估

总体判断：来源可信度高，属于官方组织维护的 Skill，本身不包含明显的危险行为。但因为它涉及 WordPress 站点性能优化，实际风险主要取决于你在什么权限下让 Agent 操作站点。

来源可信度

• 维护方是 Automattic，WordPress 生态的官方组织，仓库为 automattic/agent-skills。这一点在 AI Skill 生态里属于较高可信等级。
• 类别上它属于 Agent 指令 / 知识集，不是会自行运行后台进程的可执行程序。

可能的权限与风险

• 文件读取：分析主题、插件、wp-config.php 等文件时需要读取 WordPress 站点文件。不要给 Agent 读取与站点无关的敏感目录。
• 文件写入：如果 Agent 帮你应用优化改动（例如调整配置、修改代码），会写入站点文件。在生产站点上给写权限需谨慎。
• Shell 权限：使用 WP-CLI、查询数据库、跑性能检测命令等场景需要 Shell。如果没有这个需求，可以关闭 Agent 自动执行 Shell 的权限，由你手动执行建议的命令。
• 数据库访问：检查 autoloaded options、查询慢 SQL 等场景需要读取数据库。注意备份，尤其是执行任何写操作之前。
• 网络访问：通常用于查阅 WordPress 官方文档、插件资料等。若只做本代码审查，可限制网络范围。
• 凭证：连接生产数据库、SSH 进入服务器时可能用到数据库密码、SSH Key 等。不要把生产环境的高权限凭证长期暴露在 Agent 会话中。

实操建议

1. 优先在测试环境或站点副本上让 Agent 进行性能分析与改动，确认无副作用后再迁移到生产环境。
2. 让 Agent 先给出分析和建议清单，由你决定哪些改动真正执行。
3. 如果只需要 Skill 帮助生成优化建议而不希望它直接改动站点，关闭 Agent 自动执行 Shell 和写入文件的权限。
4. 避免让 Agent 长期持有生产数据库或生产服务器的最高权限凭证。
5. 任何数据库写操作或主题 / 插件文件改动前，先做完整备份。

合理使用的前提下，这个 Skill 不会自行对站点做破坏性操作；风险主要来自你是否赋予它过高的执行权限。

Skill 使用要求

一、Agent / 客户端

该 Skill 来自 automattic/agent-skills 仓库，遵循通用 Agent Skill 的组织方式，因此可以优先在支持 Skills 的 Agent 中使用。官方没有公布完整的第三方 Agent 兼容列表。从工作方式来看，在支持 Skills 或自定义指令加载机制的环境中通常也可以尝试，例如 Claude Code、Codex、Cursor、Trae、OpenClaw、WorkBuddy。不同 Agent 的 Skill 加载方式和兼容程度可能不一样，具体以对应 Agent 当前版本为准。

二、运行环境 / 依赖

Skill 本身是 Agent 侧的指令内容，不要求本地必须安装特定语言运行时。真正会用到工具链的，是你分析的 WordPress 站点本身。

三、权限

• 文件读取：必需。分析主题、插件、配置时需要。
• 文件写入：可选。只有在让 Agent 应用改动时才需要。
• Shell：可选。使用 WP-CLI 或命令行工具时使用；不需要时可关闭自动执行。
• 数据库读取：可选。分析性能相关数据时使用。
• 网络：可选。查阅资料时使用。

四、账号 / API Key

Skill 本身不需要单独的账号或 API Key。但是，Skill 后续可能操作的 WordPress 站点本身会涉及凭证，例如：

• WordPress 管理后台账号（如果你希望 Agent 登录后台操作）。
• 数据库账号（连接站点数据库时）。
• SSH 凭证（远程服务器操作时）。
• 托管平台 / 云服务的访问密钥（云上 WordPress 场景）。

这些属于站点侧凭证，不是 Skill 自身的依赖。按最小权限原则提供即可。

最小使用条件

1. 一个可用的 Agent（支持 Skills 或自定义指令）。
2. 已安装或已加载该 Skill。
3. 一个需要优化的 WordPress 站点（本地或远端均可）。

Skill 安装、使用与卸载教程

一、安装

本页面已经提供该 Skill 的 Skill 安装指令，可以直接复制并粘贴到对应的 Agent 或终端中执行。这是一个 automattic/agent-skills 仓库下的 Skill，安装过程通常就是把这个 Skill 的目录或 SKILL.md 放到 Agent 能够加载 Skill 的位置。

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

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

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

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

让 Agent 根据自己的 Skill 加载 / 管理机制指导安装，比照搬一份通用教程更稳妥。

二、安装后如何使用

安装后，在你与 Agent 讨论 WordPress 站点性能问题时，Agent 会按该 Skill 的指令以更贴近 WordPress 官方实践的方式来处理。通常不需要专门“启动”命令，只要在相关对话里提到 WordPress 性能、缓存、插件、主题、加载速度等关键词即可触发。

适合交给这个 Skill 的任务类型：

• 分析某个 WordPress 站点为什么加载慢。
• 评估主题、插件对性能的影响。
• 给出符合 WordPress 架构的性能优化方案。
• 审查 WordPress 主题 / 插件的性能相关代码。

使用示例（自然语言，直接对 Agent 说）：

使用 wp-performance，帮我分析这个 WordPress 站点为什么首屏加载很慢。

使用 wp-performance，看看我现在装的这些插件里哪些对性能影响比较大。

使用 wp-performance，帮我审查这个主题函数的数据库查询是否存在性能问题。

三、卸载

卸载通常就是移除对应的 Skill。不同 Agent 的 Skill 安装位置和管理方式可能不同，如果没有统一卸载命令，直接询问当前 Agent 如何移除更稳妥：

如何卸载 automattic/agent-skills#wp-performance？

如果 Agent 或 Skill 管理器提供了删除方式（比如列出已安装 Skill 并删除），用它移除即可。移除后 Agent 不再加载这个 Skill，之前它对 WordPress 性能的分析能力也就随之撤销。

常见问题

问：安装后 Agent 好像没有按 WordPress 性能思路回答，是怎么回事？
可能原因：Agent 没有正确加载该 Skill；对话中没有给出足够的 WordPress 上下文；或者当前 Agent 对 Skill 的加载机制不同。可以明确对 Agent 说“使用 wp-performance”并附上具体站点信息，帮助它触发该 Skill。

问：这个 Skill 会自己改动我的 WordPress 站点吗？
Skill 本身只是指令与知识集，不会在你不发起请求时主动改动站点。具体是否会发生写操作或执行 Shell，取决于你给 Agent 的权限，以及你是否让它执行改动。只看分析不动手的话，可以关闭 Agent 的写文件和自动执行权限。

问：可以同时装到多个 Agent 里吗？
可以。Skill 是放在 Agent 侧加载的内容，不同 Agent 各自加载一份即可，互不冲突。各 Agent 的加载位置与方式按各自规则处理。

问：Skill 更新后需要重新安装吗？
取决于你使用的 Agent 的 Skill 管理方式。如果 Agent 支持从远程源自动更新，可能不需要手动操作；如果安装的是本地副本，需要按 Agent 的更新方式拉取最新版本。具体以该 Skill 当前官方说明和你的 Agent 机制为准。

问：中国大陆使用有没有网络要求？
这个 Skill 的内容来源在 GitHub 等海外代码托管平台，首次获取或更新时可能受网络环境影响。日常使用（已安装后）主要看你分析的 WordPress 站点在哪里，以及 Agent 是否被允许联网检索资料。这是 Skill 侧的判断，不涉及中国本土化的业务场景。

问：和通用的 Web 性能优化 Skill 有什么区别？
区别在于它针对的是 WordPress 这一具体架构：缓存机制、插件生态、主题结构、WP-CLI、数据库结构、hooks 等。通用 Web 性能 Skill 通常给的是更宽泛的建议（CDN、图片压缩、HTTP/2 等），而 wp-performance 会从 WordPress 实际运行机制出发给出更贴合站点的判断。

问：适合直接用于生产站点吗？
分析和建议阶段通常没问题，但任何会修改文件、配置或数据库的操作，建议先在测试环境或站点副本上验证。生产环境使用前做完整备份，并考虑把 Agent 的写入与 Shell 执行权限按需收紧。