Superpowers مع Claude Code: التثبيت والمهارات ومتى تحتاجها

ما هي Superpowers، وماذا تضيف إلى Claude؟

Superpowers مكتبة مهارات هندسية أنشأها Jesse Vincent، وترافقها تعليمات تحث وكيل البرمجة على استخدامها. داخل Claude Code من Anthropic، وهو مساعد البرمجة الذي يعمل على مستودع مشروعك، توفر المكتبة مسارات عمل لفهم الطلب، وتخطيط التعديلات، والاختبار، وتشخيص الأخطاء، وتفويض المهام، وإنهاء العمل على الفرع. تخيّلها دليل تشغيل لورشة: الأدوات موجودة بالفعل، والدليل يحدد ترتيب العمل والفحوص المطلوبة قبل التسليم. ملف README الخاص بـ Superpowers

جرى التحقق في 18 أكتوبر 2026: يحدد ملف تعريف الإضافة الإصدار 7.0.0، ويضم المستودع 15 مجلدًا للمهارات في المستوى الأعلى، يحتوي كل منها على ملف SKILL.md. هذه هي حالة المصدر الذي فُحص لهذا المقال؛ تحقّق من المراجعة التي يثبتها متجر الإضافات الذي تختاره. ملف تعريف الإضافة، مجلد المهارات

تكمن فائدتها العملية في جعل سلسلة القرارات ظاهرة أمامك. فقبل تعديل ميزة، يستطيع Claude تحديد سلوكها المطلوب. وقبل إعلان اكتمالها، يستطيع اشتراط نتيجة اختبار حديثة. تمنحك هذه التعليمات أشياء ملموسة تفحصها، لكنها لا تثبت صحة المتطلبات أو الاختبارات نفسها.

كيف تثبّت Superpowers في Claude؟

استخدم أحد مساري التثبيت الواردين في ملف README للمشروع، من داخل Claude Code. الأوامر التالية منقولة كما هي من القسم الخاص بـ Claude Code؛ وهي أوامر تفاعلية تبدأ بشرطة مائلة، وليست أوامر تُلصق في سطر أوامر النظام المعتاد. تعليمات التثبيت في README

تثبيت إضافة Claude Superpowers من المتجر الرسمي

/plugin install superpowers@claude-plugins-official

يوثّق المطوّر أيضًا متجره الخاص. إذا اخترت هذا المسار، فأضف المتجر أولًا ثم ثبّت الإضافة:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

اختر مصدرًا تستطيع متابعة ما يثبّته. لا فائدة من تنفيذ المسارين معًا لإعداد الإضافة نفسها.

بعد التثبيت، ابدأ جلسة جديدة في Claude Code لتشغيل آلية بدء الجلسة. اطلب ميزة محددة النطاق، مثل إضافة مرشّح إلى قائمة مهام موجودة. وما ينبغي ملاحظته هو ما إذا كان يعلن استخدام مهارة مناسبة ويلتزم بسلوكها. نجاح أمر التثبيت شيء، وعمل المسار كما هو متوقع شيء آخر.

ما الذي يتغيّر في الجلسة بعد التثبيت؟

أول ما يتغيّر هو السياق: تُدرج آلية بدء الجلسة تعليمات استخدام Superpowers في المحادثة. يشمل إعداد المطابقة الخاص بـ SessionStart الحالات startup وclear وcompact. يقرأ السكربت تعليمات using-superpowers، ويُدرج نصها، ويوجّه Claude إلى تحميل المهارات الأخرى عبر أداة Skill. ولا ينسخ المحتوى الكامل لكل المهارات في رسالة البداية. إعداد آلية بدء الجلسة، سكربت بدء الجلسة

كيف يختار Claude مهارة من Superpowers؟

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

لذلك، يشير طلب بناء شيء إلى brainstorming، بينما يشير اختبار فاشل إلى systematic-debugging. ويمكن بعد ذلك لمهارة متخصصة في المجال أن توجّه التنفيذ. وتستطيع أيضًا طلب مهارة بالاسم، مثل: «استخدم superpowers:systematic-debugging للتحقيق في هذا الإخفاق قبل اقتراح إصلاح». تعليمات الاستخدام

