wp-performance

wp-performance 技能概览

wp-performance 是用来做什么的

wp-performance 技能帮助你在不依赖浏览器界面的前提下，从后端排查并优化 WordPress 性能。它适合那种需要把“这个站点很慢”落到可测量修复路径的场景，尤其适用于 WordPress 6.9+ 环境中的 Performance Optimization 工作。

谁应该安装它

如果你要处理前台请求、后台管理页、REST 路由或 WP-Cron 活动变慢的问题，并且希望有一套指导式流程来完成性能剖析、诊断和安全验证，那么就该使用 wp-performance 技能。它尤其适合你可以使用 WP-CLI、日志和直接 HTTP 请求，但无法进行完整浏览器调试会话的情况。

它最擅长覆盖什么

wp-performance 技能最强的部分，是先测量再分流的初筛，以及围绕数据库查询、autoloaded options、object caching、cron 和远程 HTTP 调用的后端修复。它还会帮你选对工具，包括 wp profile、wp doctor、通过 REST headers 查看 Query Monitor，以及在可用时使用 Server-Timing。

如何使用 wp-performance 技能

正确安装并限定作用范围

先在 WordPress/agent-skills 集合里运行 wp-performance install 流程，技能 slug 使用 wp-performance，然后在开始分析前确认目标站点上下文。这个技能在你提供 WordPress 根目录的 --path=<path>，以及对于 multisite 或路由型部署提供要评估的具体站点或端点 --url=<url> 时，效果最好。

提供它真正需要的输入

一个有质量的 wp-performance usage 提示应该同时包含症状、范围和环境。例如：“Staging 站点，不允许写入，登录后后台仪表盘很慢，使用 wp-performance 先剖析主查询路径，并优先给出只读检查建议。”这比“站点很慢”更有用，因为它明确了要测什么，以及哪些限制要遵守。

先读对文件

先从 SKILL.md 开始，再根据症状阅读 references/measurement.md、references/database.md、references/autoload-options.md、references/object-cache.md、references/cron.md 和 references/http-api.md。如果你需要无头 Query Monitor 或命令驱动检查，还要查看 references/query-monitor-headless.md、references/wp-cli-profile.md、references/wp-cli-doctor.md 和 scripts/perf_inspect.mjs，从中获取流程提示。

使用先测量、后改动的工作流

最好的 wp-performance guide 流程是：先抓基线，再测试一个可复现的 URL 或 REST route，找出成本最高的层，再在做了针对性改动后验证结果。整个过程中要固定场景，多次采样而不是只看一次尖峰，并且除非你明确允许，否则不要要求破坏性操作。

wp-performance 技能常见问题

wp-performance 只适合后端代理吗？

是的。这个技能专为基于 WP-CLI、headers、日志和 HTTP 请求的后端排查而设计。如果你需要浏览器交互、可视化 waterfall 分析或点击路径测试，wp-performance 就不是合适的主工具。

它和通用提示词有什么区别？

通用提示词可能只会让你“优化 WordPress”，而 wp-performance 提供的是一套受约束的工作流，覆盖测量、护栏以及 WordPress 特有的故障域。这一点很重要，因为最终修复取决于瓶颈到底是 DB queries、autoload 膨胀、cron，还是远程 HTTP 调用。

它适合新手吗？

适合，只要你能描述症状并提供安装上下文。这个技能对新手有帮助，因为它会收窄最先要检查的内容；但你仍然需要提供清晰的目标 URL 或 route，并说明是否允许写入、安装插件或清空缓存。

什么时候不该用它？

如果问题与 WordPress 执行本身无关，比如 CDN 路由、DNS 故障，或纯前端 JavaScript 瓶颈，就不要用 wp-performance。当你无法访问服务器、无法运行 WP-CLI，也没有办法检查 HTTP 响应或日志时，它也不太适合。

如何改进 wp-performance 技能

提供更有力的起始证据

最有用的输入是一个具体目标加上一种症状模式：https://example.com/wp-json/...、“只有登录编辑才慢”、“TTFB 每 5 分钟飙一次”，或者“登录后后台页面卡住”。这样 wp-performance 就能选择正确的测量路径，而不是靠猜。

说明允许做哪类改动

如果你希望先做安全的初步排查，就直接说明。例如：“只做只读诊断”、“不要清空缓存”，或“仅限 staging，可以改 options”。这样能改进 wp-performance skill 的输出，因为工作流可以避开高风险检查，并始终停留在你的操作边界内。

要求它给出修复路径，而不只是诊断结果

最好的 wp-performance usage 结果，来自你同时要求瓶颈和下一步验证动作。例如：“找出最慢的一层，指出最可能的原因，并给出用于确认改善的精确后续命令或请求。”这样输出才真正可执行。

在第一次报告基础上继续迭代

如果第一轮结果指向 queries，就把慢表、hook 或 route 反馈回去，要求更窄的 query plan。如果它指向 autoloaded options、object cache、cron 或 HTTP API 调用，就让它给出最小安全修复方案，以及一套改前/改后的测量计划。对于 Performance Optimization 工作来说，这正是 wp-performance 技能价值最大的地方。