إطار عمل Superpowers: منهجية هندسة البرمجيات والتطوير الموجه بالاختبارات للوكلاء الأذكياء

مع تحول وكلاء البرمجة الذاتية (Autonomous Coding Agents) من مجرد تجارب بحثية إلى أدوات عمل يومية للمطورين، واجهت الفرق الهندسية نمطا متكررا من الإخفاق: عندما يترك النموذج اللغوي دون قيود صارمة، فإنه يبدأ فورا في كتابة الأكواد دون توضيح المتطلبات المعمارية، ويتجاهل كتابة الاختبارات، وينشئ طبقات تجريد غير ضرورية، وينحرف تدريجيا عن سياق المشروع خلال جلسات العمل الطويلة.

يقدم مهندس أنظمة المصادر المفتوحة جيسي فنسنت (مؤسس Best Practical ومطور نظام Request Tracker ومدير مشروع K-9 Mail) إطار عمل Superpowers، الذي تحول إلى منهجية قياسية لهندسة برمجيات الوكلاء. حصد المشروع أكثر من 283 ألف نجمة على GitHub، ويوفر توافقا شاملا مع منصات Claude Code وCursor وCodex وOpenCode وHermes Agent وAntigravity، مستبدلا التوليد العشوائي بانضباط هندسي منهجي.

الركائز المعمارية لمنهجية Superpowers

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

1. الاستخلاص التفاعلي للمواصفات

عندما يتلقى وكيل غير منضبط أمرا عاما مثل “أضف نظام توثيق للمستخدمين”، فإنه يبادر فورا بكتابة مئات الأسطر معتمدا قواعد بيانات ومكتبات تشفير وفق تخمينات غير موجهة.

يجبر إطار Superpowers الوكيل على التوقف خطوة إلى الوراء. فمن خلال مهارات مثل brainstorming وinterview-me، يبدأ الوكيل بحوار استقصائي موجه مع المطور:

• ما هي آلية التوثيق المعتمدة (OAuth أم مفاتيح المرور Passkeys أم الجلسات المشفرة)؟
• ما هي المتطلبات الأمنية المطلوبة (تحديد معدل الطلبات، التوثيق الثنائي، سجلات التدقيق)؟
• ما هي النماذج البرمجية وقواعد البيانات الحالية التي يجب إعادة استخدامها؟

يمتنع الوكيل عن كتابة سطر كود تنفيذي واحد حتى يوافق المطور صراحة على مسودة مواصفات واضحة وموجزة.

2. خطط التنفيذ الصارمة

بعد اعتماد المواصفات، يصيغ الوكيل خطة تنفيذية مصممة خصيصا لتوجيه وكلاء تنفيذ لا يمتلكون سياقا مسبقا. تقسم كل خطة إلى مهام هندسية متناهية الصغر تشمل:

• المسارات المطلقة للملفات المنشأة أو المعدلة.
• أوامر الاختبار المحددة مع النتائج المتوقعة نصا.
• متطلبات وظيفية مباشرة تمنع التجريدات التخمينية والتعقيدات المسبقة.

يمنع هذا التقسيم ظاهرة “هلوسة السياق” (Context Hallucination)، حيث تتراكم التخمينات والقرارات المبكرة لتتحول بعد ساعات من العمل المستقل إلى انهيار معماري شامل.

3. التطوير الصارم الموجه بالاختبارات (TDD)

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

تتبع العملية تسلسلا حديديا لا يمكن تجاوزه:

• المرحلة الحمراء (Red): يكتب الوكيل اختبارا آليا يجسد السلوك المطلوب فقط، ثم يشغل مشغل الاختبارات ويتأكد من فشل الاختبار بسبب غياب الخاصية.
• المرحلة الخضراء (Green): يكتب الوكيل الحد الأدنى الضروري من كود التطبيق لجعل الاختبار ينجح دون زيادة.
• مرحلة إعادة الهيكلة (Refactor): تحسين الكود وتنظيفه دون تعديل توكيدات الاختبار.
• قاعدة حظر إضعاف الاختبارات: يمنع الوكيل من حذف أي اختبار سابق أو تخفيف شروطه لجعل الكود يمر بنجاح. ويعتبر فشل الاختبار دليلا قاطعا على وجود خلل برمجي في التطبيق يجب معالجته.

4. عزل بيئة العمل عبر شجيرات العمل (Git Worktrees)

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

يستفيد Superpowers من ميزة git worktree المدمجة في Git. فقبل بدء العمل، ينشئ الوكيل شجرة عمل معزولة في مجلد مستقل. تجري كافة عمليات البناء، والالتزام المرحلي، وتشغيل الاختبارات داخل هذه البيئة المعزولة. وفقط عند نجاح كافة الاختبارات والمراجعات، يتم دمج الفرع في شجرة العمل الأساسية.

5. مراجعات النظراء عبر وكلاء بسياق جديد

