Compétences code-refactoring-tech-debt
🔧

code-refactoring-tech-debt

Sûr

تحليل وإصلاح الديون التقنية

تحديد وقياس الديون التقنية التي تبطئ عملية التطوير. احصل على خطط معالجة قابلة للتنفيذ مع توقعات العائد على الاستثمار (ROI) لتحديد أولويات التحسينات التي تعظم إنتاجية الفريق.

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-tech-debt". تحليل خدمة الدفع الخاصة بنا بحثًا عن الديون التقنية

Résultat attendu:

## تحليل الديون التقنية لخدمة الدفع

### المشاكل الحرجة المكتشفة:
1. God Class: PaymentService.java (847 سطر، 32 طريقة)
2. منطق تحقق مكرر في 5 متحكمات
3. لا توجد اختبارات تكامل لسير عمل استرداد الأموال
4. استعلامات قاعدة بيانات مباشرة بدون طبقة تجريد

### تقييم التأثير:
- خسارة السرعة الشهرية: 35 ساعة
- معدل الأخطاء: 4 أخطاء إنتاج/شهر (بمتوسط 12 ساعة لكل منها)
- التكلفة السنوية: 58,800 دولار

### المكاسب السريعة (الأسبوع 1-2):
1. استخراج التحقق إلى وحدة مشتركة - توفر 20 ساعة/شهر
2. إضافة اختبارات لسير عمل استرداد الأموال - تمنع خطأين/شهر

### المدى المتوسط (الشهر 2-3):
إعادة هيكلة PaymentService إلى 4 خدمات مركزة - تقلل وقت الصيانة بنسبة 50%

Utilisation de "code-refactoring-tech-debt". إنشاء لوحة مقاييس لقاعدة الكود الخاصة بنا

Résultat attendu:

## لوحة مقاييس جودة الكود

### الحالة الحالية:
- تعقيد دوراتي: 15.2 (الهدف: 10) - 45 ملفًا فوق العتبة
- تكرار الكود: 23% (الهدف: 5%) - النقاط الساخنة: التحقق (850 سطر)، المعالجات (620 سطر)
- تغطية الاختبار: الوحدة 45%، التكامل 12%، E2E 5% (الهدف: 80/60/30)
- صحة التبعيات: 12 إصدار رئيسي قديم، 7 ثغرات أمنية

### تحليل الاتجاه:
- Q1: 750 بند دين → Q2: 820 → Q3: 890 (نمو ربع سنوي 18%)
- التوقع: 1,200 بند بحلول Q1 2025 بدون تدخل

### توزيع المخاطر:
- حرج: 3 ثغرات أمنية
- عالي: 8 نقاط ساخنة للأداء
- متوسط: 42 مشكلة تعقيد
- منخفض: 156 بند أسلوب/كفاءة

Audit de sécurité

Sûr
v1 • 2/25/2026

Static analysis detected 30 potential issues (external commands, weak crypto, system reconnaissance) but all are false positives from markdown code examples and documentation text. No executable code, network requests, or security threats found. The skill contains only documentation about technical debt analysis with code block examples.

1
Fichiers analysés
389
Lignes analysées
1
résultats
1
Total des audits
Problèmes à risque faible (1)
SKILL.md:106-114SKILL.md:117-127SKILL.md:140-165SKILL.md:168-176SKILL.md:184-199SKILL.md:202-218SKILL.md:221-237SKILL.md:242-268SKILL.md:271-284SKILL.md:291-306SKILL.md:309-319SKILL.md:324-341
Markdown Code Examples Detected
Static scanner flagged 25 instances of backtick-enclosed code blocks as 'external_commands'. These are documentation examples (YAML, Python code snippets) within the markdown file, not executable commands. No injection risk exists as these are static text examples.
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

تقييم قاعدة الكود القديمة

ترث فرق التطوير مشاريع قديمة مع ديون تقنية متراكمة وتحتاج إلى تحليل شامل لفهم المشاكل الموجودة وتأثيرها على سرعة الإنجاز وخطة ذات أولوية للتحسينات.

تحديد أولويات الديون التقنية

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

تخطيط إعادة الهيكلة

يحتاج المطورون الذين يخططون لجهود إعادة هيكلة كبرى إلى منهجيات منظمة لتقسيم التغييرات الكبيرة إلى خطوات تدريجية وقياس التقدم ومنع إدخال ديون جديدة أثناء العملية.

Essayez ces prompts

