قدرات Superpowers لـ Claude Code للتطوير بمستوى هندسي

مقدمة في Superpowers

Superpowers هو إطار مهارات وكلاء مفتوح المصدر أنشأه Jesse Vincent (الاسم المستعار عبر الإنترنت: obra)، مصمم خصيصًا لحل مشكلة أساسية في البرمجة بالذكاء الاصطناعي: كيف تجعل الذكاء الاصطناعي ينتج كودًا "بمستوى هندسي" بدلاً من كود "بمستوى الألعاب."

تخيل مساعد برمجة ذكاء اصطناعي عادي كـ "متدرب ذكي." يمكنه كتابة كود قابل للتشغيل، لكن قد لا يكون لديه اختبارات أو توثيق أو انضباط أفضل الممارسات. Superpowers مثل تعيين "مرشد مهندس أول" لذلك المتدرب، مما يجبره على اتباع عملية تطوير برمجيات كاملة.

لماذا نحتاج Superpowers؟

قبل Superpowers، كانت هناك عدة مشاكل عند استخدام Claude Code:

• فوضى في vibe coding: الذكاء الاصطناعي يبدأ البرمجة مباشرة بدون تخطيط، مما يسبب إعادة عمل متكررة
• غياب انضباط TDD: يميل الذكاء الاصطناعي لكتابة الكود أولاً وإضافة الاختبارات لاحقًا، أو تخطي الاختبارات بالكامل
• البرمجة بمتطلبات غامضة: يقول المستخدم "ابنِ ميزة تسجيل دخول،" يبدأ الذكاء الاصطناعي فورًا، والنتيجة ليست ما أراده
• جودة كود غير مستقرة: لا توجد آلية مراجعة كود، فالجودة تعتمد على "مزاج" الذكاء الاصطناعي

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

---

البدء السريع

الخطوة 1: تثبيت Superpowers

شغّل في Claude Code:

# إضافة السوق
/plugin marketplace add obra/superpowers-marketplace

# تثبيت superpowers
/plugin install superpowers@superpowers-marketplace

أو استنسخ يدويًا:

git clone https://github.com/obra/superpowers.git ~/.claude/skills/superpowers

الخطوة 2: جرب مهارتك الأولى

لنستخدم مهارة brainstorming في Superpowers لتجربة قيمتها.

في Claude Code، اكتب:

Build me a user login feature

قبل Superpowers: يبدأ Claude في كتابة الكود مباشرة وقد ينتج شيئًا لا تريده فعلًا.

مع Superpowers: يستخدم Claude أسئلة سقراطية للمساعدة في توضيح المتطلبات:

هل ميزة تسجيل الدخول هذه لتطبيق ويب أم تطبيق موبايل؟

ما طرق تسجيل الدخول المطلوبة؟ بريد إلكتروني/كلمة مرور؟ تسجيل دخول طرف ثالث (Google، GitHub)؟

هل تحتاج ميزة "تذكرني"؟

هل يجب أن يكون إعادة تعيين كلمة المرور عبر البريد الإلكتروني أم SMS؟

...

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

الخطوة 3: فهم آليات تفعيل المهارات

Superpowers ليست "مفتاح سحر." هي مجموعة مهارات. فهم كيف تُفعل المهارات مهم.

ثلاث طرق للتفعيل:

1. تفعيل بالكلمة المفتاحية

   • عندما تذكر "TDD" أو "التطوجه الموجه بالاختبار" أو "اكتب اختبارات أولاً"
   • تُفعل مهارة test-driven-development

2. تفعيل بالسيناريو

   • عندما تكون المتطلبات غير واضحة، يسأل brainstorming أسئلة استباقية
   • عندما تظهر أخطاء، يُفعل systematic-debugging

3. استدعاء يدوي

   • استخدم أسماء المهارات مباشرة، مثل: /test-driven-development

💡 توضيح مهم: ماذا يحدث إذا لم تحدد TDD؟

هذه مفهوم خاطئ شائع. لنوضح:

