ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارتحليل · على الرادارHabr AI→ المصدر

Anthropic تعرض كيف تمنح وكيل الذكاء الاصطناعي ذاكرة عن المشروع دون تضخيم السياق

وكيل الذكاء الاصطناعي الذي لا يملك ذاكرة يبدأ المشروع من الصفر كل يوم، كأنه مطوّر مصاب بفقدان الذاكرة. عرضت لاميس موكتا من Anthropic مسار Claude Code: من ملف واحد هو CLAUDE.md يحوي القواعد، إلى دليل من ملاحظات markdown مزوّد بفهرس. يقرأ الوكيل جدول المحتويات فقط ويفتح الملاحظات اللازمة، فلا يتضخم السياق، أي كل ما يراه النموذج في الاستدعاء الواحد. ومع ذلك ينبغي التعامل مع الذاكرة بحذر: فكل سجل يحتاج إلى مصدر ونطاق وحالة.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
Anthropic تعرض كيف تمنح وكيل الذكاء الاصطناعي ذاكرة عن المشروع دون تضخيم السياق
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
حقيقة رئيسية #1يُحمَّل CLAUDE.md في السياق كاملاً، لذا يستنزف الملف المتضخم انتباه الوكيل
Skill مجلد يضم ملف SKILL.mdيرى الوكيل الوصف فقط، ويحمّل النص الكامل بحسب المهمة
حقيقة رئيسية #3ملاحظة «الاختبار معطّل» عديمة الفائدة؛ المطلوب هو الشروط والبيئة وتاريخ التحقق

تخيّل أن مطوّرًا قويًا انضم إلى الفريق. في يومه الأول فهم المشروع، ووجد الخدمة المطلوبة، وعرف سبب فشل الاختبارات، وأغلق عددًا كبيرًا من التذاكر. وفي اليوم الثاني يتبيّن أنه مصاب بفقدان الذاكرة: يعود إلى دراسة المستودع نفسه ويقع في أخطاء الأمس نفسها.

هكذا يعمل وكيل الذكاء الاصطناعي افتراضيًا تقريبًا. المعارف العامة مدمجة في أوزان النموذج، لكنه لا يعرف من تلقاء نفسه بنية مشروعك، ولا القواعد المتبعة في فريقك، ولا الأسباب التي جعلتك ترفض الحل نفسه ثلاث مرات. والخبرة لا تتراكم بين عمليات التشغيل من تلقاء نفسها.

روت لاميس موكتا من Anthropic كيف يتعامل Claude Code مع هذه المشكلة: يحتفظ الوكيل بذاكرة المشروع في ملفات، ويحمّل في السياق، أي في البيانات التي يراها النموذج عند استدعاء بعينه، ما يلزم فقط. وقد حلّل موقع Habr عرضها في الجزء العاشر من سلسلة «أدخلني إلى الـ harness».

من ملف واحد إلى دليل من الملاحظات

يبدأ الكاتب بالتمييز بين أربعة أشياء. نافذة السياق هي ما يراه النموذج الآن. النص المدوَّن (transcript) هو سجل رسائل الجلسة وأفعالها. حالة التنفيذ تحفظ الخطوة الجارية وما جرى تأكيده. أما الذاكرة فهي معلومات منتقاة للمهام المقبلة، ولا تحل محل السجل ولا محل الحالة الراهنة للنظام.

تطورت الذاكرة في Claude Code على مراحل، مع أن الكاتب يستدرك بأن هذا ليس سلّمًا إلزاميًا. أبسط الخيارات ملف CLAUDE.md الذي يحوي أمر تشغيل الاختبارات ومواضع الخدمات واتفاقات الفريق. يسهل فحصه بالعين وحفظه في git. لكن الملف يُحمَّل كاملاً في سياق كل جلسة. وإذا كُتب فيه كل شيء بلا انتقاء، يصبح تعليمات «بحجم كاسحة جليد نووية»، وحتى تصحيح خطأ إملائي سيهدر انتباه الوكيل على نص زائد.

الخطوة التالية هي أداة الذاكرة. لدى النموذج الدوال memory_read وmemory_write وmemory_edit، ويقرر بنفسه متى يستدعيها. أما مكان التخزين فتحدده طريقة التنفيذ: مجلد markdown أو قاعدة بيانات أو غير ذلك. لذا يمكن تقييد ما يقرؤه الوكيل ويكتبه، وفحص السجلات قبل حفظها. والتحرير موضعي، فلا تضيع المعلومات المجاورة.

ثم تأتي المهارات (skills). تحفظ الذاكرة الحقائق («تُشغَّل الاختبارات بالأمر X»)، بينما تحفظ المهارة تسلسل الإجراءات («كيف يُصدَر إصدار جديد»). فيزيائيًا هي مجلد يحوي ملف SKILL.md، وقد توجد بجانبه قوالب وأمثلة وسكربتات. يرى الوكيل باستمرار قائمة الأوصاف فقط، ويحمّل التعليمات الكاملة عندما تطابق المهمةَ. لذلك يمكن الاحتفاظ بعشرات المهارات دون تكلفة كبيرة على السياق. والسكربت أوثق من الطلب النصي حيث تلزم الدقة، لأنه يعمل بالطريقة نفسها في كل مرة. لكنه يُنفَّذ على جهازك وبصلاحياتك، لذا ينبغي قراءة مهارات الآخرين كما يُقرأ كود الغير.

