دليل داخلي · فريق السيو

إزاي نسرّع أي موقع ووردبريس
بـ Claude + سكيل wp-performance

الدليل ده بيشرحلك الـ workflow كامل خطوة بخطوة: من تنزيل السكيل وفتح الـ SSH على هوستنجر، لحد ما Claude ياخد باك اب، يقيس، يشخّص، يصلّح، ويطلّع نتايج PageSpeed خضرا — وإنت عارف كل خطوة بيعملها وليه.

96Performance
100Best Practices
100SEO
94Accessibility

01الفكرة في دقيقة

السكيل مش plugin ولا برنامج — هي دليل شغل (ملف SKILL.md + ملفات مراجع + سكريبت فحص) بيخلّي Claude يمشي بنفس الترتيب الصح كل مرة: أمان ← قياس ← تشخيص ← إصلاح ← قياس تاني. إنت دورك إنك تجهّز الوصول، تراجع، وتوافق على الخطوات الحساسة.

🧑‍💻 إنتتجهيز + موافقة
←
🔐 SSH + ChromeClaude يوصل للسيرفر والمتصفح
←
💾 Backupقبل أي حاجة
←
📏 BaselinePageSpeed + TTFB
←
🩺 تشخيصperf_inspect · doctor · profile
←
🛠️ إصلاحفئة واحدة كل مرة
←
✅ Verifyنفس القياس تاني
←
📄 تقريرقبل / بعد

📘 SKILL.md

العقل: الإجراءات المرقّمة اللي Claude بيمشي عليها بالترتيب.

📚 references/

ملفات قصيرة لكل موضوع: الداتابيز، الـ autoload، الكاش، الكرون، الـ HTTP.

⚙️ perf_inspect.mjs

سكريبت بيطلّع تقرير JSON عن حالة الموقع من غير ما يغيّر أي حاجة.

02محتاج إيه قبل ما تبدأ

جهّز الحاجات دي الأول عشان الشغل ما يقفش في النص.

🔑 وصول

  • دخول hPanel بتاع هوستنجر للموقع
  • بيانات SSH (Host, Port, Username, Password)
  • أدمن على ووردبريس (للمراجعة بعد الشغل)

🧰 أدوات

  • Claude مع السكيل wp-performance متنزّلة
  • إضافة Claude in Chrome شغالة ومربوطة
  • WP-CLI على السيرفر (هوستنجر غالبًا مسطّباه)

📋 معلومات عن الموقع

  • الدومين والصفحات المهمة (الرئيسية، صفحة منتج/مقال، …)
  • هل الموقع Live عليه ترافيك ولا staging؟
  • أي plugin ممنوع يتلمس (دفع، فورمز، CRM)

🕐 توقيت

  • اشتغل في وقت ترافيك قليل
  • بلّغ صاحب الموقع قبلها
  • خلّي عندك ساعة إلى ساعتين للموقع الواحد

03الخطوات بالترتيب

كل خطوة مكتوب عليها مين اللي بيعملها: إنت ولا Claude.

نزّل السكيل وفعّلها إنت

ارفع فولدر السكيل (فيه SKILL.md و references/ و scripts/) في إعدادات الـ Skills عند Claude واتأكد إنها Enabled. Claude بيقرا الـ description بتاعتها ويعرف إمتى يستخدمها لوحده، بس الأضمن تقوله اسمها صريح في البرومبت.

افتح SSH على هوستنجر إنت

  • hPanel ← Websites ← Manage ← Advanced ← SSH Access
  • فعّل الـ SSH وانسخ: IP، Port (عادة 65002 في هوستنجر)، Username، والباسورد
  • مسار ووردبريس عادة: ~/domains/example.com/public_html
⚠️ أمانغيّر باسورد الـ SSH بعد ما تخلّص الشغل، أو استخدم SSH key وامسحه بعدها. ما تبعتش البيانات دي في جروبات.

اربط Claude in Chrome إنت

اتأكد إن الإضافة شغالة في Chrome. Claude هيستخدمها عشان يفتح PageSpeed Insights ويقيس، ويدخل hPanel أو لوحة ووردبريس لو احتاج.

ابعت البرومبت الافتتاحي إنت

انسخ البرومبت الجاهز من القسم اللي تحت واملا البيانات. أهم حاجة فيه: البيئة (Live ولا staging) والحاجات الممنوعة.

الباك اب — إلزامي Claude

