Compétences component-refactoring
📦

component-refactoring

Sûr

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

تصبح مكونات React المعقدة صعبة الاختبار والصيانة. توفر هذه المهارة أنماطاً وسير عمل لإعادة هيكلة المكونات عالية التعقيد من خلال استخراج الـ hooks وتقسيم المكونات الفرعية وتطبيق اصطلاحات Dify المحددة.

Prend en charge: Claude Codex Code(CC)
🥉 76 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 "component-refactoring". Analyze complexity of web/app/components/workflow/index.tsx

Résultat attendu:

تحليل التعقيد:
- إجمالي التعقيد: 72 (الهدف: <50)
- أقصى تعقيد للدالة: 28
- عدد الأسطر: 420 (الهدف: <300)

محركات التعقيد الرئيسية:
1. استدعاء handleSubmit: +15 تعقيد (شروط متداخلة)
2. useEffect لمزامنة البيانات: +12 تعقيد (استدعاءات متداخلة)
3. طرق العرض: +10 تعقيد (سلاسل switch/case)

الإجراءات الموصى بها:
1. استخراج useWorkflowState hook
2. تقسيم معالجة النموذج إلى مكون منفصل
3. نقل منطق مزامنة البيانات إلى useEffect hook

Utilisation de "component-refactoring". Extract hooks from ConfigurationForm component

Résultat attendu:

الـ Hooks المستخرجة:
- useModelConfig: يدير تكوين النموذج
- useDatasetSelection: يتعامل مع منطق منتقي مجموعات البيانات
- useFormValidation: منطق التحقق من النموذج

هيكل الملف:
web/app/components/form/
hooks/
use-model-config.ts
use-dataset-selection.ts
use-form-validation.ts
ConfigurationForm.tsx
index.ts

Audit de sécurité

Sûr
v1 • 2/16/2026

This is a documentation and guidance skill for React component refactoring. Static analyzer flagged 214 potential issues in markdown documentation files, all of which are false positives: backticks in code examples were detected as shell commands, code patterns triggered crypto/blocker alerts, and Object.keys() was flagged as certificate/key files. The skill provides reference documentation only and does not execute any code.

4
Fichiers analysés
1,774
Lignes analysées
0
résultats
1
Total des audits
Aucun problème de sécurité trouvé
Audité par: claude

Score de qualité

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

Ce que vous pouvez construire

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

عندما يتجاوز مكون React حد التعقيد (>50) أو عدد الأسطر (>300)، استخدم هذه المهارة لتقليل التعقيد بشكل منهجي من خلال استخراج الـ hooks وتقسيم المكونات.

توحيد أنماط الـ Hooks

تطبيق اصطلاحات Dify لتنظيم hooks المخصصة في مجلدات hooks/ الفرعية أو بجانب المكونات مع تسمية use- البادئة.

تحضير المكونات للاختبار

إعادة هيكلة المكونات المعقدة قبل كتابة الاختبارات لضمان قابلية الاختبار والالتزام بحدود التعقيد.

Essayez ces prompts

فحص التعقيد الأساسي
Check the complexity of web/app/components/example.tsx using pnpm analyze-component. What is the complexity score and what are the main complexity drivers?
خطة استخراج الـ Hooks
Analyze web/app/components/form-config/index.tsx and identify opportunities to extract custom hooks. Show me the proposed hook structure with Dify conventions.
استراتيجية تقسيم المكونات
The Configuration component at web/app/components/config/index.tsx has complexity 85. Suggest how to split it into sub-components while maintaining Dify patterns.
سير عمل إعادة الهيكلة الكامل
Run pnpm analyze-component on web/app/components/app/configuration/index.tsx and generate a complete refactoring plan including hook extractions, sub-component splits, and complexity reduction targets.

Bonnes pratiques

  • قم بتشغيل تحليل التعقيد قبل إعادة الهيكلة لإنشاء مقاييس أساسية
  • استخرج الـ hooks مبكراً عندما تتجاوز إدارة الحالة 3-5 استدعاءات useState
  • اتبع اصطلاحات التسمية في Dify: hooks في مجلد hooks/ أو بادئة use-*.ts

Éviter

  • إعادة هيكلة المكونات التي تستوفي بالفعل حدود التعقيد دون ضرورة
  • استخراج الـ hooks المستخدمة في مكون واحد فقط (يفضل السطر المضمن)
  • إنشاء太多的小组件 التي تضر التنقل في الكود

Foire aux questions

ما هو درجة التعقيد المقبولة؟
يجب أن يكون التعقيد المستهدف أقل من 50. تشير الدرجات 51-75 إلى الحاجة لإعادة الهيكلة قبل الاختبار. تتطلب الدرجات أعلى من 75 إعادة هيكلة فورية.
هل يمكنني استخدام هذه المهارة لمشاريع React غير Dify؟
نعم، تنطبق أنماط تحليل التعقيد وتقنيات استخراج الـ hooks بشكل عام على React. ومع ذلك، فإن اصطلاحات تنظيم الملفات خاصة بـ Dify.
هل تعدل هذه المهارة الكود الخاص بي تلقائياً؟
لا، توفر هذه المهارة التحليل والإرشاد. أنت تقوم بتشغيل أوامر إعادة الهيكلة المقترحة بنفسك باستخدام pnpm refactor-component في بيئتك المحلية.
ما هي الأدوات التي تستخدمها هذه المهارة؟
تشير المهارة إلى أدوات CLI الخاصة بـ Dify وهي pnpm analyze-component و pnpm refactor-component. يجب تشغيل هذه في مجلد web/ في مشروع Dify.
كيف أعرف متى أعيد الهيكلة مقابل إعادة الكتابة؟
إذا تجاوز التعقيد 75 أو كان للمكون مشاكل معمارية أساسية، فكر في إعادة الكتابة. تعمل إعادة الهيكلة بشكل أفضل عندما يحتوي المكون على منطق أعمال قيّم يستحق الحفاظ عليه.
ما هو التعقيد المعرفي؟
يقيس التعقيد المعرفي مدى صعوبة فهم الكود. يختلف عن التعقيد الدوائري من خلال التركيز على قابلية القراءة البشرية، وليس مسارات التنفيذ فقط. يحسب SonarJS ذلك بناءً على الهياكل المتداخلة وعبارات switch وأنماط تدفق التحكم.

Détails du développeur