كيف تعمل الكتابة والقراءة

المخطط الذي عُرض في الكلمة كالتالي. أثناء العمل يقرر الوكيل ما يستحق الحفظ: اتفاقًا للفريق، أو تفضيلًا للمستخدم، أو سببًا اكتُشف لخلل ما. ثم ينشئ ملف markdown أو يحدّثه. وفي بداية الجلسة يقرأ فهرسًا قصيرًا بسطر واحد لكل ملاحظة. وعندما تطابق المهمةُ الوصفَ يفتح الملف المطلوب. وإذا لم يكفِ الفهرس، يبحث في المحتوى بأدوات معتادة مثل grep، ولذلك تهم أسماء الملفات والمجلدات الواضحة. وينبغي الفصل بين المجلدات: قواعد المؤسسة، وملاحظات المشروع، وتفضيلات المستخدم، والاستنتاجات المؤقتة. وإلا طبّق الوكيل اتفاق فريق على مشروع آخر لمجرد أن الملاحظتين ظهرتا عند البحث عن كلمة deploy.

يحتوي السجل الجيد على معرّف ونطاق سريان ونوع وحالة ومصدر وتاريخ تحديث. ملاحظة «الجدول ينهار» عديمة الجدوى: بعد أسبوع لن يفهم أحد أي جدول تعني، ولا إن كانت المشكلة قد أُصلحت. أما السجل «عند استيراد DOCX بخلية فارغة جرى إعادة إنتاج تباين، تحقق من الكود الحالي قبل الاستنتاج» فيعطي اتجاهًا ويحدد بأمانة حدود المعرفة. والتاريخ وحده لا يدل على التقادم: أمر تشغيل الاختبار يعيش سنوات، بينما يتغير إصدار الخدمة المنشورة خلال دقائق. لذا تلزم قواعد تحقق مختلفة لأنواع السجلات المختلفة. وإلا أبلغ الوكيل بسعادة أن كل شيء قد نُشر، لأن أحدهم ترك ملاحظة بذلك قبل ستة أشهر.

القراءة التدريجية والتحقق رغم ذلك

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

مثال من العرض: يطلب المستخدم إصلاح استيراد جدول. يجد الوكيل ملاحظة عن موضع معالج DOCX وعن خلل قديم متعلق بخلية فارغة، ثم يفتح الكود الحالي والاختبارات. وإذا كانت الملاحظة تصف فرعًا قديمًا، فهذا ليس مبررًا لإعلان السبب القديم خطأً جديدًا. فالذاكرة تقصّر البحث لكنها لا تلغي التحقق.

ومن أفكار العرض أيضًا ما يسمى dreaming: عملية خلفية تراجع الجلسات السابقة وتنظّم المعارف المتراكمة.

الخلاصة العملية لمن يبني وكلاء: ابدأ بملف CLAUDE.md قصير، وانقل الإجراءات إلى المهارات (skills)، واحفظ حقائق المشروع في ملاحظات مزوّدة بفهرس ومصدر وحالة. وتعامل دائمًا مع السجل بوصفه تلميحًا لا حقيقة.

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول من ملف واحد إلى دليل من الملاحظات؟

يبدأ الكاتب بالتمييز بين أربعة أشياء. نافذة السياق هي ما يراه النموذج الآن. النص المدوَّن (transcript) هو سجل رسائل الجلسة وأفعالها. حالة التنفيذ تحفظ الخطوة الجارية وما جرى تأكيده. أما الذاكرة فهي معلومات منتقاة للمهام المقبلة، ولا تحل محل السجل ولا محل الحالة الراهنة للنظام. تطورت الذاكرة في Claude Code على مراحل، مع أن الكاتب يستدرك بأن هذا ليس سلّمًا إلزاميًا. أبسط الخيارات ملف CLAUDE.md الذي يحوي أمر تشغيل الاختبارات ومواضع الخدمات واتفاقات الفريق. يسهل فحصه بالعين وحفظه في git.

ما أبرز التفاصيل حول كيف تعمل الكتابة والقراءة؟

المخطط الذي عُرض في الكلمة كالتالي. أثناء العمل يقرر الوكيل ما يستحق الحفظ: اتفاقًا للفريق، أو تفضيلًا للمستخدم، أو سببًا اكتُشف لخلل ما. ثم ينشئ ملف markdown أو يحدّثه. وفي بداية الجلسة يقرأ فهرسًا قصيرًا بسطر واحد لكل ملاحظة. وعندما تطابق المهمةُ الوصفَ يفتح الملف المطلوب. وإذا لم يكفِ الفهرس، يبحث في المحتوى بأدوات معتادة مثل grep، ولذلك تهم أسماء الملفات والمجلدات الواضحة. وينبغي الفصل بين المجلدات: قواعد المؤسسة، وملاحظات المشروع، وتفضيلات المستخدم، والاستنتاجات المؤقتة.

ما أبرز التفاصيل حول القراءة التدريجية والتحقق رغم ذلك؟

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

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
ما رأيك؟
جارٍ تحميل التعليقات…