فحص سريع للديون 
افحص قاعدة الكود هذه بحثًا عن مشاكل الديون التقنية. ركز على تكرار الكود والدوال عالية التعقيد والاختبارات المفقودة. قدم ملخصًا لأهم 10 مشاكل مع مواقعها.
تحليل شامل 
قم بإجراء جرد كامل للديون التقنية يغطي دين الكود ودين الهندسة المعمارية وثغرات الاختبار ومشاكل التوثيق. احسب التكلفة السنوية لكل فئة وأنشئ خطة معالجة ذات أولوية مع مكاسب سريعة.
تحليل متعمق لمكون محدد 
حلل [المكون/الخدمة] بحثًا عن الديون التقنية. حدد النقاط الساخنة للتعقيد ومشاكل الاقتران وثغرات تغطية الاختبار. اقترح استراتيجية إعادة هيكلة مع خطوات تطبيق تدريجية.
خطة علاجية 
أنشئ خطة علاجية ربع سنوية بناءً على الديون التقنية الموجودة. ضمّن المكاسب السريعة (1-2 أسبوع) والتحسينات متوسطة المدى (1-3 أشهر) والمبادرات طويلة المدى (3-6 أشهر) مع توقعات العائد على الاستثمار لكل منها.

Bonnes pratiques

  • دائمًا ضمّن تغطية الاختبار عند إعادة الهيكلة - اكتب الاختبارات أولاً (TDD) لمنع التراجع
  • استخدم أعلام الميزات للطرح التدريجي للكود المعاد هيكلته لتمكين التراجع السريع
  • وثق قرارات الهندسة المعمارية (ADRs) لشرح سبب إجراء التغييرات للمسؤولين المستقبليين

Éviter

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

Foire aux questions

ما أنواع الديون التقنية التي يمكن لهذه المهارة اكتشافها؟
تحدد المهارة دين الكود (التكرار، التعقيد، الهيكل الضعيف)، دين الهندسة المعمارية (عيوب التصميم، التبعيات القديمة)، دين الاختبار (ثغرات التغطية، الاختبارات الهشة)، دين التوثيق، ودين البنية التحتية (مشاكل النشر، المراقبة المفقودة).
ما مدى دقة توقعات العائد على الاستثمار؟
توقعات العائد على الاستثمار هي تقديرات بناءً على تكاليف التطوير النموذجية (مثل 150 دولار/ساعة) ومتوسطات الصناعة لأوقات إصلاح الأخطاء. استخدمها كمقارنات نسبية بين بنود الديون بدلاً من التوقعات المطلقة. اضبط افتراضات التكلفة لتتناسب مع معدلات فريقك الفعلية.
هل يمكن لهذه المهارة إصلاح الديون التقنية التي تجدها تلقائيًا؟
لا، هذه المهامة تحلل وتخطط ولكنها لا تنفذ التغييرات. توفر استراتيجيات إعادة هيكلة مفصلة وأمثلة كود وإرشادات تطبيق يمكنك أنت أو فريقك تطبيقها. للحصول على إصلاحات آلية، ابحث في أدوات إعادة الهيكلة المخصصة.
كيف أحدد أولويات الديون التقنية التي يجب معالجتها أولاً؟
ركز على المكاسب السريعة (قيمة عالية، جهد منخفض) التي توفر تحسينات فورية في السرعة. ثم عالج البنود ذات أعلى تكلفة سنوية محسوبة. ضع في الاعتبار مستوى المخاطرة أيضًا - يجب تحديد أولوية المشاكل الأمنية الحرجة حتى لو كان العائد على الاستثمار أقل. توفر المهامة خطة مرتبة بناءً على هذه العوامل.
ما الفرق بين هذا وأدوات التحليل الثابت مثل SonarQube؟
توفر أدوات التحليل الثابت فحوصات آلية مع كشف قائم على القواعد. تقدم هذه المهامة تحليلًا دلاليًا وفهمًا سياقيًا وتخطيطًا استراتيجيًا. يمكنها تفسير النتائج وحساب تأثير العمل وإنشاء خطط علاجية مقروءة بشريًا. استخدم كلاهما معًا: الأدوات للفحص، وهذه المهامة للتحليل والتخطيط.
كم مرة يجب إجراء تحليل الديون التقنية؟
قم بتشغيل تحليل كامل ربع سنويًا لتتبع التقدم وتحديد الديون الجديدة. قم بإجراء فحوصات موجهة قبل جهود إعادة الهيكلة الرئيسية أو عندما تنخفض السرعة بشكل ملحوظ. أنشئ مراقبة مستمرة مع بوابات جودة آلية (خطافات ما قبل الالتزام، فحوصات CI) لاكتشاف الديون مبكرًا كما هو موضح في استراتيجية الوقاية.

Détails du développeur

Auteur

sickn33

Licence

MIT

Dépôt

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/code-refactoring-tech-debt

Réf

main

Structure de fichiers

📄 SKILL.md