# الحالة أ: TDD غير مذكور
"Implement a calculator"
-> قد يكتب Claude اختبارات، أو قد لا يفعل
-> يعتمد على عادات النموذج نفسه

# الحالة ب: TDD مطلوب صراحةً
"Implement a calculator with TDD"
-> تُفعل مهارة test-driven-development
-> يُفرض RED-GREEN-REFACTOR

القيمة الحقيقية لـ Superpowers: ليست خلق قدرات من لا شيء، بل تعزيز الانضباط.

• بدون مهارة TDD: كتابة Claude للاختبارات "ربما"
• مع مهارة TDD: يُجبر Claude على اتباع تدفق TDD

فهم قيمة Superpowers

من الشرح أعلاه، القيمة الأساسية لـ Superpowers واضحة:

1. المتطلبات أولاً: brainstorming يسأل بنشاط عندما تكون المتطلبات غامضة
2. انضباط العملية: test-driven-development يفرض دورة TDD أحمر-أخضر-إعادة هيكلة
3. تحليل المهام: writing-plans يقسم المشاريع الكبيرة لمهام صغيرة
4. مراقبة الجودة: مهارات code-review تضمن جودة الكود

---

تفاصيل مهارات Superpowers الأساسية

يتضمن Superpowers 20+ مهارة قابلة للتكوين تغطي دورة حياة البرمجيات بالكامل. لنمر عليها حسب الفئة.

🧪 مهارات الاختبار

test-driven-development

كيفية التفعيل: اذكر كلمات مفتاحية مثل "TDD" أو "التطوجه الموجه بالاختبار" أو "اكتب اختبارات أولاً."

ماذا تفعل هذه المهارة: تجبر Claude على اتباع دورة TDD أحمر-أخضر-إعادة هيكلة بدلاً من "ربما كتابة اختبارات لاحقًا."

النهج التقليدي (مشاكل شائعة):

1. كتابة الكود مباشرة
2. اختبار يدوي سريع
3. اكتشاف أخطاء وإصلاح الكود
4. التكرار... (اختبارات؟ ربما في المرة القادمة)

نهج TDD (بعد تفعيل المهارة):

1. 🔴 RED: كتابة اختبار فاشل أولاً
2. 🟢 GREEN: كتابة الحد الأدنى من الكود لاجتياز الاختبار
3. 🔵 REFACTOR: إعادة الهيكلة مع الحفاظ على اجتياز الاختبارات
4. التكرار

مثال الاستخدام:

Implement a user authentication module using TDD

سيقوم Claude بـ:

1. كتابة الاختبارات أولاً (التحقق من اسم المستخدم/كلمة المرور، توليد الرمز، إلخ)
2. تشغيل الاختبارات والتأكد من فشلها جميعًا (RED)
3. كتابة كود التنفيذ الأدنى
4. تشغيل الاختبارات والتأكد من اجتيازها (GREEN)
5. إعادة هيكلة الكود واستخراج المنطق المشترك
6. تشغيل الاختبارات مرة أخرى والتأكد من اجتيازها (REFACTOR)

ملاحظة: إذا لم تذكر "TDD"، قد يكتب Claude اختبارات أو لا. دور المهارة هو فرض انضباط العملية حتى لا تُنسي الاختبارات.

🐛 مهارات التصحيح

systematic-debugging

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

المرحلة 1: إعادة إنتاج المشكلة

• التأكد من أن الخطأ يمكن إعادة إنتاجه بشكل ثابت
• تسجيل خطوات إعادة الإنتاج الدقيقة

المرحلة 2: عزل السبب الجذري

• تضييق النطاق باستخدام تقليص بنمط البحث الثنائي
• إضافة سجلات لتحديد الكود المشكل

المرحلة 3: التحقق من الفرضيات

• اقتراح فرضيات السبب الجذري
• تصميم تجارب تحقق

المرحلة 4: الإصلاح والتحقق

• تنفيذ الإصلاح
• التأكد من حل الخطأ
• إضافة اختبارات الانحدار

verification-before-completion

هذه المهارة تمنع Claude من التوقف عندما تبدو الأشياء "قريبة بما فيه الكفاية." قبل الادعاء بالإكمال، يتطلب من Claude:

