نصائح ذهبية — هذا كل ما تحتاج معرفته
أكبر مشكلة عند أمر الوكيل بتعديل الكود هي ملف واحد فيه 20 دالة. تحتاج دالة واحدة فتفتح ملفاً ومعه 19 دالة غير ضرورية. هذا يخفض أداء الوكيل 30~85%.
الحل في ثلاث عبارات. يدعم Go, TypeScript, Python.
للوكيل: “جد أطول ملف وافصل كل دالة في ملف مستقل. اسم الملف = اسم الدالة. الاختبارات الحالية يجب أن تنجح كلها.”
للوكيل: “شغّل filefunc validate وأوصل المخالفات لصفر. الاختبارات الحالية يجب أن تنجح كلها.”
للوكيل: “كرر tsma next لإضافة اختبار لكل دالة. الفروع غير المغطاة أضف لها اختبارات أيضاً. حتى All functions complete.”
filefunc — ملف واحد، مفهوم واحد
المبدأ الوحيد: ملف واحد لمفهوم واحد. اسم الملف = اسم المفهوم.
# بدون filefunc
read utils.go → 20 دالة، 19 غير ضرورية. تلوث سياق.
# مع filefunc
read check_one_file_one_func.go → دالة واحدة. بالضبط ما تحتاجه.
ثُبت في Hono (23k+ نجمة): 186 ملف تقسّمت إلى 626. 4,419 اختبار لم ينكسر واحد.
22 قاعدة تحقق — لا تحتاج لحفظها
filefunc validate تجد كل المخالفات. الوكيل يصلحها. أنت تطلب “أوصل المخالفات لصفر.”
tsma — خط دفاع الانحدار
6 أسطر تعليمات للوكيل:
1. شغّل tsma next
2. إذا TODO — اقرأ الدالة واكتب اختبار
3. إذا فشل — اقرأ الخطأ وعدّل الاختبار
4. إذا ظهرت فروع غير مغطاة — أضف اختبار لتلك الفروع
5. إذا PASS/DONE — الدالة التالية تظهر تلقائياً
6. كرر حتى "All functions complete!"
4 شروط لـ Agent Operable Codebase
| الشرط | الأداة | الأثر |
|---|---|---|
| 1. ملف واحد لمفهوم واحد | filefunc | منع تلوث السياق |
| 2. اختبار لكل دالة | tsma | كشف الانحدار بعد التعديل |
| 3. ربط بمراجع رمزية | operationId (yongol) | تتبع بين الطبقات |
| 4. إزالة الترابط الضمني | whyso coupling | كشف التبعيات المخفية |
رسالة الدرس 8: لا تجعل القطار أسرع. امدد السكة.
مقالات ذات صلة
سلسلة دروس Reins Engineering الكاملة
| الدرس | العنوان |
|---|---|
| الدرس 1 | كيف تأمر الذكاء الاصطناعي |
| الدرس 2 | كيف لا تثق بالذكاء الاصطناعي |
| الدرس 3 | التطبيق الذي لا ينكسر |
| الدرس 4 | القرارات خارج الكود |
| الدرس 5 | ذكاء اصطناعي بلجام |
| الدرس 6 | إذا نجح أقفله |
| الدرس 7 | كيف تعكس التملق |
| الدرس 8 | مصنع الوكيل |
| الدرس 9 | الأتمتة ما بعد الكود |
| الدرس 10 | قانون البيانات |
مصادر الأدلة
- Stanford, “Lost in the Middle” (2024) — انخفاض 30%+ عند دفن المعلومات في منتصف السياق
- Amazon, “Context Length Alone Hurts LLM Performance” (2025) — انخفاض 13.9~85% حتى مع توكنات فارغة
- نظرية Bohm-Jacopini (1966) — كل برنامج = تسلسل + فرع + تكرار
- إثبات Hono — 186 ملف → 626 ملف، 4,419 اختبار كلها نجحت
- إثبات tsma 527 دالة — PASS 246، DONE 281، TODO 0