ousterhout-build-deep

SKILL.md

---
name: ousterhout-build-deep
description: استخدم أثناء كتابة أو تعديل الكود، قبل اعتبار المهمة منتهية، كلما أضاف التغيير اسمًا مُصدّرًا أو قابلًا للاستيراد، أو أنشأ وحدة، أو فئة، أو مكون، أو مساعد، أو هوك، أو خدمة، أو غلاف، أو مركّزًا على الكود المتكرر. قائمة مراجعة وقت المؤلف لبناء وحدات عميقة: سمِّ القرار الذي يخفيه الحد، اجتز اختبارات العمق والثبات، أصلح المشاكل بدلاً من نقلها، لا تقسم بناءً على الحجم فقط، وأنهِ بملاحظة تصميم قصيرة. رفيق مضغوط لـ ousterhout-quality-program، الذي يظل عدسة المراجعة الكاملة.
---

# بناء عميق (أوسترهوت، وقت المؤلف)

أنت تكتب الكود، لا تراجعه. شغّل هذا على التغيير الخاص بك قبل أن تعلن المهمة منتهية.

## 1. البوابة

هل يضيف التغيير اسمًا مُصدّرًا/قابلًا للاستيراد، أو ينشئ وحدة، أو فئة، أو مكون، أو مساعد، أو هوك، أو خدمة، أو غلاف، أو يركّز الكود المكرر؟
إذا لا، تخطى هذه المهارة. إعادة التسمية، التعديلات البرمجية، تعديلات التكوين/البيانات، والإصلاحات ذات السطر الواحد معفاة.

## 2. قبل أن تكتب الحدود

- ابحث كيف يحل هذا المستودع مشكلة من هذا النوع واتبعها إلا إذا استطعت أن تبرر العكس. اقرأ الوثائق والأنواع الحالية للاعتماد: استدعاء API من الذاكرة هو ادعاء، وليس مصدرًا.
- اكتب تعليق الواجهة أولًا: ما الذي تعد به، وما الذي تخفيه. إذا لم تستطع تسمية القرار المخفي (صيغة، سياسة، قاعدة، اختيار مخطط)، فلا يجب أن توجد الحدود. اجعلها ضمنية.
- سمّها بلغة المجال. إذا كان الاسم الوحيد الصادق هو `utils`، `helpers` أو `manager`، فالقطع في المكان الخطأ.

## 3. اختباران

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

## 4. يجب أن يزيل الإصلاح المشكلة، لا أن ينقلها

- ستة تحويلات تم نقلها إلى مساعد تحويل عام لا تزال ستة تحويلات. اكتب المحول المطبّق الذي كانت التحويلات تغطيه.
- لا تضف معلمة أو علمًا يدفع القرار إلى المتصلين إلا إذا كان المتصلون يعرفون شيئًا أنت لا تعرفه. استوعب الحالة الصعبة داخليًا.
- فضّل الدلالات التي لا يمكن أن تنشأ فيها حالة الخطأ على جعل كل متصل يتعامل معها.
- نقل تعقيد المجال الأساسي إلى ملف آخر ليس تبسيطًا.

## 5. تحت ضغط "نظف هذا" أو "هذا الملف كبير جدًا"

لا تقسم بناءً على الحجم فقط. وحدة واحدة بطول 400 سطر تخفي قرارًا واحدًا أفضل من أربع وحدات بطول 100 سطر تسرب نفس الوصلات. اسأل عن القرار الذي يخفيه كل تقسيم؛ إذا لم يكن هناك، فلا تقسّم.

## 6. الأمان

الكود الموجود: ثبت السلوك الحالي باختبار قبل تعميقه. الكود الجديد: اكتب الاختبار الذي يحدد السلوك المقصود.

## 7. التقرير

إذا تم تفعيل البوابة، أنهِ رسالتك النهائية بملاحظة تصميم من 2-4 أسطر: كل حد أضفته والقرار الذي يخفيه؛ التكرار الذي تركته عمدًا ولماذا؛ أي شيء سطحي قبلته ولماذا.

لنداء متنازع عليه أو مراجعة كاملة، حمّل `ousterhout-quality-program`.

الوسوم