mcpField
W
wordpress-performance-best-practices

wordpress-performance-best-practices

github.com/bartekmis开发13714 次安装27 周前更新
代码仓库

关于 wordpress-performance-best-practices

WordPress Performance Best Practices 是供 AI Agent 和大模型参考的指南，用于审查和生成 WordPress 代码。其 34 条规则按影响优先级分为八类，涵盖数据库查询、缓存、媒体和 API 等方面。

主要功能

  1. 01八类共 34 条规则
  2. 02按性能影响排序
  3. 03数据库与查询建议
  4. 04缓存和资源管理
  5. 05主题、插件、媒体及 API 实践

适用场景

  1. 01审查 WordPress 代码的性能问题
  2. 02指导插件或主题开发
  3. 03优化查询、缓存和资源加载

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bartekmis/wordpress-performance-best-practices --skill wordpress-performance-best-practices

安装后在 Claude Code 中输入/wordpress-performance-best-practices确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.gitignore
LICENSE
AGENTS.md
README.md
metadata.json
build/
package-lock.json
tsconfig.json
package.json
build/src/
parser.ts
config.ts
build.ts
types.ts
validate.ts
rules/
_sections.md
asset-defer-async.md
advanced-autoload-optimization.md
asset-conditional-loading.md
_template.md
advanced-cron-optimization.md
api-rest-optimization.md
api-nonce-validation.md
advanced-memory-management.md
api-admin-ajax.md
advanced-query-monitor.md
asset-dequeue-unused.md
asset-minification.md
db-avoid-post-not-in.md
cache-fragment-caching.md
db-fields-optimization.md
db-limit-query-results.md

详细介绍

WordPress 性能最佳实践

面向 AI Agent 和大模型的 WordPress 开发综合性能优化指南。包含 8 个类别中的 34 条规则，并按影响程度排序，以指导代码审查和生成。

适用场景

在以下情况下参考这些指南：

  • 编写 WordPress 插件或主题
  • 使用 WP_Query 或执行数据库操作
  • 实现缓存（transients、对象缓存）
  • 优化资源加载（脚本、样式）
  • 审查 WordPress 代码中的性能问题
  • 使用 REST API 或 AJAX 处理程序

按优先级划分的规则类别

优先级类别影响前缀
1数据库优化严重db-
2缓存策略严重cache-
3资源管理高asset-
4主题性能高theme-
5插件架构中高plugin-
6媒体优化中media-
7API 和 AJAX中api-
8高级模式中低advanced-

快速参考

1. 数据库优化（严重）
  • db-prepared-statements - 查询始终使用 $wpdb->prepare()
  • db-avoid-post-not-in - 避免使用 post__not_in，改为在 PHP 中筛选
  • db-use-wp-query - 使用 WP_Query/get_posts，而不是直接查询数据库
  • db-limit-query-results - 切勿使用 posts_per_page => -1
  • db-meta-query-indexing - 优化元数据查询，并考虑使用分类法
  • db-fields-optimization - 只需要 ID 时使用 fields => 'ids'
2. 缓存策略（严重）
  • cache-transients-proper-use - 使用 transients 缓存外部 API 调用
  • cache-object-cache - 使用带缓存组的 wp_cache_*
  • cache-remote-requests - 始终缓存 wp_remote_get 响应
  • cache-invalidation - 实现精准的事件驱动失效机制
  • cache-fragment-caching - 缓存开销较大的模板片段
3. 资源管理（高）
  • asset-proper-enqueue - 使用 wp_enqueue_script/style，切勿硬编码
  • asset-conditional-loading - 仅在需要时加载资源
  • asset-defer-async - 对非关键脚本使用 defer/async
  • asset-dequeue-unused - 移除未使用的插件资源
  • asset-minification - 压缩资源，并使用关键 CSS
4. 主题性能（高）
  • theme-avoid-queries-in-templates - 避免在模板文件中执行查询
  • theme-template-parts - 使用 get_template_part 传递数据
  • theme-loop-optimization - 优化循环，并使用元数据/术语缓存预热
  • theme-hooks-placement - 使用恰当的钩子优先级
5. 插件架构（中高）
  • plugin-conditional-loading - 仅在需要时加载代码
  • plugin-autoloading - 使用 PSR-4 自动加载
  • plugin-activation-hooks - 使用激活钩子执行设置任务
  • plugin-hook-removal - 使用匹配的优先级正确移除钩子
6. 媒体优化（中）
  • media-responsive-images - 使用 srcset 和 sizes 属性
  • media-lazy-loading - 对首屏以下的内容延迟加载，对 LCP 内容即时加载
  • media-image-sizes - 定义合适的自定义图像尺寸
7. API 和 AJAX（中）
  • api-rest-optimization - 优化 REST 端点，并添加缓存标头
  • api-admin-ajax - 前端使用 REST API，避免使用 admin-ajax
  • api-nonce-validation - 实现正确的 nonce 验证
8. 高级模式（中低）
  • advanced-autoload-optimization - 将自动加载的选项控制在 800KB 以内
  • advanced-cron-optimization - 使用系统 cron，并将长时间任务分批处理
  • advanced-memory-management - 分批处理并清理内存
  • advanced-query-monitor - 优化前先进行性能分析

使用方法

阅读各个规则文件，了解详细说明和代码示例：

rules/db-prepared-statements.md
rules/cache-transients-proper-use.md
rules/_sections.md

每个规则文件都包含：

  • 对规则重要性的简要说明
  • 错误代码示例及说明
  • 正确代码示例及说明
  • 补充背景信息和参考资料

完整汇编文档

包含所有详细规则的完整指南：AGENTS.md

评论

支持 Markdown