قبل أي تعديل، Claude ياخد نسخة من الداتابيز والملفات على السيرفر، ويفضّل كمان نسخة من hPanel (Backups).

wp db export ~/backups/db-$(date +%F-%H%M).sql --path=<wp-root>
tar -czf ~/backups/files-$(date +%F-%H%M).tar.gz -C <wp-root> .
✔️ اتأكد بنفسكاطلب من Claude يعرضلك حجم ملفات الباك اب (ls -lh ~/backups). ملف داتابيز حجمه 0 = باك اب فاشل.

قياس الـ Baseline Claude

  • PageSpeed Insights لكل صفحة مهمة — Mobile و Desktop
  • قياس TTFB من السيرفر بـ curl (3 مرات على الأقل وناخد المتوسط)
  • يسجّل الأرقام في جدول: Performance, LCP, INP, CLS, FCP, TTFB
curl -o /dev/null -s -w "TTFB: %{time_starttransfer}s | Total: %{time_total}s\n" https://example.com/

من غير baseline مش هنقدر نثبت للعميل إن في تحسّن.

التشخيص Claude

بالترتيب ده بالظبط، ومفيش أي أمر هنا بيغيّر حاجة في الموقع:

  1. perf_inspect.mjs — تقرير سريع: نسخة ووردبريس، حجم الـ autoload، فيه object cache ولا لأ، page cache drop-in…
  2. wp doctor check — بيمسك الغلطات المشهورة (WP_DEBUG شغال، autoload تقيل، plugins كتير، تحديثات ناقصة)
  3. wp profile stage ← hook ← eval — يعرف الوقت بيروح فين بالظبط، وأنهي plugin أو hook هو السبب
📌 wp doctor و wp profileدول packages إضافية لـ WP-CLI. لو مش موجودين، Claude هيطلب إذنك يسطّبهم — ده تثبيت على مستوى السيرفر مش على الموقع، بس برضه محتاج موافقتك.

الإصلاح حسب الفئة Claude + موافقتك

Claude يختار المشكلة الأكبر الأول (مش يصلّح كله مرة واحدة)، يشرحلك هيعمل إيه، تستنى موافقتك، يطبّق، يقيس. التفاصيل في فئات الإصلاح.

إعادة القياس (Verify) Claude

  • نفس الصفحات، نفس الأجهزة (Mobile/Desktop)، نفس الأوامر
  • يتأكد إن الموقع شغال طبيعي: الفورمز، السلة، الدفع، تسجيل الدخول
  • يبص على debug.log / error log إن مفيش أخطاء PHP جديدة

المراجعة والتسليم إنت

  • اطلب من Claude تقرير: قبل/بعد + كل تغيير اتعمل + إزاي نرجّعه
  • افتح الموقع بنفسك من الموبايل ومن نافذة Incognito
  • غيّر باسورد SSH وامسح الباك ابات القديمة لو المساحة قليلة
  • املا Checklist التسليم

04البرومبت الجاهز

انسخه، غيّر اللي بين الأقواس، وابعته كأول رسالة. كل ما كان البرومبت أوضح في الممنوعات، كل ما الشغل كان آمن أكتر.

استخدم سكيل wp-performance عشان تحسّن سرعة الموقع ده.