الاختيار التلقائي تعليمة للنموذج، وليس مفتاحًا حتميًا تشغّله كلمة بعينها. توفر آلية بدء الجلسة نص التهيئة، لكن يظل على الوكيل إدراك الموقف واتباع التعليمات التي اختارها. إذا اختار مسارًا غير مناسب، فصحّح نطاق المهمة أو اطلب المهارة المطلوبة مباشرة.

مهارات Superpowers: متى تُستخدم، وماذا تضيف؟

تغطي المكتبة دورة التطوير كاملة، لكن ينبغي أن تحمّل الجلسة المهارات المناسبة للعمل الجاري. الأسماء التالية مطابقة لما ورد في الملفات التي فُحصت. ويلخّص عمود الاستخدام أوصاف المهارات وتعليماتها؛ ولا يعني أن جملة بعينها ستستدعي دائمًا مهارة بعينها. مجلد المهارات الحالي

لست بحاجة إلى حفظ القائمة. في تطوير الميزات المعتاد، راقب الانتقال بين المراحل: فهم الطلب، ثم خطة محددة عند الحاجة، ثم تنفيذ اختُبر، ثم تعديل روجع، ثم قرار الدمج. أما عند معالجة عطل، فالبداية المفيدة هي التحقيق فيه، لا فتح نقاش لتصميم ميزة جديدة.

كيف تعمل إلى جانب وضع التخطيط المدمج ومهاراتك الخاصة؟

تفرض Superpowers مسار عمل حول التخطيط، لكن مهارة writing-plans فيها منفصلة عن وضع التخطيط المدمج في Claude Code. تنص تعليمات التهيئة الحالية صراحة على استدعاء brainstorming قبل الدخول إلى وضع التخطيط إذا لم يكن العصف الذهني قد جرى بالفعل. وهي بذلك تحدد ترتيب الخطوات، بدل التعامل مع الوضع المدمج ومهارة كتابة الخطة وكأنهما بديلان متكافئان. تعليمات التخطيط الحالية

تنتج writing-plans وثيقة داخل المستودع، عادة في docs/superpowers/plans/، تتضمن قرارات التنفيذ والفحوص. وعند التسليم، تطلب من المستخدم مراجعة الخطة واختيار طريقة التنفيذ، ما لم يكن قد حددها مسبقًا. مجرد اختيار وضع التخطيط لا ينشئ هذه الوثيقة ولا يوفر تعليمات المهام تلك. وللتعرّف إلى عناصر التحكم وسلوك البيئة المضيفة، راجع دليل وضع التخطيط في Claude Code.

وتظل مهاراتك الخاصة جزءًا من منظومة العمل. يحدد ملف writing-skills في الإضافة المسار ~/.claude/skills/ بوصفه مجلد المهارات الشخصية في Claude Code، وتضع تعليمات التهيئة صراحة تعليمات المستخدم، ومنها CLAUDE.md والطلبات المباشرة، فوق تعليمات المهارات. لذلك يمكن لمهارة خاصة بالمشروع أن تحمل قواعدك، بينما توفر Superpowers منهج التطوير. حدّد هذا التقسيم بوضوح إذا كان كلاهما يفرض طريقة للاختبار أو المراجعة. ملف تأليف المهارات، أولوية التعليمات

ولفهم فكرة ملفات التعليمات التي تقوم عليها هذه الآلية، راجع مهارات الوكلاء. Superpowers إحدى المجموعات المبنية بهذه الآلية، ولها تصور محدد لطريقة العمل.

Superpowers في Claude Code: ميزة واحدة من الفكرة إلى الدمج

يكفي مفتاح «إخفاء المهام المكتملة» لعرض مسار العمل كاملًا. المثال التالي توضيحي ومبني على ملفات المهارات، وليس تسجيلًا لجلسة اختبار فعلية. أسماء الملفات وحالات القبول والنتيجة كلها افتراضية.

