skill
تحسين هيكلة قاعدة الأكواد
افحص قاعدة بيانات برمجية بحثا عن فرص للتحسين والتعميق، وقدمها كتقرير HTML مرئي، ثم تعمق في الفرصة التي تختارها.
نبذة
# تحسين بنية قاعدة الكود
تحديد الاحتكاك المعماري واقتراح **فرص التعميق**: عمليات إعادة هيكلة تحول الوحدات الضحلة إلى وحدات عميقة. الهدف هو قابلية الاختبار وقابلية التنقل بواسطة الذكاء الاصطناعي.
يستند هذا الأمر إلى النموذج النطاقي للمشروع ومبني على مفردات تصميم مشتركة:
- استدع أداة Skill باستخدام "codebase-design" للحصول على مفردات البنية (**module**، **interface**، **depth**، **seam**، **adapter**، **leverage**، **locality**) ومبادئها (اختبار الحذف، "الواجهة هي سطح الاختبار"، "محول واحد = درز افتراضي، اثنان = حقيقي"). استخدم هذه المصطلحات بالضبط في كل اقتراح، ولا تنجرف إلى "component" أو "service" أو "API" أو "boundary". - توفر لغة النطاق في `GLOSSARY.md` أسماء للدرزات الجيدة؛ وتسجل ADRs في `docs/adr/` القرارات التي يجب ألا يعيد هذا الأمر مناقشتها.
## العملية
### 1. الاستكشاف
**حدد النطاق قبل المسح: YAGNI.** يؤتي تعميق الوحدة ثماره بجعل التغييرات المستقبلية عليها أسهل، لذا أعط وزنا إضافيا للأجزاء من قاعدة الكود التي تغيرت مؤخرا. قرر *أين* تبحث قبل أن تبحث:
- إذا حدد المستخدم اتجاها (وحدة، نظام فرعي، نقطة ضعف)، فخذ به، وتخط الاستدلال أدناه. - بخلاف ذلك، ارجع إلى جزء جيد من سجل الالتزامات (`git log --oneline`) للعثور على النقاط الساخنة في قاعدة الكود، والملفات والمناطق التي تظهر باستمرار، ودع هذه المسارات تجذب انتباهك أولا. إذا كانت التغييرات متناثرة بدون نقطة ساخنة واضحة، فوسع الشبكة.
اقرأ مسرد النطاق الخاص بالمشروع (`GLOSSARY.md`) وأي ADRs في المنطقة التي تلمسها أولا.
ثم قم بتشغيل وكيل فرعي بنافذة سياق جديدة لاستكشاف قاعدة الكود. لا تتبع قواعد إرشادية صارمة؛ استكشف عضويا ولاحظ أين تواجه احتكاكا:
- أين يتطلب فهم مفهوم واحد التنقل بين العديد من الوحدات الصغيرة؟ - أين تكون الوحدات **ضحلة**، مع واجهة معقدة تقريبا مثل التنفيذ؟ - أين تم استخراج الدوال النقية فقط لغرض قابلية الاختبار، ولكن الأخطاء الحقيقية تكمن في كيفية استدعائها (لا توجد **locality**)؟ - أين تتسرب الوحدات المتصلة بإحكام عبر درزاتها؟ - ما هي أجزاء قاعدة الكود غير المختبرة، أو التي يصعب اختبارها من خلال واجهتها الحالية؟
طبق **اختبار الحذف** على أي شيء تشك في أنه ضحل: هل سيؤدي حذفه إلى تركيز التعقيد، أم مجرد نقله؟ "نعم، يركز" هي الإشارة التي تريدها.
### 2. تقديم المرشحين كتقرير HTML
اكتب ملف HTML مستقل إلى دليل الملفات المؤقتة لنظام التشغيل حتى لا يهبط شيء في المستودع. حل دليل الملفات المؤقتة من `$TMPDIR`، مع الرجوع إلى `/tmp` (أو `%TEMP%` على Windows)، واكتب إلى `<tmpdir>/architecture-review-<timestamp>.html` بحيث تحصل كل عملية تشغيل على ملف جديد. افتحه للمستخدم (`xdg-open <path>` على Linux، `open <path>` على macOS، `start <path>` على Windows) وأخبره بالمسار المطلق.
يستخدم التقرير **Tailwind عبر CDN** للتخطيط والتصميم، و **Mermaid عبر CDN** للرسوم البيانية حيث ينقل الرسم البياني/التدفق/التسلسل البنية بشكل موثوق. امزج Mermaid مع مرئيات CSS/SVG المصممة يدويا: استخدم Mermaid عندما تكون العلاقات على شكل رسم بياني (رسوم بيانية الاستدعاء، التبعيات، التسلسلات)، واستخدم divs/SVG المصممة يدويا عندما تريد شيئا أكثر تحريريا (رسوم بيانية جماعية، مقاطع عرضية، رسوم متحركة للطي). يحصل كل مرشح على **تصور قبل/بعد**. كن مرئيا.
لكل مرشح، اعرض بطاقة تحتوي على:
- **الملفات**: ما هي الملفات/الوحدات المعنية - **المشكلة**: لماذا تسبب البنية الحالية احتكاكا - **الحل**: وصف باللغة الإنجليزية البسيطة لما سيتغير - **الفوائد**: مشروحة من حيث التمركز والرافعة المالية، وكيف ستتحسن الاختبارات - **مخطط قبل / بعد**: جنبا إلى جنب، مرسوم يدويا، يوضح الضحالة والتعميق - **قوة التوصية**: إحدى القيم `Strong`، `Worth exploring`، `Speculative`، معروضة كشارة
اختتم التقرير بقسم **أهم التوصيات**: أي مرشح ستعالجه أولا ولماذا.
**استخدم مفردات GLOSSARY.md للنطاق، ومفردات `/codebase-design` للبنية.** إذا كان `GLOSSARY.md` يعرف "Order"، فتحدث عن "وحدة استلام الطلب"، وليس "FooBarHandler"، وليس "خدمة الطلب".
**تعارضات ADR**: إذا كان المرشح يتعارض مع ADR موجود، فلا تظهره إلا عندما يكون الاحتكاك حقيقيا بما يكفي لتبرير إعادة النظر في ADR. قم بتمييزه بوضوح في البطاقة (على سبيل المثال، تنبيه تحذيري: _"يتعارض مع ADR-0007، ولكن يستحق إعادة الفتح لأن..."_). لا تسرد كل عملية إعادة هيكلة نظرية يحظرها ADR.
انظر [HTML-REPORT.md](HTML-REPORT.md) للحصول على هيكل HTML الكامل وأنماط الرسم البياني وإرشادات التصميم.
لا تقترح واجهات بعد. بعد كتابة الملف، اسأل المستخدم: "أي من هذه ترغب في استكشافه؟"
### 3. حلقة الاستجواب
بمجرد أن يختار المستخدم مرشحا، استدع أداة Skill باستخدام "grilling" لتتبع شجرة القرار معهم: القيود، التبعيات، شكل الوحدة المعمقة، ما يكمن وراء الدرز، ما هي الاختبارات التي تبقى.
تحدث الآثار الجانبية بشكل مباشر مع تبلور القرارات؛ استدع أداة Skill باستخدام "domain-model
التثبيت
شغل هذا الأمر
npx skills add mattpocock/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/engineering/improve-codebase-architecture` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة تحسين هيكلة قاعدة الأكواد؟
افحص قاعدة بيانات برمجية بحثا عن فرص للتحسين والتعميق، وقدمها كتقرير HTML مرئي، ثم تعمق في الفرصة التي تختارها.
كيف أثبت تحسين هيكلة قاعدة الأكواد؟
شغل هذا الأمر في الطرفية:
npx skills add mattpocock/skillsمع أي أدوات ذكاء اصطناعي تعمل تحسين هيكلة قاعدة الأكواد؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور تحسين هيكلة قاعدة الأكواد؟
طورها mattpocock.
هل تحسين هيكلة قاعدة الأكواد مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى