skill
تصميم قاعدة الكود
مفردات مشتركة لتصميم الوحدات العميقة. تستخدم عندما يرغب المستخدم في تصميم أو تحسين واجهة وحدة نمطية، أو إيجاد فرص للتعميق، أو تحديد مكان الفصل، أو جعل الكود أكثر قابلية للاختبار أو التنقل بواسطة الذكاء الاصطناعي، أو عندما تحتاج مهارة أخرى إلى مفردات الوحدة العميقة.
نبذة
# تصميم قاعدة الكود
صمم **وحدات عميقة (deep modules)**: الكثير من السلوك خلف واجهة صغيرة، توضع عند نقطة فصل واضحة (clean seam)، وقابلة للاختبار من خلال تلك الواجهة. استخدم هذه اللغة وهذه المبادئ أينما يتم تصميم الكود أو إعادة هيكلته. الهدف هو تحقيق الفائدة للمستدعين (callers)، والتمركز للمطورين (maintainers)، وقابلية الاختبار للجميع.
## مسرد المصطلحات
استخدم هذه المصطلحات بدقة: لا تستبدلها ب "component" أو "service" أو "API" أو "boundary". الاتساق في اللغة هو الهدف الأساسي.
**الوحدة (Module)**: أي شيء له واجهة وتطبيق. مصمم ليكون مستقلا عن الحجم: يمكن أن يكون دالة، أو صنفا، أو حزمة، أو شريحة تمتد عبر طبقات. _تجنب_: unit, component, service.
**الواجهة (Interface)**: كل ما يجب أن يعرفه المستدعي لاستخدام الوحدة بشكل صحيح: توقيع النوع (type signature)، وأيضا الثوابت (invariants)، وقيود الترتيب (ordering constraints)، وأنماط الأخطاء (error modes)، والتكوين المطلوب (required configuration)، وخصائص الأداء (performance characteristics). _تجنب_: API, signature (ضيقة جدا، تشير فقط إلى السطح على مستوى النوع).
**التطبيق (Implementation)**: ما بداخل الوحدة، وهو جسم الكود الخاص بها. يختلف عن **المحول (Adapter)**: يمكن أن يكون الشيء محولا صغيرا بتطبيق كبير (مستودع Postgres) أو محولا كبيرا بتطبيق صغير (محاكاة في الذاكرة). استخدم "adapter" عندما تكون نقطة الفصل هي الموضوع؛ و"implementation" بخلاف ذلك.
**العمق (Depth)**: الفائدة عند الواجهة. مقدار السلوك الذي يمكن للمستدعي (أو الاختبار) ممارسته لكل وحدة من الواجهة التي يتعين عليه تعلمها. الوحدة تكون **عميقة (deep)** عندما يكون هناك قدر كبير من السلوك خلف واجهة صغيرة، و**ضحلة (shallow)** عندما تكون الواجهة معقدة تقريبا مثل التطبيق.
**نقطة الفصل (Seam)** _(مايكل فيذرز)_: مكان يمكنك فيه تغيير السلوك دون التعديل في ذلك المكان؛ وهو *الموقع* الذي توجد فيه واجهة الوحدة. تحديد مكان نقطة الفصل هو قرار تصميمي بحد ذاته، يختلف عما يوضع خلفها. _تجنب_: boundary (مثقلة بالمعنى في سياق DDD's bounded context).
**المحول (Adapter)**: شيء ملموس يحقق واجهة عند نقطة فصل. يصف *الدور* (ما هي الفتحة التي يملأها)، وليس الجوهر (ما بداخله).
**الفائدة (Leverage)**: ما يحصل عليه المستدعون من العمق. قدرة أكبر لكل وحدة من الواجهة التي يتعلمونها. تطبيق واحد يعود بالفائدة عبر N موقع استدعاء و M اختبار.
**التمركز (Locality)**: ما يحصل عليه المطورون من العمق. تتمركز التغييرات والأخطاء والمعرفة والتحقق في مكان واحد بدلا من الانتشار عبر المستدعين. إصلاح مرة واحدة، يتم إصلاحه في كل مكان.
## عميق مقابل ضحل
**وحدة عميقة (Deep module)** = واجهة صغيرة + الكثير من التطبيق:
``` ┌─────────────────────┐ │ Small Interface │ ← Few methods, simple params ├─────────────────────┤ │ │ │ Deep Implementation│ ← Complex logic hidden │ │ └─────────────────────┘ ```
**وحدة ضحلة (Shallow module)** = واجهة كبيرة + القليل من التطبيق (تجنب):
``` ┌─────────────────────────────────┐ │ Large Interface │ ← Many methods, complex params ├─────────────────────────────────┤ │ Thin Implementation │ ← Just passes through └─────────────────────────────────┘ ```
عند تصميم واجهة، اسأل:
- هل يمكنني تقليل عدد الطرق (methods)؟ - هل يمكنني تبسيط المعلمات (parameters)؟ - هل يمكنني إخفاء المزيد من التعقيد بالداخل؟
## المبادئ
- **العمق هو خاصية للواجهة، وليس للتطبيق.** يمكن أن تتكون الوحدة العميقة داخليا من أجزاء صغيرة، قابلة للمحاكاة (mockable)، وقابلة للتبديل (swappable)؛ لكنها ليست جزءا من الواجهة. يمكن أن تحتوي الوحدة على **نقاط فصل داخلية (internal seams)** (خاصة بتطبيقها، وتستخدمها اختباراتها الخاصة) بالإضافة إلى **نقطة الفصل الخارجية (external seam)** عند واجهتها. - **اختبار الحذف.** تخيل حذف الوحدة. إذا اختفى التعقيد، فقد كانت مجرد تمرير. إذا ظهر التعقيد مرة أخرى عبر N مستدع، فقد كانت تؤدي دورها. - **الواجهة هي سطح الاختبار.** المستدعون والاختبارات يعبرون نفس نقطة الفصل. إذا كنت ترغب في الاختبار *ما وراء* الواجهة، فمن المحتمل أن شكل الوحدة خاطئ. - **محول واحد يعني نقطة فصل افتراضية. محولان يعني نقطة فصل حقيقية.** لا تقدم نقطة فصل إلا إذا كان هناك شيء يتغير بالفعل عبرها.
## التصميم من أجل قابلية الاختبار
الواجهات الجيدة تجعل الاختبار طبيعيا:
1. **تقبل التبعيات، لا تنشئها.**
```typescript // Testable function processOrder(order, paymentGateway) {}
// Hard to test function processOrder(order) { const gateway = new StripeGateway(); } ```
2. **إرجاع النتائج، لا تنتج آثارا جانبية.**
```typescript // Testable function calculateDiscount(cart): Discount {}
// Hard to test function applyDiscount(cart): void { cart.total -= discount; } ```
3. **مساحة سطح صغيرة.** عدد أقل من الطرق = عدد أقل من الاختبارات المطلوبة. عدد أقل من المعلمات = إعداد اختبار أبسط.
## العلاقات
- تحتوي **الوحدة (Module)** على واجهة واحدة بالضبط (السطح الذي تقدمه للمستدعين والاختبارات). - **العمق (Depth)** هو خاصية للوحدة، ويقاس مقابل واجهتها. - **نقطة الفصل (Seam)** هي المكان الذي توجد فيه واجهة الوحدة. - **المحول (Adapter)** يجلس عند نقطة فصل ويحقق الواجهة. - ينتج **العمق (Depth)** **فائدة (Leverage)** للمستدعين و**تمركزا (Locality)** للمطورين.
## الأطر المرفوضة
- **العمق كنسبة من التطبيق**
التثبيت
شغل هذا الأمر
npx skills add mattpocock/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/engineering/codebase-design` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة تصميم قاعدة الكود؟
مفردات مشتركة لتصميم الوحدات العميقة. تستخدم عندما يرغب المستخدم في تصميم أو تحسين واجهة وحدة نمطية، أو إيجاد فرص للتعميق، أو تحديد مكان الفصل، أو جعل الكود أكثر قابلية للاختبار أو التنقل بواسطة الذكاء الاصطناعي، أو عندما تحتاج مهارة أخرى إلى مفردات الوحدة العميقة.
كيف أثبت تصميم قاعدة الكود؟
شغل هذا الأمر في الطرفية:
npx skills add mattpocock/skillsمع أي أدوات ذكاء اصطناعي تعمل تصميم قاعدة الكود؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور تصميم قاعدة الكود؟
طورها mattpocock.
هل تصميم قاعدة الكود مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add mattpocock/skills
npx skills add vercel-labs/agent-browser
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add designed-by-ai/skills
npx skills add vercel-labs/agent-skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى