المهارات software-architecture
🏗️

software-architecture

آمن

بناء بنية برمجية قابلة للتوسع

متاح أيضًا من: Doyajin174,Chemiseblanc

توقف عن اختراع العجلة باستخدام أدوات مساعدة مخصصة. هذه المهارة تعلمك مبادئ Clean Architecture وDomain-Driven Design لمساعدتك في كتابة كود قابل للصيانة والتوسع.

يدعم: Claude Codex Code(CC)
📊 71 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "software-architecture". راجع فئة UserService هذه للكشف عن مشاكل بنائية: [ فئة UserService تحتوي على استعلامات قاعدة بيانات واتصالات API وعرض واجهة المستخدم مختلطة معاً ]

النتيجة المتوقعة:

المشاكل البنيوية المكتشفة: 1) اهتمامات مختلطة - استعلامات قاعدة البيانات تنتمي إلى طبقة Repository، 2) عرض واجهة المستخدم يجب أن يكون في مكون عرض منفصل، 3) اتصالات API يجب أن تكون في خدمة مخصصة. إعادة الهيكلة الموصى بها: قسّم إلى UserRepository (بيانات)، UserService (منطق عمل)، و UserView (عرض).

استخدام "software-architecture". أحتاج إلى تطبيق معالجة المدفوعات. هل أبنيها بنفسي أم أستخدم مكتبة؟

النتيجة المتوقعة:

التوصية: استخدم Stripe أو Paddle بدلاً من بناء معالجة مدفوعات مخصصة. هذه الخدمات تتعامل مع امتثال PCI والفواتير المتكررة و webhooks وحالات الحافة التي قد تستغرق أشهرًا لبنائها بنفسك. فكّر فقط في التطبيق المخصص إذا كان لديك متطلبات فريدة للغاية لا يمكن للحلول الحالية تلبيتها.

استخدام "software-architecture". صمم وحدة لمعالجة الطلبات في تطبيق تجارة إلكترونية

النتيجة المتوقعة:

البنية الموصى بها (DDD): 1) كيان Order (النطاق): Order، OrderItem، OrderStatus. 2) المستودعات: OrderRepository، InventoryRepository. 3) الخدمات: OrderService (placeOrder، cancelOrder)، PaymentService (processPayment)، InventoryService (reserveItems). 4) الأنماط المضادة لتجنبها: OrderController يقوم بمنطق العمل، استعلامات قاعدة بيانات في المتحكمات، فئة OrderUtils عامة.

التدقيق الأمني

آمن
v1 • 2/25/2026

All static analysis findings are false positives. Detected 'backtick execution' patterns are markdown code emphasis formatting for library names and file examples. 'Weak cryptographic algorithm' detections are references to 'Clean Architecture' design pattern, not cryptography. 'System reconnaissance' patterns match legitimate software development guidance. This skill contains no executable code and provides educational architecture guidance only.

1
الملفات التي تم فحصها
81
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
24
المجتمع
100
الأمان
100
الامتثال للمواصفات

ماذا يمكنك بناءه

بنية مشروع جديد

بدء مشروع جديد وتحتاج إلى إنشاء أساس بنيوي متين من اليوم الأول

إعادة هيكلة الكود القديم

تحسين جودة الكود في قاعدة كود حالية بتطبيق مبادئ clean architecture

معايير مراجعة الكود

إنشاء إرشادات بنائية متناسقة لمراجعات الكود وطلبات السحب للفريق

جرّب هذه الموجهات

