C4 Component Level: [Component Name]
إنشاء مخططات هندسة C4 للمكونات
هل تكافح من أجل تحويل وثائق مستوى الكود إلى هندسة مكونات واضحة؟ هذه المهارة تقوم بتحويل مخرجات C4 Code إلى مخططات على مستوى المكونات مع حدود وواجهات وعلاقات محددة.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "C4 Component Level: [Component Name]". تجميع ملفات كود المصادقة إلى مكونات
النتيجة المتوقعة:
- مكون AuthService: يتعامل مع مصادقة المستخدمين، وتوليد الرموز، وإدارة الجلسات
- مكون AuthRepository: يدير تخزين بيانات الاعتماد واسترجاعها
- مكون AuthProvider: يندمج مع مزودي الهوية الخارجيين
استخدام "C4 Component Level: [Component Name]". إنشاء مخطط مكونات لحاوية API
النتيجة المتوقعة:
- مخطط Mermaid يظهر مكونات ApiController و RequestValidator و ResponseFormatter و DatabaseConnector ضمن حدود حاوية API، مع علاقات مُسمّاة تظهر تدفق البيانات
التدقيق الأمني
آمنThis is a prompt-only documentation skill with no executable code. Static analysis scanned 0 files and found 0 potential security issues with a risk score of 0/100. The skill generates C4 architecture component documentation and Mermaid diagrams without accessing external systems, executing commands, or handling sensitive data.
درجة الجودة
ماذا يمكنك بناءه
توثيق الهندسة المعمارية للأنظمة الجديدة
تحويل وثائق الكود المتناثرة إلى مخططات هندسة مكونات متماسكة للأنظمة الجديدة أو المعاد هيكلتها.
تحديد حدود المكونات
تحديد حدود واضحة بين مكونات المصادقة والوصول إلى البيانات ومنطق الأعمال أثناء إعادة تصميم النظام.
توثيق الاندماج
توليد توثيق شامل للمكونات لمساعدة أعضاء الفريق الجدد على فهم هندسة النظام بسرعة.
جرّب هذه الموجهات
إنشاء توثيق C4 Component لـ [Component Name]. الغرض: [وصف موجز]. التكنولوجيا الأساسية: [tech stack]. اذكر 3-5 ميزات رئيسية وحدد 2-3 واجهات رئيسية.
توليد مخطط Mermaid C4Component لـ [Container Name]. ضمّن المكونات: [قائمة المكونات]، وأنواعها، وأوصافها، وأظهر العلاقات بينها وبين أي أنظمة خارجية.
توثيق جميع الواجهات لمكون [Component Name]. حدد لكل واجهة: البروتوكول (REST/GraphQL/gRPC/Events)، ووصف ما تقدمه، وقائمة جميع العمليات مع توقيعاتها وأنواع الإرجاع.
تجميع ملفات C4 Code التالية في توثيق على مستوى المكونات: [قائمة الملفات]. قدم لكل مكون ناتج: الاسم، الوصف، النوع، التكنولوجيا، الغرض، الميزات، عناصر الكود، الواجهات، التبعيات، ومخطط Mermaid للمكونات.
أفضل الممارسات
- حافظ على تركيز المكونات على مسؤولية واحدة أو سياق محدد
- وثق كل من الواجهات المقدمة والتبعيات المستهلكة لكل مكون
- استخدم اتفاقيات تسمية متسقة تعكس غرض المكون ونوعه
تجنب
- إنشاء مكونات دقيقة للغاية (فئة واحدة لكل مكون)
- إغفال بروتوكولات الواجهات مما يجعل التكامل غير واضح
- إظهار علاقات على مستوى الحاوية بدلاً من التفاصيل على مستوى المكونات