1. تشغيل جميع الاختبارات
2. اختبار الميزات الرئيسية يدويًا
3. التحقق من جودة الكود (lint)
4. التأكد من تحديث التوثيق

🤝 مهارات التعاون

brainstorming

هذه واحدة من أكثر مهارات Superpowers إثارة. تستخدم الأسئلة السقراطية لتوضيح المتطلبات.

كيف تعمل: عندما تقدم متطلبًا غامضًا، لا يبدأ Claude البرمجة مباشرة. بل يسأل:

أنت: ابنِ نظام مدونة

Claude:
- لمن هذه المدونة؟ قراء تقنيين أم قراء عامين؟
- هل يجب دعم تحرير Markdown؟
- هل تحتاج تعليقات؟
- هل تحتاج بحث؟
- مستخدم واحد أم مؤلفون متعددون؟
- ...

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

writing-plans

هذه المهارة تقسم المهام الكبيرة إلى مهام صغيرة يمكن إكمال كل منها في 2-5 دقائق.

مثال:

Use writing-plans to plan development of a todo API

سيولد Claude خطة مفصلة:

# خطة التنفيذ

## المهمة 1: تصميم مخطط قاعدة البيانات (5 دقائق مقدرة)
- إنشاء جدول todos
- تحديد الحقول: id، title، completed، createdAt

## المهمة 2: إنشاء مسارات Express (10 دقائق مقدرة)
- POST /todos - إنشاء مهمة
- GET /todos - قائمة المهام
- GET /todos/:id - الحصول على مهمة واحدة
- PUT /todos/:id - تحديث
- DELETE /todos/:id - حذف

## المهمة 3: إضافة التحقق من المدخلات (10 دقائق مقدرة)
- title لا يمكن أن يكون فارغًا
- completed يجب أن يكون boolean

## المهمة 4: كتابة الاختبارات (15 دقيقة مقدرة)
- كتابة اختبارات لكل نقطة نهاية
- تغطية الحالات الحدية

## المهمة 5: تشغيل الخادم والتحقق (5 دقائق مقدرة)
- تشغيل الاختبارات
- اختبار API يدويًا

معايير القبول:
- جميع الاختبارات تجتاز
- اختبار curl يجتاز لكل نقطة نهاية

executing-plans

هذه المهارة تنفذ خطة على دفعات وتتوقف عند كل نقطة تحقق للتأكيد.

مثال الاستخدام:

Execute the plan above, and pause after each completed task

سيقوم Claude بـ:

1. إنهاء المهمة 1، ثم التوقف: ✅ Database schema done. Continue?
2. بعد تأكيدك، إنهاء المهمة 2 والتوقف مرة أخرى
3. وهكذا

هذا يتيح لك التحقق من الاتجاه في كل مرحلة، وتجنب اكتشاف متأخر أن الأمور انحرفت عن المسار.

dispatching-parallel-agents

هذه المهارة يمكنها تشغيل عدة وكلاء فرعيين بالتوازي.

حالة الاستخدام: عندما تحتاج معالجة مهام مستقلة متعددة في وقت واحد.

Use parallel agents to complete:
- Agent A: write backend APIs
- Agent B: write frontend components
- Agent C: write tests

كل وكيل يعمل في بيئته المعزولة بدون تداخل.

subagent-driven-development

هذه المهارة تطلق وكيلًا فرعيًا مستقلًا لكل مهمة صغيرة.

المزايا:

• كل وكيل فرعي لديه سياق معزول
• فشل مهمة واحدة لا يؤثر على الأخرى
• مهام متعددة يمكن أن تعمل بالتوازي

using-git-worktrees

هذه المهارة تستخدم Git worktree لإنشاء بيئات تطوير معزولة.

الفوائد:

• ميزات متعددة يمكن تطويرها بالتوازي
• كل worktree مستقل
• بدون تعارضات متبادلة

👀 مهارات مراجعة الكود

requesting-code-review