الموقع: [https://example.com]
الاستضافة: Hostinger
SSH: host [IP] — port [65002] — user [u123456789] — password [****]
مسار ووردبريس: [~/domains/example.com/public_html]
البيئة: [Live عليه ترافيك / Staging]

الصفحات اللي هنقيسها:
1. [الرئيسية]
2. [صفحة منتج / مقال]
3. [صفحة تصنيف]

المسموح:
- تشغيل أوامر القراءة والتشخيص من غير ما تسألني.

لازم تستأذني قبل:
- أي تعديل في wp-config أو .htaccess أو الداتابيز
- تثبيت أو تعطيل أو حذف أي plugin
- مسح الكاش (cache flush)
- تشغيل SAVEQUERIES أو WP_DEBUG

ممنوع تمامًا:
- تلمس plugins دي: [WooCommerce Payments, Contact Form 7, …]
- تعمل load test

الترتيب:
1. خد باك اب كامل (داتابيز + ملفات) ووريني حجمه.
2. قيس baseline على PageSpeed Insights (Mobile + Desktop) لكل صفحة + TTFB بـ curl.
3. شغّل perf_inspect ثم wp doctor ثم wp profile.
4. قولي أكبر 3 مشاكل وخطة إصلاح كل واحدة، واستنى موافقتي.
5. بعد كل إصلاح قيس تاني.
6. في الآخر ادّيني تقرير: قبل/بعد، كل تغيير، وإزاي أرجّعه.

05فئات الإصلاح

بعد الـ profile، Claude بيحدد المشكلة الأساسية من دول. اعرف كل واحدة معناها إيه عشان تفهم التقرير وتسأل صح.

استعلامات الداتابيز

العَرَض: صفحة بتعمل مئات الـ queries، أو query واحدة بطيئة جدًا.

الإصلاح: تقليل عدد الـ queries، حل مشكلة N+1 (query جوه loop)، إضافة indexes، وتجنّب meta queries التقيلة. كمان تنضيف revisions و transients المنتهية و spam comments.

بتسأل Claude: «أنهي plugin بيعمل أكتر queries؟ وأبطأ query كانت إيه؟»

Autoloaded Options

العَرَض: ووردبريس بيحمّل كمية options كبيرة مع كل طلب، حتى لو مش محتاجها. غالبًا من plugins اتمسحت وسابت بواقيها.

الإصلاح: معرفة أكبر options، ووقف الـ autoload للكبيرة اللي مش محتاجة في كل صفحة. ده تعديل في الداتابيز → موافقتك الأول.

مؤشر: لو الحجم الكلي فوق حوالي 800KB–1MB يبقى في مشكلة تستاهل الشغل.

Object Cache

العَرَض: نفس البيانات بتتجاب من الداتابيز كل مرة.

الإصلاح: تفعيل كاش دائم (Redis أو Memcached) لو الاستضافة بتدعمه — هوستنجر فيها LiteSpeed Cache و Object Cache في بعض الخطط. ده بيتطلب plugin/drop-in → موافقتك.

ملاحظة: Page Cache (زي LiteSpeed Cache) حاجة، و Object Cache حاجة تانية. الاتنين مفيدين.

طلبات HTTP خارجية

العَرَض: plugin بيكلّم API بره (ترخيص، إحصائيات، سوشيال) مع كل تحميل صفحة، فالصفحة تستنى رده.

الإصلاح: timeouts قصيرة، تخزين النتيجة في transient، أو نقل الطلب لـ cron بدل ما يكون في وقت تحميل الصفحة.

WP-Cron

العَرَض: بطء مفاجئ ومتقطّع — غالبًا مهام مجدولة كتير اتأخرت واشتغلت مرة واحدة مع زيارة زائر.

الإصلاح: مسح الأحداث المتكررة المكررة، ونقل التشغيل لـ Cron حقيقي على السيرفر (من hPanel ← Cron Jobs) بدل ما يعتمد على الزوار.

💡 مهم تعرفهالسكيل دي مركّزة على الباك إند (TTFB وسرعة السيرفر). درجة PageSpeed الخضرا كمان بتعتمد على حاجات فرونت إند: ضغط وتحويل الصور لـ WebP/AVIF، lazy load، تأجيل الـ JS، الخطوط، وحجوزات أماكن الصور عشان CLS. Claude بيشتغل على دي كمان من خلال Chrome وإعدادات plugin الكاش — بس لازم تعرف إن الجزء ده برّه نطاق السكيل نفسها، فراجعه بعينك.

06إزاي تقرا نتيجة PageSpeed

الرقم الكبير (Performance) مش كل حاجة. جوجل في الترتيب بتبص على Core Web Vitals، وبالذات بيانات المستخدمين الحقيقيين.

المقياسبيقيس إيهكويسمحتاج تحسينوحش
LCPأكبر عنصر ظهر إمتى (صورة البانر غالبًا)≤ 2.5s≤ 4s> 4s
INPسرعة استجابة الصفحة للضغط والتفاعل≤ 200ms≤ 500ms> 500ms
CLSالعناصر بتتنطط وهي بتحمل≤ 0.1≤ 0.25> 0.25
FCPأول حاجة ظهرت على الشاشة≤ 1.8s≤ 3s> 3s
TTFBالسيرفر رد إمتى — ده اللي السكيل بتحسّنه مباشرة≤ 0.8s≤ 1.8s> 1.8s

🧪 Lab Data (التقييم تحت)

اختبار لحظي بيتغيّر من تجربة للتانية. شغّل 3 مرات وخد المتوسط. ده اللي بيتحسّن فورًا بعد الشغل.

👥 Field Data (فوق — Core Web Vitals Assessment)

بيانات زوار حقيقيين على آخر 28 يوم. ما بتتغيرش في نفس اليوم — استنى 3–4 أسابيع وبلّغ العميل بكده من الأول.

07الخطوط الحمرا

السكيل نفسها مبنية على «قيس الأول، وما تعملش حاجة خطر من غير إذن». دي القواعد اللي لازم تتمشي عليها، خصوصًا على موقع Live.

🚫 من غير موافقة صريحة — لأتثبيت plugins · تعديل wp-config · تشغيل SAVEQUERIES أو WP_DEBUG على Live · load test · مسح الكاش وقت الترافيك
🚫 أبدًاأي تعديل قبل ما الباك اب يتأكد · تحديث كل الـ plugins مرة واحدة · حذف plugins من غير ما تعرف بتعمل إيه
✅ دايمًامشكلة واحدة كل مرة ← قيس ← كمّل · نفس الصفحة ونفس الجهاز في القياس · سجّل كل تغيير وطريقة الرجوع فيه
⚠️ لو في شكوقّف واسأل. لو Claude قال «هعمل X» وإنت مش فاهم X إيه — اطلب منه يشرح قبل ما توافق.

08الأوامر اللي هتشوفها

مش مطلوب تكتبها بإيدك — Claude بيشغّلها. بس لازم تعرف كل واحد بيعمل إيه عشان تفهم اللي بيحصل.

# تقرير الفحص (قراءة فقط)
node scripts/perf_inspect.mjs --path=<wp-root> --url=https://example.com

# فحص صحة الموقع (قراءة فقط)
wp doctor check --all --path=<wp-root>

# الوقت بيروح فين؟ (قراءة فقط)
wp profile stage --path=<wp-root> --url=https://example.com
wp profile hook --all --spotlight --path=<wp-root>

# حجم الـ autoload وأكبر options (قراءة فقط)
wp db query "SELECT SUM(LENGTH(option_value)) FROM wp_options WHERE autoload IN ('yes','on','auto-on','auto')" --path=<wp-root>
wp db query "SELECT option_name, LENGTH(option_value) AS size FROM wp_options WHERE autoload IN ('yes','on','auto-on','auto') ORDER BY size DESC LIMIT 15" --path=<wp-root>

# الكرون (قراءة فقط)
wp cron event list --path=<wp-root>

# ⚠️ ده بيغيّر — محتاج موافقة
wp cache flush --path=<wp-root>

ملحوظة: بادئة الجداول مش دايمًا wp_ — Claude بيعرفها بـ wp config get table_prefix.

09مشاكل شائعة وحلها

 

Claude قال «wp: command not found»
WP-CLI مش في الـ PATH. في هوستنجر غالبًا موجود — جرّب تقوله يستخدم المسار الكامل أو يتأكد إنه داخل فولدر الموقع. السكريبت نفسه مش هيقع، هيطلّع تقرير فيه wpCli.available: false.
عملنا إصلاحات والرقم ما اتغيرش
غالبًا واحد من دول: بتقيس صفحة مختلفة، الكاش مخبّي النتيجة (جرّب مع ?nocache=1 أو من Incognito)، أو OPcache لسه قديم. وافتكر إن PageSpeed بيتذبذب — خد متوسط 3 تجارب.
Desktop أخضر والموبايل لأ
طبيعي — اختبار الموبايل بيحاكي جهاز ضعيف ونت بطيء. غالبًا المشكلة في الصور الكبيرة أو JavaScript كتير، مش في السيرفر. ركّز على LCP ووزن الصفحة.
الموقع وقع أو طلع خطأ بعد تعديل
وقّف فورًا. اطلب من Claude يرجّع آخر تغيير بالظبط (عشان كده بنسجّل كل تغيير). لو الموضوع كبير: ارجع للباك اب — wp db import للداتابيز أو من hPanel ← Backups.
الـ Core Web Vitals Assessment لسه Failed
ده Field Data من زوار حقيقيين على 28 يوم. هيتحسّن بالتدريج. تابع من Search Console ← Core Web Vitals بعد 3–4 أسابيع.
Claude عايز يسطّب plugin
اسأله: إيه هو؟ ليه ده بالذات؟ هيأثر على إيه؟ في بديل موجود فعلًا (زي LiteSpeed Cache اللي غالبًا متسطّب على هوستنجر)؟ ووافق بعدها.

10Checklist التسليم

علّم عليها وإنت شغال. (بتتمسح لما تقفل الصفحة — لو عايز تحتفظ بيها اطبع الصفحة PDF.)

تم 0 من 0