Superpowers لـ Claude Code: التثبيت والمهارات وسير العمل
ما تضيفه إضافة Superpowers إلى Claude Code، وأوامر التثبيت الحرفية من المستودع، والمهارات الخمس عشرة في الإصدار v7.0.2، وكيف يختلف سير عملها عن Claude Code وحده.
الخلاصة
- Superpowers إضافة مفتوحة المصدر تضم 15 مهارة قابلة للتركيب — العصف الذهني، الخطط، TDD، تصحيح الأخطاء، worktrees، مراجعة الكود — ويحمّلها Claude Code تلقائيًا بعد التثبيت.
- من السوق الرسمي: /plugin install superpowers@claude-plugins-official. أو أضف obra/superpowers-marketplace ثم ثبّت superpowers@superpowers-marketplace.
- مقال المؤلف يذكر Claude Code 2.0.13 أو ما يقاربه كحد أدنى، وملف تعريف الإضافة في المستودع هو v7.0.2 صادر في 2026-11-03.
- التسلسل: عصف ذهني ← worktree ← خطة مكتوبة ← تنفيذ بوكلاء فرعيين أو مباشر مع TDD ← مراجعة ← إنهاء الفرع. والوكيل يتحقق من وجود مهارة مناسبة قبل كل مهمة.
حالة المستودع تم التحقق منها في 2026-11-11: 315,938 نجمة على GitHub، وآخر إصدار v7.0.2 بتاريخ 2026-11-03، وآخر commit هو 22f0b463. عدد النجوم يتغير يوميًا فاقرأه كلقطة لحظية. أوامر التثبيت وأسماء المهارات وأرقام الإصدارات في هذه الصفحة منقولة من تلك المصادر لا معاد صياغتها.
ما هو Superpowers فعلًا
Superpowers إضافة مفتوحة المصدر برخصة MIT — v7.0.2 وقت الكتابة — تمنح Claude Code منهجية تطوير برمجيات لا صندوق أدوات إضافي. ليست نموذجًا ولا وسيط API ولا نسخة معدّلة: هي مكتبة من 15 مهارة مع تمهيد يجبر الوكيل على البحث عنها واتباعها.
المهارة مجلد يحتوي ملف SKILL.md: ترويسة YAML فيها name وdescription، ثم تعليمات markdown. الوصف هو المُشغِّل — يقرأه Claude Code ويقرر إن كانت المهارة مناسبة. ويضيف Superpowers خطافًا عند بدء الجلسة يحقن تمهيد using-superpowers، فيبحث الوكيل عن مهارة قبل الإجابة لا بعد كتابة الكود.
بناها Jesse Vincent (obra) في Prime Radiant ونُشرت في 2025-10-09، وهو اليوم نفسه الذي أطلقت فيه Anthropic نظام إضافات Claude Code. المستودع نفسه يُثبَّت أيضًا في Codex وCursor وGemini CLI وCopilot CLI وOpenCode وغيرها: مكتبة مهارات واحدة لعدة بيئات.
- الإصدار
- v7.0.2 · 2026-11-03
- آخر commit
- 22f0b463
- الرخصة
- MIT
تثبيت Superpowers في Claude Code
مسارَان مدعومان، وكلاهما منقول حرفيًا من README المستودع. نفّذهما داخل جلسة Claude Code — فهي أوامر شرطة مائلة لا أوامر صدفة.
المسار 1 — السوق الرسمي (سطر واحد)
سوق claude-plugins-official من Anthropic يُضاف تلقائيًا عند أول تشغيل لجلسة تفاعلية في Claude Code، لذا يكفي سطر التثبيت. ويشير README أيضًا إلى صفحة عرض على claude.com/plugins/superpowers.
/plugin install superpowers@claude-plugins-officialالمسار 2 — سوق Superpowers
استخدمه إن أردت سوق المؤلف نفسه، وهو يضم إضافات مرتبطة مثل superpowers-chrome وelements-of-style. السطر الأول يسجّل السوق والثاني يثبّت الإضافة بالاسم.
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplaceما تحتاجه قبل أن يعمل
- 1Claude Code 2.0.13 أو أحدث — وهو الحد الأدنى الذي يذكره مقال المؤلف لمسار الإضافة.
- 2إعادة تشغيل بعد التثبيت: اخرج ثم شغّل claude من جديد كي يحقن خطاف بدء الجلسة التمهيد.
- 3مستودع git لسير العمل الكامل — خطوة worktree تنشئ فرعًا معزولًا، وخطوة الإنهاء تعرض الدمج أو طلب السحب أو الإهمال.
بيئات أخرى، المستودع نفسه
يعطي README سطر تثبيت لكل وكيل برمجة. وهي هنا منقولة كما هي — أعد قراءة README قبل تنفيذها لأن الأوامر تتغير بين الإصدارات.
| البيئة | أمر التثبيت |
|---|---|
| Codex CLI | /plugins |
| Cursor | /add-plugin superpowers |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
| Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace |
| Antigravity | agy plugin install https://github.com/obra/superpowers |
| Qwen Code | qwen extensions install obra/superpowers |
| Kimi Code | /plugins install https://github.com/obra/superpowers |
| Factory Droid | droid plugin marketplace add https://github.com/obra/superpowers |
| Grok Build | grok plugin install superpowers@xai-official --trust |
| Pi | pi install git:github.com/obra/superpowers |
| Hermes | hermes plugins install obra/superpowers --enable |
سير العمل الذي يفرضه
هذا هو الجزء الذي يغيّر سلوك Claude Code فعليًا. سبع خطوات من قسم Basic Workflow في README، مع قاعدة أن الوكيل يتحقق من وجود مهارة مناسبة قبل أي مهمة.
- 1
brainstorming
قبل بناء أي شيء يسأل الوكيل عمّا تريده فعلًا ولماذا، ويعيد عليك فهمه لتصحيحه، ويكتب مستند تصميم لكل ما هو أكبر من تغيير صغير.
- 2
using-git-worktrees
بعد إقرار التصميم ينشئ مساحة عمل معزولة على فرع جديد، ويشغّل تهيئة المشروع، ويتحقق من خط أساس نظيف للاختبارات قبل لمس الكود.
- 3
writing-plans
يتحول التصميم المعتمد إلى مهام بحجم 2–5 دقائق، كل مهمة بمسارات ملفات دقيقة وكود كامل وخطوات تحقق.
- 4
subagent-driven-development أو executing-plans
وضعان للتنفيذ: وكيل فرعي جديد لكل مهمة مع مراجعة بعد كل واحدة (الأكثر شمولًا)، أو تنفيذ مباشر في الجلسة الحالية مع مراجعة واحدة للفرع كله في النهاية (الأقل كلفة).
- 5
test-driven-development
أثناء التنفيذ تُطبَّق دورة RED-GREEN-REFACTOR: اكتب الاختبار الفاشل، شاهده يفشل، اكتب أقل قدر من الكود، شاهده ينجح، ثم commit. والكود المكتوب قبل اختباره يُحذف.
- 6
requesting-code-review
بين المهام تُراجَع الأعمال مقابل الخطة وتُبلَّغ المشكلات حسب الخطورة — والمشكلات الحرجة توقف التقدم.
- 7
finishing-a-development-branch
في النهاية يتحقق من الاختبارات، ويعرض الدمج أو طلب السحب أو الإبقاء أو الإهمال، وينفّذ اختيارك وينظّف worktree.
المهارات الخمس عشرة في v7.0.2
أسماء المجلدات هي المعرّفات التي يطابقها الوكيل، لذا لا تُترجم. كل وصف يعيد صياغة ترويسة تلك المهارة عند الـ commit 22f0b463.
الاختبار
test-driven-development
اكتب الاختبار أولًا وشاهده يفشل ثم اكتب أقل كود يكفي للنجاح — مع مرجع لأنماط الاختبار المضادة.
تصحيح الأخطاء
systematic-debugging
عملية من أربع مراحل للوصول إلى السبب الجذري لأي خطأ أو اختبار فاشل أو سلوك غير متوقع قبل اقتراح إصلاح. إصلاح العَرَض يُعدّ فشلًا.
verification-before-completion
نفّذ أمر التحقق واقرأ خرجه قبل أن تعلن أن العمل مكتمل أو مُصلَح أو ناجح.
diagnosing-superpowers
حين تسوء جلسة، يقرأ نصّها ويبلّغ بما حدث بأدلة سطر بسطر، ويمكنه تجميع حزمة منقّحة لتقرير خطأ.
التعاون
brainstorming
إلزامية قبل أي عمل إبداعي: تستخرج النية بالأسئلة وتعيد الفهم عليك قبل البناء.
writing-plans
تحوّل المواصفات إلى خطة يستطيع مهندس لم يرَ الشيفرة تنفيذها: ملفات وأسماء وتواقيع واختبارات دقيقة لكل مهمة.
executing-plans
تنفيذ الخطة مباشرة: تنفّذ مهمة بعد مهمة في الجلسة الحالية، مع مراجعة واحدة للفرع كله في النهاية.
subagent-driven-development
وكيل فرعي منفّذ جديد لكل مهمة، ومراجعة للمواصفات والجودة بعد كل واحدة، ومراجعة واسعة للفرع كله في النهاية.
dispatching-parallel-agents
عند وجود مهمتين مستقلتين أو أكثر بلا حالة مشتركة، فوّض كل واحدة إلى وكيل بسياق خاص بدل التنفيذ التسلسلي.
requesting-code-review
يرسل وكيلًا مراجعًا بسياق مبني بدقة لتظهر المشكلات بين المهام لا في النهاية.
receiving-code-review
كيف تتعامل مع ملاحظات المراجعة: تحقق قبل التنفيذ، واسأل بدل أن تفترض، وتجنّب الموافقة الشكلية.
using-git-worktrees
يضمن وجود مساحة عمل معزولة، بأدوات worktree الأصلية للمنصة أولًا، ولا يعود إلى git worktree اليدوي إلا عند غيابها.
finishing-a-development-branch
تحقق من الاختبارات، وحدّد البيئة، واعرض الدمج أو طلب السحب أو الإبقاء أو الإهمال، ونفّذ الاختيار ثم نظّف.
ما-مهارات
writing-skills
إنشاء المهارات وتعديلها بتطبيق TDD على توثيق العمليات، بما في ذلك كيفية اختبار أن المهارة تُستدعى فعلًا.
using-superpowers
مهارة التمهيد: كيف تجد المهارات وكيف تحمّلها ولماذا يجب استدعاؤها قبل أي إجابة.
Superpowers مقابل Claude Code وحده
Claude Code وحده لديه بالفعل وضع التخطيط والمهارات الأصلية والوكلاء الفرعيون وworktrees والإضافات. لا يضيف Superpowers عناصر جديدة، بل يضيف رأيًا في متى تُستخدم، وخطافًا يجعل تجاوز هذا الرأي صعبًا.
| الموضوع | Claude Code وحده | مع Superpowers |
|---|---|---|
| من أين يأتي سير العمل | تختار في كل جلسة: وضع التخطيط، أو عرف في CLAUDE.md، أو نص جاهز تلصقه. | خطاف بدء الجلسة يحقن تمهيدًا إلزاميًا للمهارات فيصبح هذا التسلسل هو الافتراضي. |
| التخطيط | وضع التخطيط ينتج خطة توافق عليها ثم يبدأ التنفيذ في السياق نفسه. | brainstorming ← مستند تصميم ← writing-plans تحوّل الخطة إلى مهام 2–5 دقائق بمسارات ملفات واختبارات. |
| العزل والتنفيذ | worktrees والوكلاء الفرعيون موجودون، لكنك تقرر متى تستخدمهم. | using-git-worktrees يعمل تلقائيًا بعد التصميم، ثم تختار بين subagent-driven-development وexecuting-plans. |
| بوابات الجودة | تطلب الاختبارات والمراجعة بنفسك، أو تربط الخطافات وCI يدويًا. | TDD وverification-before-completion وrequesting-code-review تعمل بين المهام، والملاحظات الحرجة توقف التقدم. |
أين يفيد
- السلوك الافتراضي ينتقل من «اكتب الكود فورًا» إلى «اسأل أولًا» — وهو الفرق العملي الأكبر ومحور مقال المؤلف.
- مهارات صغيرة وقابلة للقراءة: كل سلوك ملف markdown تفتحه وتقارنه وتعدّله.
- مكتبة مهارات واحدة لبيئات متعددة — المستودع نفسه يُثبَّت في Claude Code وCodex وCursor وGemini CLI وغيرها.
ما يكلّفك
- رموز وأدوار أكثر: الأسئلة ومستند التصميم والخطة والمراجعات لكل مهمة تحدث قبل أول سطر كود إنتاجي.
- رأي قوي بقصد: YAGNI وTDD الصارم والاستدعاء الإلزامي للمهارات تناسب مشروعًا جديدًا أكثر من إصلاح عاجل في شيفرة قديمة.
- شيء إضافي يجب تحديثه، والفائدة الكاملة تفترض مستودع git وبيئة تدعم الوكلاء الفرعيين.
حين تنحرف جلسة
إن عملت مهارة في غير موضعها، أو صمتت حيث يجب أن تعمل، أو تجاهل الوكيل خطته، فالمستودع يضم مهارة diagnosing-superpowers لهذا تحديدًا. اطلبها داخل الجلسة — وأضف «in session <id>» لجلسة سابقة — فتقرأ النص وتذكر ما حدث بأدلة، ويمكنها تجميع حزمة منقّحة لتقرير خطأ.
figure out what went wrong with superpowers in session <id>القياس عن بُعد وكيف توقفه
README صريح: الرفيق البصري الاختياري في مهارة brainstorming يحمّل شعارًا من موقع Prime Radiant يحمل إصدار Superpowers، لكن دون أي تفاصيل عن المشروع أو الطلب أو الوكيل. اضبط SUPERPOWERS_DISABLE_TELEMETRY على أي قيمة صحيحة لإيقافه، كما يُحترم DISABLE_TELEMETRY وCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC في Claude Code.