بعد إكمال الكود، تطلب هذه المهارة مراجعة كود تلقائيًا.

Automatically trigger code review after finishing the feature

receiving-code-review

هذه المهارة تحدد كيفية تلقي ومعالجة ملاحظات المراجعة.

سير عمل المراجعة:

1. إرسال الكود
2. تفعيل المراجعة تلقائيًا
3. يتحقق المراجع من جودة الكود والأمان وتغطية الاختبارات
4. يقدم المراجع اقتراحات تحسين
5. إصلاح المشاكل
6. إعادة المراجعة حتى الموافقة

---

سير عمل Superpowers الكامل

القوة الحقيقية لـ Superpowers تأتي من الجمع بين مهارات متعددة في سير عمل تطوير كامل.

سير عمل التطوير القياسي

1. العصف الذهني (Brainstorming)
   ↓ توضيح المتطلبات الحقيقية من خلال الأسئلة والأجوبة

2. وثيقة التصميم
   ↓ تقديم التصميم في أجزاء وانتظار التأكيد

3. كتابة الخطط
   ↓ التقسيم لمهام من 2-5 دقائق

4. تطوير بالوكلاء الفرعيين
   ↓ إطلاق وكيل فرعي معزول لكل مهمة
   ↓ مراجعة ثنائية: توافق المواصفة + جودة الكود

5. TDD
   ↓ فرض RED-GREEN-REFACTOR

6. مراجعة الكود
   ↓ بوابة الجودة

7. تم

مثال عملي: بناء نظام مصادقة مستخدم مع Superpowers

لنختبر سير عمل Superpowers من خلال مثال كامل.

الخطوة 1: توضيح المتطلبات مع Brainstorming

I need a user authentication system

سيسأل Claude:

• هل هو تطبيق ويب أم تطبيق موبايل؟
• ما طرق تسجيل الدخول المطلوبة؟
• هل إعادة تعيين كلمة المرور مطلوبة؟
• هل ميزة "تذكرني" مطلوبة؟
• ...

الخطوة 2: توليد وثيقة التصميم

بعد تأكيد المتطلبات، سينتج Claude وثيقة تصميم:

# تصميم نظام مصادقة المستخدم

## المتطلبات الوظيفية
1. تسجيل المستخدم (بريد إلكتروني + كلمة مرور)
2. تسجيل دخول المستخدم
3. إعادة تعيين كلمة المرور (بريد إلكتروني)
4. تذكرني (JWT + Refresh Token)

## الاختيارات التقنية
- الواجهة الخلفية: Node.js + Express
- قاعدة البيانات: SQLite
- المصادقة: JWT
- التشفير: bcrypt

## تصميم API
- POST /api/auth/register
- POST /api/auth/login
- POST /api/auth/refresh
- POST /api/auth/reset-password

الخطوة 3: كتابة خطة التنفيذ

Use writing-plans to create the implementation plan

سيولد Claude قائمة مهام مفصلة، كل مهمة قابلة للإكمال في 2-5 دقائق.

الخطوة 4: تنفيذ التطوير

Execute the plan above with TDD

سيقوم Claude بـ:

1. كتابة الاختبارات أولاً
2. التأكد من فشل الاختبارات (RED)
3. كتابة كود التنفيذ
4. التأكد من اجتياز الاختبارات (GREEN)
5. إعادة هيكلة الكود (REFACTOR)

الخطوة 5: مراجعة الكود

بعد الإكمال، تُفعل مراجعة الكود تلقائيًا للتحقق من:

• جودة الكود
• الأمان (حقن SQL، XSS، إلخ)
• تغطية الاختبارات
• اكتمال التوثيق

---

Superpowers مقابل استخدام Claude Code المباشر

