用途:当 WordPress 站点、页面或接口变慢(前端 TTFB、后台、REST、WP-Cron),或需要性能剖析方案与工具建议、优化数据库查询、自动加载选项、对象缓存、定时任务、远程 HTTP 调用时使用。该技能假定智能体无法使用浏览器界面,优先使用 WP-CLI、日志与 HTTP 请求。
使用前提:需确认环境与安全限制(开发/测试/生产、是否禁止写入或安装插件);通过 --path=<path> 指定 WP 根目录,多站点用 --url=<url> 指定目标;明确性能症状与范围,如具体 URL/REST 路由/后台页面、发生时机(持续或偶发、登录或未登录)。
主要流程:先测量再优化,确认可否执行写操作,选取可复现目标并采集基线 TTFB。运行 node skills/wp-performance/scripts/perf_inspect.mjs --path=<path> [--url=<url>] 生成后端性能报告,检测 WP-CLI 可用性与核心版本、wp doctor / wp profile 是否可用、自动加载选项大小、对象缓存 drop-in 是否存在。若可用 WP-CLI,先执行 wp doctor check 发现常见问题。深度剖析推荐顺序为 wp profile stage、wp profile hook(可加 --url=)、wp profile eval。Query Monitor 可无界面使用,通过 REST 响应头 x-qm-* 或 ?_envelope 的 qm 属性查看,需用 nonce 或应用密码认证。
按瓶颈分类修复:数据库查询、自动加载选项、对象缓存未命中、远程 HTTP 调用、Cron。修复后用相同测量方式复验,确认性能变化且行为不变;高风险修复可加功能开关或分阶段发布。
限制与注意:无明确授权时不要在生产安装插件、启用 SAVEQUERIES、压测或清缓存;Query Monitor 在非生产环境使用以避免额外开销;需系统级剖析应与运维/主机商协调。资料提及 WordPress 6.9 前端性能改进:经典主题按需加载 CSS、无阻塞资源的区块主题、内联 CSS 阈值提高。