Compétences code-refactoring-refactor-clean
🔧

code-refactoring-refactor-clean

Sûr

إعادة هيكلة وتنظيف الكود باستخدام مبادئ SOLID

حوّل الكود المعقّد وصعب الصيانة إلى بنية معيارية نظيفة باستخدام أنماط إعادة الهيكلة المُثبتة ومبادئ التصميم SOLID. توفر هذه المهارة إرشادات خبيرة لتحديد روائح الكود، وتطبيق أنماط التصميم، وتنفيذ تحسينات تدريجية تعزز جودة الكود دون كسر الوظيفة.

Prend en charge: Claude Codex Code(CC)
🥉 74 Bronze
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "code-refactoring-refactor-clean". حلل فئة OrderSystem المكونة من 500 سطر للكشف عن روائح الكود واقترح تحسينات

Résultat attendu:

ملخص التحليل: تم العثور على انتهاكات SRP (تحقق، قاعدة بيانات، بريد إلكتروني، سجلات مختلطة)، تعقيد دوراني 45، تغطية اختبار 0%. خطة إعادة الهيكلة: 1) استخراج التحقق إلى OrderValidator (2 ساعة)، 2) إنشاء نمط Repository للوصول إلى البيانات (4 ساعات)، 3) تطبيق حقن التبعيات (3 ساعات). الجهد المقدّر: 9 ساعات، المخاطر: متوسطة (توجد بعض الاختبارات).

Utilisation de "code-refactoring-refactor-clean". أعد هيكلة هذه الدالة لاتباع مبادئ SOLID

Résultat attendu:

الكود المُعاد هيكلته: تقسيم UserManager إلى 5 فئات (UserValidator, UserRepository, EmailService, UserActivityLogger, UserService) كل منها بمسؤولية واحدة. تم تطبيق Dependency Injection للاقتران الضعيف. النتيجة: 15 سطر لكل دالة (في المتوسط)، التعقيد انخفض من 25 إلى 4، تغطية الاختبار زادت إلى 92%.

Utilisation de "code-refactoring-refactor-clean". طبّق أنماط التصميم على منطق حساب الخصم هذا

Résultat attendu:

تم تطبيق نمط Strategy: تم إنشاء واجهة DiscountStrategy مع تطبيقات PercentageDiscount وFixedDiscount وTieredDiscount. يقبل DiscountCalculator الآن كائنات الاستراتيجية، مما يلغي المنطق الشرطي. الفوائد: الأنواع الجديدة من الخصومات تتطلب 0 تغييرات على الكود الحالي (مبدأ Open/Closed)، إمكانية الاختبار تحسنت 100%.

Audit de sécurité

Sûr
v1 • 2/25/2026

All 90 static analysis findings are false positives. The detected patterns appear in markdown documentation files as educational code examples demonstrating refactoring patterns. The skill contains no executable code - only AI prompts and documentation. All patterns (backtick execution, email operations, file access, weak crypto references, reconnaissance commands) are within code blocks in implementation-playbook.md as teaching examples for proper refactoring. No security risks exist.

2
Fichiers analysés
934
Lignes analysées
1
résultats
1
Total des audits
Problèmes à risque faible (1)
False Positive: Educational Code Examples in Documentation
Static analyzer detected 90 potential security patterns (backtick execution, network operations, file access, etc.) but these all appear in markdown code blocks as educational examples. The implementation-playbook.md file contains before/after code samples demonstrating refactoring patterns - these are not executable code. Examples include Ruby backtick patterns (lines showing shell command examples in documentation), email sending code (teaching patterns for separating concerns), and file operations (demonstrating proper logging abstraction). These are documentation strings, not runtime code.
Audité par: claude

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
50
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

تحديث الكود القديم

تحويل التطبيقات الأحادية القديمة إلى بنية نظيفة ومعيارية تتبع مبادئ SOLID وأنماط التصميم الحديثة

تحسينات مراجعة الكود

تحديد وإصلاح روائح الكود، وتقليل التعقيد، وتحسين إمكانية الصيانة خلال مراجعات طلبات السحب

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

تعلم أنماط إعادة الهيكلة ومبادئ الكود النظيف من خلال أمثلة عملية وأدلة ترحيل خطوة بخطوة

