wp-performance-review
WordPress performance code review and optimization analysis. Use when reviewing WordPress PHP code for performance issues, auditing themes/plugins for scalability, optimizing WP_Query, analyzing caching strategies, checking code before launch, or detecting anti-patterns, or when user mentions "performance review", "optimization audit", "slow WordPress", "slow queries", "high-traffic", "scale WordPress", "code review", "timeout", "500 error", "out of memory", or "site won't load". Detects anti-patterns in database queries, hooks, object caching, AJAX, template loading, and editor-side performance.
jorgerosal · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add jorgerosal/wordpress-skills --skill wp-performance-review技能说明
name: wp-performance-review description: WordPress performance code review and optimization analysis. Use when reviewing WordPress PHP code for performance issues, auditing themes/plugins for scalability, optimizing WP_Query, analyzing caching strategies, checking code before launch, or detecting anti-patterns, or when user mentions "performance review", "optimization audit", "slow WordPress", "slow queries", "high-traffic", "scale WordPress", "code review", "timeout", "500 error", "out of memory", or "site won't load". Detects anti-patterns in database queries, hooks, object caching, AJAX, template loading, and editor-side performance.
WordPress Performance Review Skill
Overview
Systematic performance code review for WordPress themes, plugins, and custom code. Core principle: Scan critical issues first (OOM, unbounded queries, cache bypass), then warnings, then optimizations. Report with line numbers and severity levels.
When to Use
Use when:
- Reviewing PR/code for WordPress theme or plugin
- User reports slow page loads, timeouts, or 500 errors
- Auditing before high-traffic event (launch, sale, viral moment)
- Optimizing WP_Query or database operations
- Investigating memory exhaustion or DB locks
Don't use for:
- Security-only audits (use wp-security-review when available)
- Gutenberg block development patterns (use wp-block-development when available)
- General PHP code review not specific to WordPress
- Product or UX review that does not involve WordPress performance behavior
Code Review Workflow
- Identify file type and apply relevant checks below
- Scan for critical patterns first (OOM, unbounded queries, cache bypass)
- Check warnings (inefficient but not catastrophic)
- Note optimizations (nice-to-have improvements)
- Report with line numbers using output format below
File-Type Specific Checks
Plugin/Theme PHP Files (functions.php, plugin.php, *.php)
Scan for:
query_posts()→ CRITICAL: Never use - breaks main queryposts_per_page.*-1ornumberposts.*-1→ CRITICAL: Unbounded querysession_start()→ CRITICAL: Bypasses page cacheadd_action.*init.*oradd_action.*wp_loaded→ Check if expensive code runs every requestupdate_optionoradd_optionin non-admin context → WARNING: DB writes on page loadwp_remote_getorwp_remote_postwithout caching → WARNING: Blocking HTTP
WP_Query / Database Code
Scan for:
- Missing
posts_per_pageargument → WARNING: Defaults to blog setting 'meta_query'with'value'comparisons → WARNING: Unindexed column scan- Large
post__not_inarrays with pagination/sorting → WARNING: Can generate expensive SQL; review case-by-case LIKE '%term%'(leading wildcard) → WARNING: Full table scan- Missing
no_found_rows => truewhen not paginating → INFO: Unnecessary count
AJAX Handlers (wp_ajax_*, REST endpoints)
Scan for:
admin-ajax.phpusage → INFO: Consider REST API instead- POST method for read operations → WARNING: Bypasses cache
setIntervalor polling patterns → CRITICAL: Self-DDoS risk- Missing nonce verification → Security issue (not performance, but flag it)
Template Files (*.php in theme)
Scan for:
- Custom queries, uncached
get_post_meta(), or remote calls inside loops → WARNING: Repeated work / N+1 risk - Database queries inside loops (N+1) → CRITICAL: Query multiplication
wp_remote_getin templates → WARNING: Blocks rendering
JavaScript Files
Scan for:
$.post(for read operations → WARNING: Use GET for cacheabilitysetInterval.*fetch\|ajax→ CRITICAL: Polling patternimport _ from 'lodash'→ WARNING: Full library import bloats bundle- Inline
<script>making AJAX calls on load → Check necessity
Block Editor / Gutenberg Files (block.json, *.js in blocks/)
Scan for:
- Heavy editor-side data fetching or preview logic → WARNING: Slows editor load
wp_kses_post($content)in render callbacks → WARNING: Breaks InnerBlocks- Large editor bundles or broad imports → WARNING: Bloats editor runtime
Asset Registration (functions.php, *.php)
Scan for:
wp_enqueue_scriptwithout version → INFO: Cache busting issueswp_enqueue_scriptwithoutdefer/asyncstrategy → INFO: Blocks rendering- Missing
THEME_VERSIONconstant → INFO: Version management wp_enqueue_scriptwithout conditional check → WARNING: Assets load globally when only needed on specific pages
Transients & Options
Scan for:
set_transientwith dynamic keys (e.g.,user_{$id}) → WARNING: Table bloat without object cacheset_transientfor frequently-changing data → WARNING: Defeats caching purpose- Large data in transients on shared hosting → WARNING: DB bloat without object cache
WP-Cron
Scan for:
- Missing
DISABLE_WP_CRONconstant → INFO: Cron runs on page requests - Long-running cron callbacks (loops over all users/posts) → CRITICAL: Blocks cron queue
wp_schedule_eventwithout checking if already scheduled → WARNING: Duplicate schedules
Search Patterns for Quick Detection
# Critical issues - scan these first
rg -n "posts_per_page\s*.*-1|numberposts\s*.*-1" .
rg -n "query_posts\s*\(" .
rg -n "session_start\s*\(" .
rg -n "setInterval.*(fetch|ajax|\\$\\.)" .
# Database writes on frontend
rg -n "update_option|add_option" . -g '*.php'
# Uncached expensive functions
rg -n "url_to_postid|attachment_url_to_postid|count_user_posts" .
# External HTTP without caching
rg -n "wp_remote_get|wp_remote_post|file_get_contents\s*\(\s*['\"]https?://" .
# Cache bypass risks
rg -n "setcookie|session_start" .
# PHP code anti-patterns
rg -n "in_array\s*\(" . -g '*.php' # Manually verify strict comparison
rg -n "<<<" .
rg -n "cache_results\s*=>\s*false|cache_results\s*,\s*false" .
# JavaScript bundle issues
rg -n "import\s+_\s+from\s+['\"]lodash['\"]" . -g '*.{js,jsx,ts,tsx}'
# Asset loading issues
rg -n "wp_enqueue_script|wp_enqueue_style" . -g '*.php'
# Transient m
阅读完整来源 ↗