كيف تخلّي مساعد البرمجة يتذكّر شغلك؟
ما بيتذكّر — بيقرا. ملفّ قواعد بالمشروع بيحلّ المشكلة، بس فيه فخّ بيوقعوا فيه أغلب الناس.
كيف تخلّي مساعد البرمجة يتذكّر شغلك؟
ما بيتذكّر لحاله — كل جلسة بتبدأ من الصفر. الحلّ العملي ملفّ قواعد بالمشروع بيقراه كل مرّة، بتكتب فيه القرارات اللي ما بيقدر يستنتجها من قراءة الكود.
بتشرح لمساعد البرمجة إنك بتستعمل مكتبة معيّنة وبأسلوب معيّن، وبيشتغل حلو. بتفتح جلسة جديدة بكرة — ونسي كل إشي. بترجع تشرح من الأول. وهاي مش علّة بالأداة: هي كيف بتشتغل نماذج اللغة أصلاً.
ليش بينسى؟
النموذج ما عنده ذاكرة بين الجلسات. اللي بيبان «ذاكرة» هو نافذة السياق — النصّ اللي بينقرا معك بهالجلسة. لما تسكّر، بيروح.
وشرحنا الموضوع بعمومه بمقالة ذاكرة النماذج اللغوية. هون الحالة أوضح وأصعب: مشروع برمجي إله قرارات متراكمة، وكل جلسة بتبدأ عمياء عنها.
تلات أنواع ذاكرة
١. ذاكرة الجلسة (نافذة السياق). كل اللي انقال بهالمحادثة. مؤقّتة تماماً، وبتضيق لما تطول الجلسة.
٢. ملفّ القواعد. ملفّ نصّي بجذر المشروع بيقراه المساعد بأول كل جلسة. هاد الأنفع والأبسط — وهو اللي رح نركّز عليه.
٣. الاسترجاع. بحث بالكود والوثائق بيجيب المقطع المناسب وقت الحاجة — نفس فكرة RAG. بيلزم للمشاريع الكبيرة اللي ما بتستوعبها نافذة السياق.
ملفّ القواعد: شو تحطّ فيه؟
هاي أهم فقرة، والقاعدة الذهبية:
اكتب اللي ما بيقدر يستنتجه من قراءة الملفّات.
المساعد بيقدر يشوف إنه المشروع PHP، وإنه في مجلّد includes، وإنه الملفّات مرتّبة بشكل معيّن. فلا تكتبله هاد — بتاكل من نافذة السياق بلا فايدة.
اللي بيحتاجه فعلاً: القرارات.
| ✅ اكتب هاد | ❌ لا تكتب هاد |
|---|---|
| «بنستعمل PDO مش mysqli» | «هاد مشروع PHP» |
| «ممنوع تضيف مكتبات خارجية» | شرح بنية المجلّدات |
«الاختبارات بمجلّد tests/» | «الكود موجود بمجلّد src» |
| «أي تعديل CSS بدّه رفع رقم النسخة» | «في ملفّ style.css» |
| «تجنّب هالنمط — جرّبناه وفشل» | إعادة شرح الكود |
لاحظ إنه أقوى سطر بالجدول هو الأخير: «جرّبناه وفشل». هالمعلومة مش موجودة بالكود أبداً — الكود بيوريك اللي صار، مش اللي انرفض وليش.
مثال محسوس
مشروع فيه قاعدة بيانات، وقرّرت من زمان تستعمل استعلامات مجهّزة دايماً لأسباب أمنية.
بلا ملفّ قواعد: كل جلسة، المساعد بيكتب استعلاماً بطريقته — وأحياناً بدمج نصّي. بترجع تصلّح وتشرح.
مع سطر واحد بملفّ القواعد:
كل استعلام قاعدة بيانات لازم prepare + بارامترات. ممنوع الدمج النصّي نهائياً.كل جلسة جديدة بتبدأ وهي عارفة. مش لأنه تذكّر — لأنه قرا.
الفخّ: الملفّ اللي بينتفخ
هون أشيع خطأ، وبيصير بالتدريج.
بتضيف قاعدة، وبعدين تانية، وبعد شهر بيصير الملفّ صفحات. ومشكلتان بيطلعوا سوا:
- بياكل من نافذة السياق. كل سطر بينقرا كل جلسة على حساب مساحة الشغل الفعلي.
- بيخفّف وزن كل قاعدة. لما يكون في ٦٠ قاعدة، احتمال إنه ينتبه لوحدة معيّنة بيقلّ. عشرة قواعد بتنطبّق أحسن من ستّين.
وأخطر من الطول: القاعدة القديمة الغلط. لو غيّرت مكتبة والملفّ لسّاه بيقول استعمل القديمة، المساعد بيطيع الملفّ — وقاعدة غلط أسوأ من ما في قاعدة.
فراجعه لما يتغيّر إشي جوهري، واشطب اللي ما عاد ينطبق.
أخطاء وسوء فهم شائع
- «بيتذكّر لأنه ذكي»: لأ — بيقرا ملفّاً كل جلسة. لو مسحته، نسي كل إشي فوراً.
- «أحطّ كل إشي بالملفّ وأرتاح»: الملفّ الطويل بيضعف كل قاعدة فيه. خلّيه قصيراً ومركّزاً على القرارات.
- «ميزات الذاكرة بالأدوات بتغني عنه»: بتساعد، بس الملفّ جزء من المشروع — بينمشي مع الريبو، وبيشتغل لأي حدا بالفريق، وبتقدر تراجعه بالـgit.
- «لازم أكتب كل التفاصيل التقنية»: بالعكس — اكتب الـ«ليش» والقيود. الـ«شو» موجود بالكود.
- «الملفّ بيمنع الأخطاء»: بيقلّلها. لسّاتك لازم تراجع — راجع قواعد الاستخدام الآمن.
خلاصة سريعة
- المساعد ما بيتذكّر — كل جلسة من الصفر.
- تلات طبقات: جلسة (مؤقّتة) · ملفّ قواعد (الأنفع) · استرجاع (للكبير).
- القاعدة: اكتب اللي ما بيقدر يستنتجه من الكود — يعني القرارات والقيود.
- «جرّبناه وفشل» أثمن سطر، لأنه مش موجود بالكود.
- عشر قواعد بتنطبّق أحسن من ستّين.
- راجع الملفّ — قاعدة قديمة غلط أسوأ من ما في قاعدة.
أسئلة بتوصلنا كتير
- كيف أجعل مساعد البرمجة يتذكّر تفاصيل مشروعي؟ أنشئ ملفّ قواعد نصّياً في جذر المشروع يقرأه المساعد في بداية كل جلسة، واكتب فيه القرارات والقيود التي لا يمكن استنتاجها من قراءة الكود — لا وصف بنية المشروع الظاهرة أصلاً.
- What is a coding agent memory file in Arabic? بالعربي «ملفّ قواعد المشروع» — ملفّ نصّي يوضع في المستودع ليقرأه مساعد البرمجة في كل جلسة، فيعرف قرارات الفريق وقيوده دون إعادة شرحها في كل مرّة.
- لماذا ينسى مساعد البرمجة كل شيء بين الجلسات؟ لأن نماذج اللغة لا تملك ذاكرة دائمة؛ ما يبدو ذاكرة هو نافذة السياق أي النصّ الحاضر في الجلسة نفسها، وهي تنتهي بانتهائها.
- ماذا أكتب في ملفّ قواعد المشروع؟ القرارات التقنية (مثل «نستخدم استعلامات مجهّزة دائماً»)، والقيود («ممنوع إضافة مكتبات خارجية»)، والمحاولات الفاشلة وأسبابها — فهذه الأخيرة أثمن ما يمكن كتابته لأنها غير موجودة في الكود إطلاقاً.
- هل يضرّ أن يكون ملفّ القواعد طويلاً؟ نعم؛ فكل سطر يُقرأ في كل جلسة ويستهلك من نافذة السياق، وكثرة القواعد تُضعف احتمال الالتزام بكلّ واحدة منها — وأخطر من الطول بقاء قاعدة قديمة لم تعد صحيحة، لأن المساعد سيطيعها.
كمّل رحلتك من هون
- الأساس: الذكاء الاصطناعي للبرمجة
- ليش بينسى أصلاً: ذاكرة النماذج اللغوية
- الحدّ اللي بيحكم كل إشي: نافذة السياق
- الطبقة التالتة بالتفصيل: شو يعني RAG؟
- لما ينفّذ لحاله: وكلاء بيستخدموا الكمبيوتر
- فكرة قريبة للوكلاء عموماً: شو يعني Skills؟
- كل المصطلحات بمكان واحد: قاموس الذكاء الاصطناعي
📘 مصطلحات وردت بالمقالة
بتقدر تلغي بضغطة · ما بنشارك بريدك مع حدا