لنفترض أن تطبيقًا قائمًا لقوائم المهام لديه اختبارات بالفعل. يطلب المستخدم مفتاحًا يخفي العناصر المكتملة دون حذفها. وفي هذا المثال، يطلب المستخدم صراحة خطة مكتوبة ومراجعات للمهام يجريها وكلاء فرعيون. لولا هذا الطلب، لكان تعديل بهذا الحجم مرشحًا للمسار الأقصر الذي تكفيه المحادثة.

تحديد السلوك المطلوب: brainstorming

السؤال الحاسم هو: هل يؤثر «الإخفاء» في العرض الحالي فقط، أم يغيّر المهام المخزّنة؟ في هذا المثال، السلوك المتفق عليه هو ترشيح العرض وحده: يكون المفتاح معطّلًا في البداية، وتظهر العناصر المكتملة مجددًا عند تعطيله، وتوضح رسالة القائمة الفارغة بعد الترشيح أنه لا توجد مهام نشطة.

يعيد Claude عرض هذا النطاق للتأكد منه ويحصل على الموافقة. ولأن المستخدم اختار المسار المكتوب، يُسجَّل التصميم في وثيقة ضمن docs/superpowers/specs/، مع فحص من المنفّذ قبل التسليم. أما المسار المعتاد للتعديلات الصغيرة في هذه المهارة، فيسمح ببقاء الوصف والاتفاق داخل المحادثة. قواعد العصف الذهني

ما ينبغي أن تفحصه هنا هو الاتفاق على السلوك. فإذا أضاف حفظ التفضيلات أو غيّر تخزين المهام دون تنبيه، يكون نطاق الميزة قد اتسع قبل بدء أي تنفيذ.

تحويل العمل إلى نتائج قابلة للتحقق: writing-plans

تقسم الخطة الميزة إلى نتائج يمكن التحقق من كل منها على حدة. إحداها تنفيذ دالة ترشيح في ملف افتراضي هو src/tasks/filterTasks.ts، مع اختبارات لقوائم مختلطة وفارغة ومكتملة بالكامل. والأخرى توصيل مفتاح يراعي متطلبات إمكانية الوصول في src/tasks/TaskList.tsx، باستخدام واجهة الدالة المتفق عليها واختبار النتيجة الظاهرة.

تحدد الخطة الملفات والواجهات وما يجب أن تثبته الاختبارات، وأوامر اختبار المشروع والنتائج المتوقعة. وتوثّق أيضًا أن الترشيح يجب أن يترك مجموعة المهام الأصلية سليمة. يراجع المستخدم الخطة ويؤكد اختيار مسار الوكلاء الفرعيين. هنا يتحول التوجيه العام إلى تفاصيل يستطيع المنفّذ والمراجع مناقشتها والاختلاف عليها بدقة. تعليمات كتابة الخطط

تجهيز بيئة العمل: using-git-worktrees

عند الإعداد للتنفيذ، يتحقق Claude مما إذا كان العمل معزولًا بالفعل. وGit worktree هو مجلد عمل إضافي للمستودع، عادة على فرع مستقل. تفضّل المهارة آلية worktree المدمجة في البيئة المضيفة، وتحترم تفضيل المستخدم إن كان محددًا؛ وإلا فتطلب الإذن قبل إنشاء واحدة.

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

تنفيذ المهام: subagent-driven-development وtest-driven-development

يسند الوكيل المنسّق مهمة الترشيح إلى وكيل تنفيذ جديد، ثم يرتب مراجعتها. وبعد اجتياز هذه النقطة، ينتقل إلى مهمة واجهة المستخدم. تتحقق مهارة الوكلاء الفرعيين الحالية من مطابقة المواصفات وجودة الشيفرة أثناء مراجعة المهمة، ثم تشترط مراجعة أشمل للفرع المكتمل. وتدوّن أيضًا التقدم والقرارات في سجل خاص بالخطة. مسار عمل الوكلاء الفرعيين

