حين يبطؤ تطبيق ويب، يسهل أن تعدّل الكود قبل أن تعرف أين يضيع الوقت. لذلك أرفقتُ ستة أوامر مخصّصة (slash commands) لـ Claude Code، كل منها ملف Markdown يقود Claude في جانب واحد من الأداء.
الحزمة مهيّأة لـ Claude Code وحده، وليس فيها نسخة لـ Codex. وفي claude.ai تستطيع لصق نص أمر في المحادثة، لكن Claude لن يرى ملفات مشروعك، وأنسبها لذلك system-behavior-simulator لأنه يعمل من وصفك للنظام.
ماذا يفعل كل أمر
- performance-audit: أقصر الملفات وأنسبها للبدء. يبحث عن الحلقات المتداخلة ذات التعقيد التربيعي، واستعلامات N+1 والفهارس الناقصة، والطلبات الزائدة، وتسرّب الذاكرة، ثم يرتّب توصياته حسب الأثر والجهد.
- optimize-build: يتعرّف على أداة البناء، من Webpack وVite إلى Gradle وCargo، ويقيس زمن البناء النظيف والتزايدي قبل أي تعديل، ثم يقترح التخزين المؤقت في CI والمعالجة المتوازية وإعدادات لـ Webpack وVite وTypeScript.
- optimize-bundle-size: يحلّل الحزمة بـ webpack-bundle-analyzer، ويقسّم الكود حسب المسار، ويزيل غير المستخدم (tree shaking)، ويضيف سير عمل GitHub Actions يُفشل فحص طلب الدمج إذا تجاوز main.js أو vendor.js حدًا يحدده السكربت.
- implement-caching-strategy: يوزّع التخزين المؤقت على المتصفح وCDN والتطبيق وقاعدة البيانات: ترويسات Cache-Control لخادم Express، وService Worker، وnode-cache، وتخزين نتائج استعلامات PostgreSQL في Redis، واختبار يقارن زمن الطلب الأول بالثاني.
- setup-cdn-optimization: يقارن Cloudflare وAWS CloudFront وFastly وKeyCDN، ويعرض قالب CloudFormation يفصل طلبات api عن ملفات static، مع ضغط Brotli، وتوليد أربعة مقاسات لكل صورة بصيغتي WebP وJPEG عبر sharp، وإبطال الملفات المخزّنة.
- system-behavior-simulator: يبني تقديراته من وصفك ولا يشغّل اختبار حمل حقيقيًا، وملفه يأذن مسبقًا بالقراءة والكتابة فقط. وإن كان وصفك ناقصًا سألك عن بنية النظام وأهداف زمن الاستجابة (p95 وp99) وأنماط الحمل، ثم يحدّد الاختناقات المتوقعة ويضع خطة للسعة.
مثال من ملف المحاكاة: متجر في موسم التخفيضات
من أمثلة الملف طلبُ محاكاة متجر إلكتروني تحت حركة «الجمعة السوداء» بعشرة أضعاف الحمل المعتاد. وبحسب قالبه، يعيد Claude تقريرًا فيه جدول لثلاثة سيناريوهات (حمل عادي، وذروة، واختبار إجهاد) بالإنتاجية وزمن p95 ونسبة الأخطاء واستهلاك المعالج، ثم تحليل للاختناق الأساسي، وتوصيات لثلاثين يومًا ولستة أشهر وما بعدها. أرقام التقرير تقديرات من وصفك، لا قياس لنظامك.
تحميلها في Claude Code
- فك الضغط في مجلد ثابت، وشغّل claude بخيار plugin-dir موجّهًا إلى مجلد plugin، كما في الدليل العربي. التحميل للجلسة الحالية، والأوامر مسبوقة باسم الإضافة:
/commands-performance-optimization:performance-audit. - لتبقى في كل جلسة، انسخ الملفات الستة من plugin/commands إلى .claude/commands في مشروعك، واستدعها بأسمائها القصيرة مثل
/optimize-build.
قبل أن تعتمد على نتائجها
- يأذن ملف optimize-bundle-size لـ Claude بتشغيل أوامر npm دون استئذانك في كل مرة، فراجع ما يثبّته. ويفحص سكربت الحجم فيه ملفّي main.js وvendor.js بالاسم، بينما يسمّي إعداد Webpack في الملف نفسه حزمة المكتبات vendors، فطابق الأسماء.
- بعض الأمثلة لإصدارات أقدم، مثل Node 16 في سير عمل GitHub Actions، واسم الحزمة القديم react-query، فاطلب تحديثها.
- مثال مسح ذاكرة الاستعلامات يبحث عن اسم الجدول في مفاتيح مرمّزة بـ base64 لا يظهر فيها، فاطلب إصلاحه.
- أمثلة ملف المحاكاة تستخدم البادئة performance، فضع مكانها اسم الإضافة.
الأوامر من عمل مجتمع BuildWithClaude، نشرها davepoon بترخيص MIT، وتصلك بالإنجليزية دون تعديل، مع دليل عربي أعددتُه وفهرس بمسار كل ملف.