البعد	استخدام Claude Code المباشر	استخدام Superpowers
توضيح المتطلبات	الذكاء الاصطناعي يبدأ البرمجة مباشرة	أسئلة سقراطية توضح المتطلبات أولاً
عملية التطوير	حرة تعتمد على الذكاء الاصطناعي	TDD أحمر-أخضر-إعادة هيكلة مفروض
إدارة المهام	إكمال دفعة واحدة	مقسمة لمهام صغيرة مع نقاط تحقق
جودة الكود	تعتمد على حكم الذكاء الاصطناعي	مراجعة كود مفروضة
قابلية التنبؤ	نتائج غير مستقرة	عملية قابلة للتكرار
الأفضل لـ	مهام بسيطة، التحقق من النماذج الأولية	مشاريع معقدة، كود الإنتاج

استعارة بصرية

إذا كان Claude Code "متدربًا ذكيًا":

• الاستخدام المباشر: أخبر المتدرب "ابنِ ميزة تسجيل دخول،" ويبدأ البرمجة فورًا، ربما ينتج شيئًا تجده خارج الهدف
• مع Superpowers: عيّن للمتدرب مرشدًا أول يوضح المتطلبات ويخطط ويتحقق من جودة الكود

---

التثبيت والإعداد بالتفصيل

الطريقة 1: عبر السوق (موصى بها)

# إضافة السوق
/plugin marketplace add obra/superpowers-marketplace

# التثبيت
/plugin install superpowers@superpowers-marketplace

# التحقق من التثبيت
/skills

الطريقة 2: الاستنساخ اليدوي

# إنشاء الدليل
mkdir -p ~/.claude/skills

# استنساخ المستودع
git clone https://github.com/obra/superpowers.git ~/.claude/skills/superpowers

الطريقة 3: التثبيت على مستوى المشروع

إذا أردت استخدام Superpowers في مشروع محدد:

# في جذر المشروع
mkdir -p .claude/skills

# استنساخ أو نسخ superpowers
cp -r ~/.claude/skills/superpowers .claude/skills/

هذا يسمح لأعضاء الفريق بمشاركة نفس إعدادات Superpowers.

---

مرجع سريع للمهارات الشائعة

اسم المهارة	الوظيفة	حالة الاستخدام
brainstorming	توضيح المتطلبات عبر الأسئلة السقراطية	عندما تكون المتطلبات غير واضحة
writing-plans	تقسيم المهام لخطوات صغيرة	قبل بدء المشاريع الكبيرة
executing-plans	تنفيذ الخطة مع نقاط تحقق	أثناء التطوجه الموجه بالخطة
test-driven-development	حلقة TDD أحمر-أخضر-إعادة هيكلة	لجميع تطوير الميزات
systematic-debugging	تحليل سبب جذري رباعي المراحل	عندما تظهر أخطاء
verification-before-completion	التحقق قبل الإكمال	عند إكمال المهمة
requesting-code-review	طلب مراجعة كود	قبل إرسال الكود
subagent-driven-development	تطوير موجه بالوكلاء الفرعيين	مهام متوازية
using-git-worktrees	عزل Git worktree	تطوير ميزات متوازية

---

أفضل الممارسات

1. استخدم كلمات مفتاحية واضحة للتفعيل

مهارات Superpowers تُفعل بالكلمات المفتاحية. تعلم الكلمات المفتاحية الشائعة:

المهارة	كلمات التفعيل المفتاحية
test-driven-development	"TDD"، "test-driven"، "write tests first"
brainstorming	تُفعل تلقائيًا عندما تكون المتطلبات غير واضحة
systematic-debugging	"debug"، "bug"، "not working"
writing-plans	"make a plan"، "planning"

2. استخدم Superpowers عندما يكون انضباط العملية مطلوبًا

• تطوير كود بمستوى الإنتاج -> اذكر "TDD"
• المتطلبات غير واضحة -> دع brainstorming يوضح
• مشروع معقد -> استخدم writing-plans لتقسيم المهام

3. لا تجبرها للمهام البسيطة

إذا كان نموذجًا أوليًا سريعًا أو سكريبت لمرة واحدة، لا تحتاج العملية الكاملة. Superpowers الأنسب للكود الذي يتطلب صيانة طويلة الأمد.

4. المهارات يمكن دمجها

Implement user authentication with TDD, and after completion, help me do a code review

هذا يفعل كلاً من مهارتي test-driven-development و code-review.

---