أثناء التنفيذ، توفر test-driven-development دورة الفشل ثم النجاح ثم إعادة الهيكلة. هنا يثبت الاختبار أولًا أن طلب العرض المرشّح ما زال يعيد مهمة مكتملة. ولا يضيف المنفّذ سلوك الترشيح إلا بعد ملاحظة هذا الفشل، ثم يعيد تشغيل الاختبار وينقّح الشيفرة مع إبقاء الاختبارات ناجحة. تعليمات التطوير الموجّه بالاختبارات

وفي مهمة واجهة المستخدم، ينبغي أن يتحقق الاختبار مما يراه المستخدم بعد تشغيل المفتاح. أما اختبار يكتفي بالتأكد من استدعاء دالة، فلا يثبت السلوك الظاهر للميزة.

البديل هو executing-plans: ينفذ Claude الخطة بنفسه داخل الجلسة الحالية، مع مراجع جديد للفرع كاملًا في النهاية عندما يتاح وكلاء فرعيون. اختر هذا المسار عندما لا تحتاج إلى ترتيب مراجعة يتضمن تسليم كل مهمة على حدة. تعليمات التنفيذ في الجلسة الحالية

معالجة الملاحظات: مهارات المراجعة وsystematic-debugging

في المراجعة النهائية للفرع، توفر requesting-code-review تعليمات تسليم العمل إلى المراجع. لنفترض أنه اكتشف أن تعطيل المفتاح لا يعيد المهام المكتملة. عندها تقتضي receiving-code-review التحقق من هذه الملاحظة بمقارنتها بالشيفرة والسلوك المطلوب قبل إجراء أي تعديل. طلب المراجعة، التعامل مع ملاحظات المراجعة

إذا أمكن إعادة إنتاج الخلل، توجّه systematic-debugging عملية التحقيق. تمر مراحلها بالبحث عن السبب الجذري، وتحليل الأنماط، واختبار الفرضيات، ثم التنفيذ. في مثالنا، قد تكون الفرضية أن الشيفرة استبدلت المجموعة الأصلية بالمجموعة المرشّحة. افحص تدفق البيانات، وأعِد إنتاج فقدان المهام، ثم أصلح السبب مع اختبار يمنع عودة الخلل. لا تكتفِ بإجبار مظهر المفتاح على الظهور بالحالة الصحيحة. تعليمات تشخيص الأخطاء

إثبات اكتمال العمل واختيار طريقة الدمج

تشترط verification-before-completion مخرجات حديثة للأوامر قبل إعلان النجاح. وفي هذه الميزة، يعني ذلك تقديم أدلة على سلوك الترشيح، والتفاعل مع المفتاح، وفحوص المشروع ذات الصلة، مع التصريح بوضوح بأي إخفاقات لم تُحل. تعليمات التحقق

بعد ذلك، تتحقق finishing-a-development-branch من نجاح مجموعة الاختبارات كاملة، وتعرض خيارات دمج العمل. على فرع عادي ذي اسم، يطرح الملف الحالي الدمج محليًا، أو رفع الفرع وإنشاء طلب سحب، أو الاحتفاظ بالفرع. وينتظر قرار المستخدم؛ فاجتياز المراجعة لا يمنح إذنًا ضمنيًا بالدمج.

ولإكمال المثال، يختار المستخدم الدمج محليًا في الفرع الأساسي الذي جرى تأكيده. ينفذ Claude الدمج، ويختبر نتيجته، ثم يزيل worktree وفرع الميزة بعد نجاح النتيجة فقط. أما إنشاء طلب سحب، فيترك العمل بانتظار إجراءات الدمج المعتمدة في المستودع. تعليمات إنهاء العمل

متى تحتاج المهمة الصغيرة إلى إجراءات أقل؟

تصبح الإجراءات عبئًا عندما تكرر طلب قرارات حسمها الطلب أصلًا. فتغيير تسمية ظاهرة إلى نص بديل محدد لا ينبغي أن يحتاج إلى التحضير نفسه الذي يتطلبه تعديل طريقة تخزين حالة المهام. هذا تقييم لما يضيفه مسار العمل من خطوات، وليس ادعاءً قائمًا على قياس الوقت المستغرق.

يميّز ملف brainstorming الحالي بين ثلاثة أحجام للعمل:

