Claude Code قوي بشكل افتراضي، لكن بدون هيكلة، ينتقل مباشرة إلى البرمجة: بدون تخطيط، بدون اختبارات، بدون نهج منهجي. إضافة Superpowers تحل هذه المشكلة من خلال فرض سير عمل تطوير مثبت يمنع الفوضى.
ما تفعله Superpowers فعلياً
Superpowers هو إطار مهارات يعترض Claude Code في اللحظات الرئيسية. بدلاً من كتابة الكود فوراً عندما تطلب شيئاً، يتوقف ويطرح الأسئلة أولاً. ثم يفرض TDD، وينشئ خطط تنفيذ، ويراجع عمله قبل المتابعة.
سير العمل الأساسي:
- العصف الذهني: يحسّن فكرتك من خلال الأسئلة السقراطية
- التخطيط: ينشئ مهام صغيرة (2-5 دقائق لكل منها) مع مسارات الملفات الدقيقة
- التنفيذ: يرسل وكلاء فرعيين لكل مهمة مع مراجعة من مرحلتين
- الإنهاء: يتحقق من الاختبارات، ويقدم خيارات PR/الدمج، وينظف
التثبيت (10 ثوانٍ)
bash
افتح قائمة الإضافات
/plugin
انتقل إلى تبويب "Discover"
ابحث عن "superpowers"
اختر وثبّت
بعد التثبيت، أعد تشغيل Claude Code. سترى "SessionStart:startup hook succeeded: Success" لتأكيد أن الإضافة نشطة.
ما يتم تثبيته
الإضافة تحزم كل ما تحتاجه:
| المكون | مضمّن |
|---|---|
| الأوامر | execute-plan، write-plan، brainstorm |
| الوكلاء | code-reviewer |
| المهارات | 14 مهارة بما في ذلك TDD، التصحيح، git worktrees، مراجعة الكود |
| الخطافات | SessionStart (يبدأ سير العمل تلقائياً) |
الأوامر الأساسية الثلاثة
/superpowers:brainstorm
استخدم هذا قبل أي ميزة جديدة. سيقوم Claude بـ:
- طرح أسئلة توضيحية حول هدفك
- استكشاف البدائل التي لم تفكر فيها
- عرض التصميم في أجزاء سهلة الفهم للتحقق
- حفظ وثيقة تصميم للرجوع إليها
متى يتم التفعيل: بداية أي ميزة، إعادة هيكلة، أو ترحيل.
/superpowers:write-plan
بعد العصف الذهني، ينشئ هذا خطة تنفيذ حيث:
- كل مهمة تستغرق 2-5 دقائق كحد أقصى
- كل مهمة لها مسارات ملفات دقيقة ومقتطفات كود كاملة
- خطوات التحقق مدمجة في كل مهمة
- الخطة تفترض أن "مهندساً مبتدئاً متحمساً بدون سياق" سينفذها
/superpowers:execute-plan
ينفذ الخطة باستخدام التطوير المدفوع بالوكلاء الفرعيين:
- وكيل فرعي جديد لكل مهمة (سياق نظيف)
- مراجعة من مرحلتين: الامتثال للمواصفات، ثم جودة الكود
- نقاط تفتيش بشرية بين الدفعات
- المشاكل الحرجة تمنع التقدم تلقائياً
شرح المهارات الـ 14
| المهارة | ما تفعله |
|---|---|
| test-driven-development | يفرض RED-GREEN-REFACTOR. يحذف الكود المكتوب قبل الاختبارات. |
| systematic-debugging | عملية سبب جذري من 4 مراحل مع دفاع متعمق |
| using-git-worktrees | ينشئ فرعاً معزولاً، يشغّل الإعداد، يتحقق من خط أساس نظيف |
| using-superpowers | مقدمة لنظام المهارات |
| dispatching-parallel-agents | سير عمل وكلاء فرعيين متزامنين |
| executing-plans | تنفيذ دفعات مع نقاط تفتيش |
| finishing-a-development-branch | خيارات الدمج/PR/الاحتفاظ/التجاهل، التنظيف |
| brainstorming | تحسين التصميم السقراطي |
| writing-plans | تخطيط تنفيذ مفصل |
| requesting-code-review | قائمة تحقق ما قبل المراجعة، يمنع عند المشاكل الحرجة |
| receiving-code-review | الرد على الملاحظات بشكل منهجي |
| writing-skills | مهارة وصفية لإنشاء مهارات جديدة |
| verification-before-completion | يضمن أن الإصلاحات تعمل فعلاً |
| subagent-driven-development | مراجعة من مرحلتين لكل مهمة |
كيف تُفعّل المهارات تلقائياً
المهارات ليست أوامر تستدعيها، بل تُفعّل بناءً على السياق:
- البدء في مناقشة ميزة جديدة ← تُفعّل brainstorming
- الموافقة على التصميم ← تُفعّل using-git-worktrees
- بدء التنفيذ ← تُفعّل test-driven-development
- إكمال المهمة ← تُفعّل requesting-code-review
- إنجاز جميع المهام ← تُفعّل finishing-a-development-branch
يتحقق Claude من المهارات ذات الصلة قبل أي مهمة. هذه سير عمل إلزامية، وليست اقتراحات.
تكامل Git worktree
تستخدم Superpowers git worktrees للتطوير المعزول: bash
ما يحدث خلف الكواليس:
git worktree add ../project-feature feature-branch cd ../project-feature
يعمل Claude هنا، يبقى الفرع الرئيسي نظيفاً
الفوائد:
- تشغيل عدة نسخ من Claude على ميزات مختلفة
- الحفاظ على استقرار الفرع الرئيسي أثناء التجريب
- تنظيف سهل إذا حدث خطأ
التطوير المدفوع بالوكلاء الفرعيين
النمط الأقوى. بدلاً من جلسة Claude واحدة طويلة:
- الوكيل الرئيسي ينشئ الخطة
- وكيل فرعي جديد ينفذ كل مهمة
- وكيل المراجعة (code-reviewer) يفحص العمل
- الوكيل الرئيسي يتابع أو يطلب إصلاحات
لماذا يعمل هذا: كل وكيل فرعي يبدأ بسياق نظيف يركز على مهمة واحدة. لا ارتباك متراكم من جلسات طويلة.
فرض TDD
تأخذ Superpowers TDD على محمل الجد. المهارة:
- تتطلب اختبار فاشل قبل التنفيذ
- تراقب فشل الاختبار (يثبت أنه يختبر شيئاً)
- تنفذ الحد الأدنى من الكود للنجاح
- تلتزم عند النجاح
- تعيد الهيكلة فقط بعد النجاح
إذا كتب Claude كوداً قبل الاختبارات، تأمره المهارة بحذف ذلك الكود والبدء من جديد.
مثال عملي
أنت: أحتاج مصادقة مستخدم لتطبيق Express الخاص بي
Claude (مع Superpowers): → يُفعّل مهارة العصف الذهني → يسأل: OAuth أم كلمات مرور؟ جلسة أم JWT؟ ما المزودون؟ → يستكشف: تحديد المعدل؟ قفل الحساب؟ متطلبات كلمة المرور؟ → يعرض التصميم في أقسام لموافقتك
أنت: يبدو جيداً، لنخطط له
Claude: → يُفعّل مهارة writing-plans → ينشئ 12 مهمة، كل منها 2-5 دقائق → المهمة 1: إنشاء اختبار فاشل لنقطة نهاية /signup → المهمة 2: تنفيذ معالج signup لتمرير الاختبار → كل مهمة لها مسارات ملفات دقيقة وكود
أنت: نفّذ
Claude: → ينشئ وكيلاً فرعياً للمهمة 1 → وكيل code-reviewer يتحقق من المخرجات → ينشئ وكيلاً فرعياً للمهمة 2 → يبلغ عن التقدم، يطلب الموافقة للمتابعة
إدارة الإضافة
من قائمة /plugin يمكنك:
- تعطيل الإضافة: إيقاف مؤقت
- وضع علامة للتحديث: وضع علامة لدورة التحديث التالية
- التحديث الآن: الحصول على أحدث إصدار فوراً
- إلغاء التثبيت: الإزالة الكاملة
- عرض على GitHub: رؤية الكود المصدري
متى لا تستخدم Superpowers
- أسئلة سريعة لمرة واحدة
- تعديلات ملفات بسيطة
- مهام أقل من 5 دقائق
لهذه الحالات، العبء الإضافي لا يستحق. تتألق Superpowers في الميزات متعددة الملفات، وإعادة الهيكلة، والترحيلات التي تتطلب تنفيذاً منهجياً.
مرجع سريع
| الإجراء | كيف |
|---|---|
| التثبيت | /plugin ← Discover ← superpowers |
| بدء التصميم | /superpowers:brainstorm |
| إنشاء خطة | /superpowers:write-plan |
| تنفيذ خطة | /superpowers:execute-plan |
| التحديث | /plugin ← اختر superpowers ← Update now |
تحوّل Superpowers Claude Code من "مساعد مفيد يخرج أحياناً عن المسار" إلى "شريك تطوير منهجي يتبع عمليات مثبتة". سير العمل المنظم يمنع أكثر أنماط الفشل شيوعاً: الاختبارات المتخطاة، والحالات الحدية المفقودة، والميزات التي تنحرف عن المتطلبات.
