codebase-cleanup-refactor-clean
إعادة هيكلة الكود لنظافة معمارية وفق مبادئ SOLID
هل تعاني من الديون التقنية، والكود المكرر، والأنظمة صيانة الصيانة؟ تطبق هذه المهارة أنماط إعادة الهيكلة المُثبتة ومبادئ SOLID لتحويل قواعد الكود الفوضوية إلى معماريات نظيفة، ومعيارية، وقابلة للاختبار.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "codebase-cleanup-refactor-clean". أعد هيكلة فئة OrderProcessor المكونة من 200 سطر والتي تتعامل مع التحقق من الصحة، والدفع، والشحن، وإشعارات البريد الإلكتروني في طريقة واحدة.
النتيجة المتوقعة:
تم الفصل إلى 5 فئات مركزة: OrderValidator، وPaymentService، وShippingCalculator، وEmailNotificationService، وOrderOrchestrator. تم تقليل تعقيد الطريقة من 45 إلى 8 لكل طريقة. تمت إضافة 18 اختبار وحدة بتغطية 92%.
استخدام "codebase-cleanup-refactor-clean". قاعدة الكود الخاصة بنا بها 30% تكرار، خاصة في معالجة الأخطاء واستعلامات قاعدة البيانات عبر الخدمات.
النتيجة المتوقعة:
تم استخراج معالجة الأخطاء الشائعة إلى BaseExceptionHandler مع 6 أنواع مخصصة من الاستثناءات. تم إنشاء GenericRepository مع عمليات CRUD. تم القضاء على 28% من التكرار، وتقليل قاعدة الكود بمقدار 1400 سطر مع الحفاظ على الوظائف.
التدقيق الأمني
آمنAll 89 static analysis findings are false positives. The skill contains only markdown documentation with code examples for educational purposes. Detected patterns (backticks, file operations, network references) are part of fenced code blocks demonstrating refactoring concepts in Python, TypeScript, Go, and Java. No executable code, prompt injection attempts, or malicious patterns found. Safe for publication.
درجة الجودة
ماذا يمكنك بناءه
تحديث الرتابة القديمة
تحويل وظائف رتيبة بطول 500 سطر إلى معمارية نظيفة ومعيارية مع فصل الاهتمامات للتحقق من الصحة، ومنطق الأعمال، والوصول إلى البيانات.
سباق تنظيف الديون التقنية
القضاء المنهجي على تكرار الكود، واستخراج الأرقام السحرية إلى ثوابت، وتطبيق مبادئ SOLID عبر الوحدات عالية الخطورة والتي يتم تعديلها بشكل متكرر.
مراجعة المعمارية قبل الميزة
تقييم جودة قاعدة الكود قبل العمل على الميزات الرئيسية، وتحديد فرص إعادة الهيكلة التي من شأنها تقليل مخاطر التنفيذ وتحسين قابلية التوسع.
جرّب هذه الموجهات
راجع قاعدة الكود الحالية للبحث عن روائح الكود والفرص السريعة. حدد الأرقام السحرية، وحسن أسماء المتغيرات، واحذف الكود الميت، واستخرج أي كود مكرر إلى وظائف قابلة لإعادة الاستخدام.
حلل هذا الكود للبحث عن انتهاكات SOLID. أعد الهيكلة لتتبع مبادئ المسؤولية الواحدة، والمفتوح/المغلق، واستبدال Liskov، وفصل الواجهة، وعكس الاعتمادية. اعرض مقارنات قبل/بعد.
قسم هذا النظام الرتيب إلى طبقات نظيفة: كيانات المجال، والمستودعات، والخدمات، وأدوات التحقق من الصحة. طبق حقن الاعتمادية وافصل الاهتمامات تمامًا. ولد اختبارات شاملة.
دقق قاعدة الكود بالكامل وقم بأولوية الديون التقنية حسب تأثير الأعمال والمخاطر. قدم خريطة طريق لإعادة الهيكلة مع تقديرات الجهد، وتحليل العائد على الاستثمار، وجدولة السباقات الموصى بها.
أفضل الممارسات
- اقرأ الكود الموجود دائمًا قبل اقتراح التغييرات لفهم السياق ومنطق الأعمال
- ابدأ بإعادة الهيكلة عالية التأثير ومنخفضة الجهد مثل استخراج الأرقام السحرية وتحسين الأسماء
- ولد اختبارات شاملة قبل إعادة الهيكلة لضمان حفظ السلوك
- قسم إعادة الهيكلة الكبيرة إلى التزامات صغيرة قابلة للمراجعة يمكن اختبارها بشكل مستقل
تجنب
- تجنب إعادة كتابة وحدات كاملة من الصفر دون فهم المتطلبات الموجودة
- لا تطبق أنماط التصميم في كل مكان - استخدمها فقط عندما تحل مشاكل فعلية
- لا تعيد الهيكلة أبدًا بدون اختبارات أو آلية للتحقق من التكافؤ الوظيفي
- لا تغير اهتمامات متعددة غير ذات صلة في تكرار إعادة هيكلة واحد