skill

تحسين هيكلة قاعدة الأكواد

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

mattpocock1,215,298+ تثبيتموثوق

نبذة

# تحسين بنية قاعدة الكود

تحديد الاحتكاك المعماري واقتراح **فرص التعميق**: عمليات إعادة هيكلة تحول الوحدات الضحلة إلى وحدات عميقة. الهدف هو قابلية الاختبار وقابلية التنقل بواسطة الذكاء الاصطناعي.

يستند هذا الأمر إلى النموذج النطاقي للمشروع ومبني على مفردات تصميم مشتركة:

- استدع أداة 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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.

هل تحسين هيكلة قاعدة الأكواد مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في الإنتاجية والمكتب.

كل بدائل تحسين هيكلة قاعدة الأكواد ←
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/skills
البحث عن المهارات
يساعد المستخدمين على اكتشاف وتثبيت مهارات الوكلاء عندما يطرحون أسئلة مثل "كيف أفعل X؟"، "ابحث عن مهارة ل X"، "هل توجد مهارة يمكنها..."، أو يعبرون عن ا…3,611,572+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
استخدام الوسائط
احصل على أو أنشئ أي وسائط لفيديو HyperFrames - موسيقى، مؤثرات صوتية، صور، أيقونات، شعارات، تعليق صوتي، صورة رمزية (avatar) وفيديو مولد، نصوص، قصاصات،…1,260,249+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تسليم المهام
لخص المحادثة الحالية في وثيقة تسليم ليتابعها وكيل آخر.946,569+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
فرز أولي
نقل المشكلات وطلبات السحب الخارجية عبر آلة حالة لأدوار الفرز، وتصنيفها، والتحقق منها، والتدقيق فيها عند الحاجة، وكتابة ملخصات جاهزة للوكلاء.881,979+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تعليم
علم المستخدم مهارة أو مفهوما جديدا ضمن مساحة العمل هذه.778,928+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
المرشد
خطط لجزء كبير من العمل (أكبر مما يمكن أن تستوعبه جلسة وكيل واحدة) كخريطة مشتركة لتذاكر القرارات على متتبع المشكلات الخاص بك، وقم بحلها واحدة تلو الأخر…763,794+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في الإنتاجية والمكتب