symfony-hexagonal-skill

لماذا تستخدمه

الميزات الأساسية

10 مهارات ذات تفعيل تلقائي لأنماط Symfony
عاملا مراجعة يلتقطان انتهاكات الفصل بين الطبقات
يدعم إعادة هيكلة تدريجية لأسس الأكواد الموجودة
قوالب لطبقات المجال والتطبيق والبنية التحتية
أنماط DTO و Command و Query مدمجة فيها

عرض مباشر

كيف يبدو في الممارسة

symfony-hexagonal-skill.replay ▶ جاهز

0/0

التثبيت

مستودع المؤلف · وثائق Claude Skills الرسمية

حالات الاستخدام

استخدامات عملية: symfony-hexagonal-skill

بناء مياق محدود جديد بطبقات الهندسة السادسة الأضلاع

👤 مطوري Symfony الذين يبنون منطق مجال غير تافه ⏱ ~60 min advanced

متى تستخدمه: تبدأ ميزة جديدة وتريد أن يكون الفصل بين الطبقات صحيحاً من البداية.

الخطوات

تسمية السياق

استخدم symfony-hexagonal-skill. بناء مياق محدود 'Billing' مع Invoice Aggregate وأوامر issue/void واستعلام للفواتير المفتوحة.✓ تم النسخ

→ مجلدات src/Billing/Domain و Application و Infrastructure بفصل مناسب
ربط البنية التحتية

إضافة محول Doctrine ل InvoiceRepository خلف منفذ المجال.✓ تم النسخ

→ واجهة في Domain وتطبيق في Infrastructure وربط في services.yaml
تعريض بواسطة المتحكم

إضافة محول HTTP مع نقطة نهاية POST /invoices ترسل أمر IssueInvoice.✓ تم النسخ

→ المتحكم يستدعي الناقل وليس المستودع مباشرة

النتيجة: مياق محدود نظيف لن يتحول إلى أكواد معقدة في 6 أشهر.

المزالق

المجال يعتمد على تعليقات Doctrine التوضيحية — استخدم تعيين XML أو attribute في البنية التحتية وليس على كيانات المجال

اجمعها مع: filesystem

مراجعة طلب دمج للتحقق من انتهاكات الفصل بين الطبقات

👤 قادة التقنية في فرق Symfony ⏱ ~20 min intermediate

متى تستخدمه: مراجعة طلب دمج وتريد فحصاً آلياً أولياً للفصل بين الطبقات.

الخطوات

تشغيل عامل المراجعة

استخدم عامل مراجعة symfony-hexagonal-skill على هذا الفارق. علّم أي استيرادات Doctrine أو Symfony Framework في Domain/ وأي استدعاءات مباشرة من controller إلى repository وأي تسرب ORM في الاستجابات.✓ تم النسخ

→ نتائج محددة مع ملف وسطر
اقتراح الإصلاحات

لكل نتيجة، اقترح إعادة البنية الأقل.✓ تم النسخ

→ اختلافات تقدم منفذاً أو DTO

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

اجمعها مع: github

إعادة هيكلة تدريجية لتطبيق Symfony موجود نحو الهندسة السادسة الأضلاع

👤 فرق لديها مشروع Symfony قديم ⏱ ~120 min advanced

متى تستخدمه: إعادة الكتابة من الصفر ليست خياراً؛ تريد تنظيفاً تدريجياً.

الخطوات

تحديد ربط

استخدم symfony-hexagonal-skill. انظر إلى src/Module/Orders — ما أصغر جزء يمكن أن أرفعه إلى مجال نظيف؟✓ تم النسخ

→ فئة محددة مع خطة استخراج
الاستخراج التدريجي

أخبرني خلال الاستخراج في 3 خطوات بحجم طلب الدمج.✓ تم النسخ

→ خطة مرحلة مع الاختبارات محفوظة في كل خطوة

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

المزالق

استخراج الكثير في خطوة واحدة — شرائح بحجم طلب الدمج فقط؛ عامل مراجعة المكون يساعد في توضيب كل خطوة

اجمعها مع: git

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

symfony-hexagonal-skill + github

منع دمج الطلبات حتى تجتاز مراجعة الفصل بين الطبقات

قم بتشغيل مراجعة الهندسة على طلب الدمج المفتوح في هذا المستودع وأنشر النتائج كتعليقات.✓ تم النسخ

symfony-hexagonal-skill + filesystem

تطبيق الهياكل على المستودع الفعلي

طبق هيكل السياق على مشروعي تحت src/.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها
context_scaffold	context name, aggregates	مياق محدود جديد
port_adapter_pair	port interface name, adapter type	إضافة بنية تحتية
layering_review	diff or directory	قبل الدمج
refactor_plan	legacy module	بدء تنظيف

التكلفة والحدود

تكلفة التشغيل

حصة API: لا شيء
الرموز لكل استدعاء: معتدل — تقوم المراجعات بمسح الملفات
التكلفة المالية: مجاني
نصيحة: أحصر المراجعات على الفارق وليس المستودعات بأكملها لتوفير الرموز.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: لا شيء

نقل البيانات الخارجي: لا شيء من المهارة

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

عامل المراجعة يفتقد الانتهاكات

تأكد من وجود الفارق الكامل في السياق؛ قد تحتاج الاختلافات الكبيرة جداً إلى تقسيم

الهيكل ينتج نمط Symfony 5 القديم

أذكر إصدار Symfony الخاص بك بوضوح — اتفاقيات 6 مقابل 7 مختلفة

البدائل