يعد استنزاف نافذة السياق (Context Window) السبب الرئيسي وراء تدهور أداء الوكلاء، فعندما تمتلئ الجلسة بآلاف الرموز من سجلات الأخطاء ومخرجات الطرفية، تتراجع قدرة النموذج على الاستدلال المنطقي.

يعالج Superpowers هذه المشكلة عبر مهارة subagent-driven-development. حيث يرسل الوكيل المنسق مهام محددة لوكلاء فرعيين مستقلين. وعندما ينهي الوكيل الفرعي مهمته، يتولى وكيل مراجعة مستقل يمتلك نافذة سياق نظيفة فحص الفروقات البرمجية مقارنة بالمواصفات الأصلية، والتأكد من عدم وجود ثغرات أو انحرافات قبل الانتقال إلى المهمة التالية.

بنية المهارات وقابلية النقل عبر المنصات

تتميز مهارات Superpowers بكونها معرفة وفق نسق تصريحي مفتوح. حيث تحتوي كل مهارة على مجلد مستقل يضم ملف SKILL.md مع ترويسة YAML:

---
name: test-driven-development
description: Drives development with tests. Use when implementing any logic, fixing any bug, or changing any behavior.
---

# Test-Driven Development

1. Write failing test first.
2. Verify test failure.
3. Write minimal code to pass.
4. Verify test pass.
5. Refactor cleanly.

وبفضل هذا المعيار المفتوح، يعمل إطار Superpowers بنفس السلوك عبر مختلف بيئات تشغيل الوكلاء:

• Claude Code: عبر إضافات .claude-plugin الرسمية، مما يساعد المطورين على إدارة استهلاك الجلسات بكفاءة في ظل تحديثات حدود الاستخدام الأسبوعية.
• Cursor: عبر موجهات وقواعد .cursor-plugin.
• Hermes Agent: عبر محرك مهارات .hermes-plugin.
• Codex وOpenCode: عبر قراءة ملفات .agents/skills مباشرة، متكاملا مع منصات تشغيل الوكلاء المستقلة مثل OpenClaw وأدوات تحليل الرسوم البيانية للأكواد مثل Graphify.

سيناريو تطبيقي لجلسة عمل هندسية

لتوضيح فاعلية المنهجية، نأخذ مثالا لوكيل مكلف بإضافة آلية إعادة المحاولة التدريجية (Exponential Backoff) لعميل HTTP:

# ينشئ الوكيل شجرة عمل معزولة
git worktree add -b feature/retry-backoff .worktrees/retry-backoff main

# المرحلة الحمراء: يكتب الوكيل الفرعي الاختبار الفاشل أولا
npm test -- test/http-client.test.ts
# النتيجة: FAIL - Expected retry count 3, received 1

# المرحلة الخضراء: يكتب الوكيل المنطق البرمجي المطلوب في src/http-client.ts
npm test -- test/http-client.test.ts
# النتيجة: PASS - 4 tests passed (12ms)

# بوابة التحقق: وكيل التدقيق يفحص الفروقات البرمجية
# يتأكد من تغطية الحالات الحدية وغياب أي تسريب للمحاكيات الوهمية

تتم هذه العملية بالكامل دون تدخل يدوي، مع الالتزام التام بمعايير الاختبار وجودة الكود المعتمدة في المشروع.

المقايضات الهندسية والتحديات التشغيلية

يتطلب اعتماد Superpowers مراعاة عدة اعتبارات عملية:

• استهلاك إضافي للرموز (Tokens): تستهلك الحوارات الاستقصائية وصياغة الخطط التفصيلية وتشغيل وكلاء المراجعة المستقلين عددا أكبر من الرموز مقارنة بالبرمجة المباشرة.
• بداية أبطأ للسرعة الظاهرية: قد يجد المطور الذي يبحث عن نص برمجي سريع من سطر واحد أن مرحلة الحوار ووضع الخطة تشكل عبئا إضافيا للمهام البسيطة.
• الاعتماد على بيئات اختبار مؤتمتة: يتطلب نجاح منهجية TDD وجود منظومة اختبارات موثوقة في المشروع، وفي المشاريع التي تفتقر إليها، يجب تأسيس بيئة الاختبارات أولا قبل جني ثمار المنهجية.

وعلى الرغم من هذه التكاليف، فإن Superpowers يمثل نقلة نوعية للمشاريع الإنتاجية التي تعلي من شأن الأمان والموثوقية والاستدامة المعمارية فوق مجرد سرعة الكتابة المؤقتة.

المصادر

• المستودع البرمجي الرسمي obra/superpowers على GitHub
• سجل التغييرات وملاحظات الإصدار لمشروع Superpowers
• المواصفات المفتوحة لمهارات الوكلاء البرمجية
• دليل مارتن فاولر لمبادئ التطوير الموجه بالاختبارات TDD