• مهمة سريعة وواضحة: يحتوي الطلب نفسه على الوصف اللازم؛ نفّذها.
• تعديل صغير: اتفق على الوصف في المحادثة، ثم نفّذ عبر مسار العمل المعتاد.
• مشروع: احصل على الموافقة على تصميم مكتوب، ثم أعدّ خطة كاملة لتنفيذ البرمجيات.

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

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

والقيد هنا هو عبء الإجراءات: فقد تصبح المحادثات الإضافية، ووثائق التخطيط، وتفويض المهام، والمراجعات أكبر مما يستدعيه ما تبقّى من أسئلة غير محسومة. يوثّق المصدر هذه الخطوات، لكنه لا يحدد عدد الدقائق التي سيستغرقها تعديلك. وإذا تجاهلت الجلسة نطاقها مرارًا، يوفر المستودع diagnosing-superpowers لفحص ما حدث استنادًا إلى أدلة من سجل المحادثة. مهارة تشخيص الجلسات

أين تكمن المبالغة في الحديث عن Superpowers؟

وجود مسار عمل محدد لا يثبت صحة البرمجيات ولا تحسن سرعة إنجازها. فقد يجسّد الاختبار الفاشل متطلبًا خاطئًا، وقد تغفل الخطة قيدًا يتعلق بالتكامل، وقد يفوّت الوكيل المراجع عيبًا. قيّم ما تثبته الاختبارات وفروق الشيفرة، لا نبرة الثقة في رسالة اكتمال العمل.

كذلك، لا يعني العمل بوكلاء فرعيين أن كل مهام التنفيذ تجري في الوقت نفسه. تمنع المهارة الحالية صراحة تشغيل وكلاء التنفيذ الفرعيين بالتوازي ضمن هذا المسار، تجنبًا للتعارضات. أما dispatching-parallel-agents فهي مهارة منفصلة للمشكلات المستقلة. قواعد إسناد مهام التنفيذ

ولا يعفيك التثبيت من مسؤولية تحديد نطاق المهمة أو دمج العمل. فإجراء الإنهاء في الإضافة نفسها يبقي قرار الدمج بيد المستخدم. وأقوى ما تعد به هو ضبط الإجراءات: فهي تخبر Claude بما عليه فحصه والأدلة التي ينبغي عرضها. أما جدوى ذلك، فتعتمد على طبيعة العمل ومدى التزام الوكيل بالتعليمات.

لمن تناسب هذه الإضافة، وكيف تبدأ تجربتها؟

ثبّتها إذا كانت مشكلتك المتكررة هي تجاوز قرارات هندسية ضرورية. إذا كنت تطوّر بمفردك وكان وكيلك يتعجل ويتخطى المتطلبات، فابدأ بميزة محددة النطاق لها حالة إخفاق ذات معنى. افحص ما إذا كانت الجلسة تحدد السلوك قبل التنفيذ وتقدم أدلة بعده.

أما فريق التطوير القائم، فعليه أولًا مواءمة قواعده الخاصة بالتخطيط والاختبار والمراجعة مع تعليمات الإضافة. إذا كانت مهاراتكم الحالية تتضمن المنهج المطلوب بالفعل، فقد يكرره مسار عام إضافي. وإذا كان معظم العمل تعديلات صغيرة جدًا ومحددة بالكامل، فتقل الحاجة إلى تبنّي المنهج كاملًا لمجرد إنجازها.

يوم الاثنين، اختر تعديلًا محدودًا ودوّن معايير قبوله. استخدم Superpowers، وافحص المهارات المختارة، وراجع فروق الشيفرة النهائية، وحدد ما إذا كان كل مخرج إضافي قد ساعدك على اتخاذ قرار. احتفظ بمسار العمل لأن فحوصه أفادتك، لا لأنه أنتج خطة طويلة.

وللتعرّف إلى أدوات قريبة تعالج مشكلات أخرى، راجع أفضل إضافات Claude Code.

أسئلة شائعة عن Claude Superpowers

للحصول على إرشادات عملية للبناء بالذكاء الاصطناعي، اشترك في النشرة البريدية.