أسئلة متكررة

س1: هل يجب علي تحديد "TDD" عند استخدام Superpowers؟

غير مطلوب.

Superpowers هي مجموعة مهارات، وكل مهارة لها شروط تفعيل خاصة:

• قل "use TDD" -> يفعل test-driven-development
• لا تقل TDD -> قد يكتب Claude اختبارات أو لا (يعتمد على سلوك النموذج)

Superpowers موجودة لفرض انضباط العملية، وليس لخلق القدرة من لا شيء.

س2: هل يجعل Superpowers التطوير أبطأ؟

في البداية، قد يبدو أبطأ لأن:

• توضيح المتطلبات يأخذ وقتًا
• الاختبارات تُكتب قبل الكود
• مراجعة الكود مطلوبة

لكن على المدى الطويل، تتحسن الكفاءة الإجمالية بسبب تقليل إعادة العمل وأخطاء أقل.

س3: هل المشاريع الصغيرة تحتاج أيضًا Superpowers؟

للتحقق من النماذج الأولية أو المهام البسيطة جدًا، يمكنك استخدام Claude Code مباشرة. Superpowers أنسب لـ:

• مشاريع بمستوى الإنتاج
• تعاون متعدد الأشخاص
• قابلية الصيانة طويلة الأمد

س4: ما الفرق بين Superpowers و Skills؟

البعد	Superpowers	Skills
الطبيعة	إطار منهجية تطوير كامل	حزم مهارات قابلة لإعادة الاستخدام
النطاق	يغطي عملية التطوير الكاملة	يركز على وظائف محددة
العلاقة	Superpowers يستخدم Skills داخليًا	Superpowers هي مجموعة من Skills

س5: هل يمكنني تخصيص مهارات Superpowers؟

نعم. Superpowers مفتوح المصدر، ويمكنك:

1. Fork المستودع
2. تعديل المهارات الموجودة
3. إضافة مهارات جديدة
4. المساهمة مرة أخرى للمجتمع

---

مراجع

الموارد الرسمية

• obra/superpowers GitHub - المستودع الرسمي (50,000+ ⭐)
• دليل استخدام Superpowers المفصل - دليل صيني مفصل
• دليل إعداد بيئة Superpowers - دليل الإعداد

موارد المجتمع

المستودع	الوصف
affaan-m/everything-claude-code	مجموعة أدوات شاملة تتضمن سير عمل TDD
shanraisshan/claude-code-best-practice	أفضل الممارسات الرسمية

مقالات ذات صلة

• وداعًا Vibe Coding! استخدم Superpowers لجعل Claude Code يكتب كودًا بمستوى هندسي
• كيف أستخدم Superpowers MCP لإجبار Claude Code على التخطيط قبل البرمجة
• دليل المبتدئين Claude Code + Superpowers

---

الملخص

Superpowers هي مجموعة مهارات تطوير بمستوى هندسي التي تطور Claude Code من "متدرب ذكي" إلى "فريق تطوير منضبط."

النتائج الرئيسية

1. Superpowers هي مجموعة مهارات، وليست سحرًا

   • بعد التثبيت، المهارات متاحة في الخلفية
   • تُفعل عبر كلمات مفتاحية أو سيناريوهات
   • يمكنك استدعاء مهارات محددة يدويًا

2. تذكر عبارات التفعيل الرئيسية

   • تريد TDD -> قل "use TDD"
   • متطلبات غامضة -> brainstorming يسأل بنشاط
   • يظهر خطأ -> اذكر "debug" لتفعيل systematic-debugging

3. السيناريوهات الأنسب

   • ✅ تطوير كود بمستوى الإنتاج
   • ✅ مشاريع قابلة للصيانة طويلة الأمد
   • ✅ مشاريع تعاون الفريق
   • ❌ النماذج الأولية السريعة (اختياري)
   • ❌ السكريبتات لمرة واحدة (اختياري)

تذكر: Superpowers لا تجعل الذكاء الاصطناعي أذكى؛ بل تجعل الذكاء الاصطناعي أكثر انضباطًا.