Essayez ces prompts

طلب إعادة هيكلة بسيط
أعد هيكلة هذا الكود لتحسين إمكانية القراءة وتقليل التكرار
تحليل الكود الشامل
حلل هذا الكود للكشف عن روائح الكود، وانتهاكات SOLID، والدّين التقني. قدّم خطة إعادة هيكلة ذات أولوية.
تطبيق نمط التصميم
طبّق أنماط التصميم المناسبة لإعادة هيكلة هذا الكود متبعًا مبادئ SOLID. اعرض مقارنة قبل/بعد.
إعادة هيكلة كاملة مع الاختبارات
أعد هيكلة هذا الكود بالكامل بما في ذلك إنشاء مجموعة الاختبارات، ودليل الترحيل، وتقرير المقاييس الذي يوضح التحسينات

Bonnes pratiques

  • قم دائمًا بتشغيل الاختبارات الموجودة قبل وبعد إعادة الهيكلة لضمان الحفاظ على السلوك
  • طبّق إعادة الهيكلة في خطوات صغيرة تدريجية بدلاً من إعادة الكتابة واسعة النطاق
  • استخدم ملف implementation-playbook.md كمرجع للأنماط والأمثلة التفصيلية

Éviter

  • لا تُعد الهيكلة بدون اختبارات - أنشئ تغطية اختبارية أولاً دائمًا
  • تجنّب الإفراط في الهندسة للحلول البسيطة - YAGNI (لن تحتاج إليها)
  • لا تُغيّر السلوك الخارجي دون موافقة صريحة من أصحاب المصلحة

Foire aux questions

هل ستكسر إعادة الهيكلة الكود الحالي لدي؟
لا، عند القيام بذلك بشكل صحيح. تؤكد هذه المهارة على الحفاظ على السلوك الخارجي مع تحسين البنية الداخلية. قم دائمًا بتشغيل الاختبارات قبل وبعد إعادة الهيكلة للتحقق من بقاء السلوك دون تغيير.
كيف أعرف إذا كان الكود يحتاج إلى إعادة هيكلة؟
ابحث عن روائح الكود: دوال طويلة (>20 سطرًا)، فئات كبيرة (>200 سطر)، تعقيد دوراني مرتفع (>10)، كود مكرر، تسمية ضعيفة، أو صعوبة الاختبار. يمكن لهذه المهارة تحليل الكود الخاص بك وتحديد هذه المشاكل تلقائيًا.
هل يمكن لهذه المهيرة إعادة هيكلة الكود الخاص بي تلقائيًا؟
توفر المهيرة إرشادات لإعادة الهيكلة وتولّد أمثلة كود مُعاد هيكلته، لكن يجب عليك مراجعة وتطبيق التغييرات يدويًا. تتطلب إعادة الهيكلة الآلية إشرافًا بشريًا للتحقق من منطق الأعمال وقيود المجال المحددة.
ما هي مبادئ SOLID؟
SOLID هو اختصار لخمسة مبادئ تصميم: المسؤولية الواحدة، مفتوح/مغلق، استبدال Liskov، فصل الواجهة، وقلب التبعيات. تساعد هذه المبادئ في إنشاء بنية برمجيات قابلة للصيانة ومرنة وقابلة للتوسع.
هل يجب إعادة هيكلة كل الكود دفعة واحدة؟
لا. أعد الهيكلة تدريجيًا باستخدام قاعدة الكشّاف: اترك الكود أنظف مما وجدته. أعطِ الأولوية للتغييرات عالية التأثير ومنخفضة الجهد أولاً. توفر المهيرة تحليل العائد على الاستثمار للمساعدة في تحديد أولويات جهود إعادة الهيكلة.
كيف أقنع فريقي بإعادة الهيكلة؟
ركّز على قيمة الأعمال: تقليل الأخطاء، تسريع تطوير الميزات، تسهيل التأهيل، وخفض تكاليف الصيانة. استخدم تقرير المقاييس الخاص بالمهيرة لعرض مقارنات قبل/بعد توضح تحسينات ملموسة في جودة الكود وإمكانية الاختبار.

Détails du développeur

Structure de fichiers