claude-wordpress-skills

為什麼要用

核心特性

內建 WordPress Coding Standards（WPCS）
使用現代工具鏈進行 Gutenberg 區塊開發
資安模式：nonces、capabilities、sanitization、escaping
效能優化：物件快取、transients、查詢調校
主題／外掛封裝、i18n、無障礙設計檢查清單

即時演示

實際使用效果

claude-wordpress-skill.replay ▶ 就緒

0/0

安裝

作者儲存庫 · Claude Skills 官方文件

使用場景

實戰用法： claude-wordpress-skills

如何以現代方式建立 Gutenberg 區塊

👤 建立自訂區塊的 WordPress 開發者 ⏱ ~45 min intermediate

何時使用： 需要自訂編輯器區塊，但不想手動搭建過時的 ESNext + webpack 腳手架。

步驟

描述區塊需求

Build a Testimonial block: quote text, author name, author photo — edit and save views.✓ 已複製

→ block.json + edit.js + save.js scaffolded, @wordpress/scripts build setup
新增屬性與控制項

Add an alignment control and a color picker.✓ 已複製

→ BlockControls / InspectorControls added correctly
打包並註冊

Write the PHP that registers the block from block.json.✓ 已複製

→ register_block_type( __DIR__ . '/build/block.json' )

結果： 一個具備正確封裝的現代 Gutenberg 區塊。

注意事項

缺少 i18n 包裝 — 技能包會提醒 Claude 使用 __() 和 _x() 包裝字串

搭配使用： filesystem

稽核外掛常見的 WordPress 資安問題

👤 外掛維護者、網站擁有者 ⏱ ~60 min advanced

何時使用： 在發布外掛之前，或接手他人外掛時。

步驟

確定稽核範圍

Audit this plugin for: nonce usage on every form, capability checks on every action, output escaping, SQL prep.✓ 已複製

→ Per-category findings with file:line
修復高風險問題

Apply the top 3 fixes — nonces on the admin form, esc_html on the dashboard widget, $wpdb->prepare on the custom query.✓ 已複製

→ Diffs to the plugin files
回歸測試

List what to manually test to confirm the fixes don't break anything.✓ 已複製

→ Short manual test checklist

結果： 一個已有文件記錄修復項目、更為安全的外掛。

注意事項

在已有 REST 權限回呼的情況下誤報 nonce 問題 — 提供上下文說明：已設定權限回呼的 REST 路由不需要表單 nonce

搭配使用： github

對速度緩慢的 WordPress 網站進行效能優化

👤 負責 WordPress 網站效能的開發者 ⏱ ~60 min advanced

何時使用： TTFB 過高、後台反應緩慢，或某個特定範本拖慢整體速度。

步驟

找出效能瓶頸

Walk me through common WordPress perf bottlenecks and which log/profiling tool to start with.✓ 已複製

→ Query Monitor, debug.log, object cache check
查詢調校

Here are the top 5 slow queries. Suggest indexes or query rewrites.✓ 已複製

→ Per-query recommendations
快取策略

Which caching layers should be active here? Object cache, page cache, fragment caching — suggest a stack.✓ 已複製

→ Concrete cache plan with plugins/services

結果： 可在下次部署後實際量測到的具體效能提升。

注意事項

在未修復底層慢查詢的情況下直接安裝快取外掛 — 每次變更前後都要進行量測

組合

與其他 MCP 搭配，撬動十倍槓桿

claude-wordpress-skill + filesystem

跨外掛／主題目錄進行稽核與重構

Audit wp-content/plugins/my-plugin/ for security issues and apply the top 5 fixes.✓ 已複製

claude-wordpress-skill + github

為資安修復建立附有說明的 PR

Open a PR titled 'Security: nonces on admin forms' with the patches.✓ 已複製

工具

此 MCP 暴露的能力

工具	輸入參數	何時呼叫
gutenberg-block-authoring	block intent + attributes	任何自訂區塊開發工作
wp-security-audit	plugin/theme path	發布前或接手外掛時的審查
wp-performance-review	slow endpoints + config	需要改善速度時
wp-coding-standards	any PHP/JS code	撰寫程式碼時自動套用

成本與限制

運行它的成本

API 配額: none
每次呼叫 Token 數: 5–20k per audit or block
費用: free
提示: 以單一檔案或功能為範圍進行操作；不要一次把 100 個外掛餵給 Claude

安全

權限、密鑰、影響範圍

憑證儲存： 技能包本身不儲存任何憑證；若同時使用部署／REST 工具，則需提供 WP 後台帳號憑證

資料出站： none

資安稽核結果僅供參考——正式上線的電商網站請委託專業資安稽核

故障排查

常見錯誤與修復

Block build fails with @wordpress/scripts

確認 Node 版本，以及 @wordpress/scripts 已列於 devDependencies；重新建置。

驗證： node -v && npx wp-scripts --version

Claude suggests outdated enqueue patterns

指定你所目標的 WordPress 版本，並優先使用 register_block_type_from_metadata。

替代方案