مراجعة بنية الكود الخاص بي 
راجع هذا المكون للكشف عن مشاكل بنائية. تحقق من: التسمية العامة (utils/helpers)، خلط منطق العمل مع واجهة المستخدم، طول الملف أكثر من 200 سطر، ودوال أكثر من 50 سطراً. اقترح تحسينات باتباع مبادئ Clean Architecture.
تصميم بنية الوحدة 
أحتاج إلى بناء وحدة [feature]. صمم البنية باتباع مبادئ DDD. اقترح أسماء خاصة بالنطاق للكيانات والخدمات والمستودعات. حدد حدوداً واضحة وفصلاً للاهتمامات.
العثور على حل مكتبة أفضل 
أحتاج إلى تطبيق وظيفة [feature]. ابحث عن مكتبات أو خدمات حالية تحل هذه المشكلة. قيّم الخيارات بناءً على: حالة الصيانة، اعتماد المجتمع، جودة التوثيق، والملاءمة لمتطلباتي.
إعادة هيكلة الأنماط المضادة 
حلل قاعدة الكود هذه للكشف عن الأنماط المضادة البنيوية: متلازمة NIH (تطبيقات مخصصة بدلاً من المكتبات)، أسماء ملفات عامة، فصل ضعيف للاهتمامات، وتداخل عميق. قدم توصيات إعادة هيكلة محددة مع أمثلة.

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

  • ابحث عن المكتبات والخدمات الحالية قبل كتابة كود مخصص لتقليل عبء الصيانة
  • استخدم أسماء خاصة بالنطاق مثل OrderCalculator و UserAuthenticator بدلاً من utils أو helpers العامة
  • اجعل منطق العمل مستقلاً عن الأطر ومنفصلاً عن مكونات واجهة المستخدم
  • طبق نمط الإرجاع المبكر لتقليل التداخل وتحسين قابلية قراءة الكود

تجنب

  • إنشاء ملفات utils.js أو helpers.ts تحتوي على دوال غير مرتبطة بدلاً من وحدات خاصة بالنطاق
  • خلط منطق العمل مع مكونات واجهة المستخدم أو وضع استعلامات قاعدة البيانات مباشرة في المتحكمات
  • بناء مصادقة مخصصة أو إدارة حالة أو التحقق من النماذج عندما توجد مكتبات راسخة
  • تسمية الملفات أو الوحدات بشكل عام (common، shared، misc) بدون غرض نطاق واضح

الأسئلة المتكررة

ما هي Clean Architecture؟
Clean Architecture هو نمط تصميم برمجيات يفصل الاهتمامات إلى طبقات مميزة: كيانات النطاق (قواعد العمل)، حالات الاستخدام (قواعد التطبيق)، محولات الواجهة (المتحكمات، العروض)، والأطر (واجهة المستخدم، قاعدة البيانات). هذا الاستقلال يجعل كودك قابلاً للاختبار ومرناً.
لماذا يجب تجنب ملفات utils و helpers؟
تصبح utils و helpers العامة أماكن لتفريغ كود غير مرتبط. تفتقر إلى غرض واضح وتصبح غير قابلة للصيانة. الأسماء الخاصة بالنطاق مثل OrderCalculator أو EmailValidator تنقل الغرض وتحافظ على تنظيم الكود حسب سياق العمل.
متى يجب كتابة كود مخصص بدلاً من استخدام مكتبة؟
اكتب كوداً مخصصاً فقط لمنطق العمل الفريد، المسارات الحرجة للأداء ذات الاحتياجات الخاصة، الكود الحساس للأمان الذي يتطلب تحكماً كاملاً، أو عندما لا تلبي الحلول الحالية متطلباتك حقاً بعد تقييم شامل.
ما حدود حجم الملفات الموصى بها؟
اجعل الدوال أقل من 50 سطراً عند الإمكان والملفات أقل من 200 سطر. قسّم المكونات الأطول إلى قطع أصغر مركزة. إذا كان الكود لا يمكن إعادة استخدامه في مكان آخر، احتفظ به في نفس الملف حتى يصبح التقسيم ضرورياً للصيانة.
كيف تختلف هذه المهارة عن مساعدي البرمجة العامين؟
تركز هذه المهارة تحديداً على القرارات البنيوية وتنظيم الكود بدلاً من التفاصيل النحوية أو تفاصيل التطبيق. ترشد إلى البنية عالية المستوى وأنماط التصميم وقابلية الصيانة بدلاً من كتابة خوارزميات محددة أو إصلاح أخطاء.
هل يمكنني استخدام هذه المهارة لأي لغة برمجة؟
نعم. المبادئ البنيوية (Clean Architecture، DDD، فصل الاهتمامات) تنطبق عبر جميع اللغات. ومع ذلك، تفاصيل التطبيق تختلف بين اللغات والأطر، لذا كيّف التوصيات مع حزمة التكنولوجيا المحددة الخاصة بك.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/software-architecture

مرجع

main

بنية الملفات

📄 SKILL.md