> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# هندسة السياق Context Engineering: ما يراه الوكيل وما لا يراه
- URL: https://arabroot.io/articles/هندسة-السياق-context-engineering-ما-يراه-الوكيل/
- Published: 2026-11-19T20:23:14.000Z
- Updated: 2026-11-19T21:23:42.000Z
- Description: ما الذي يرسله الوكيل فعلاً مع طلبك، ولماذا يخطئ النموذج عندما يكون أمامه ملف لا يحتاجه أو سجل طويل أو جلسة قصت من أولها، مع تجارب على نموذج محلي تغير السياق وحده.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, التطوير مع وكلاء الذكاء الاصطناعي

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

وفي [مقال كيف يعمل مساعد البرمجة من الداخل](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D9%8A%D8%B9%D9%85%D9%84-%D9%85%D8%B3%D8%A7%D8%B9%D8%AF-%D8%A7%D9%84%D8%A8%D8%B1%D9%85%D8%AC%D8%A9-%D8%A8%D8%A7%D9%84%D8%B0%D9%83%D8%A7%D8%A1-%D8%A7%D9%84%D8%A7%D8%B5%D8%B7%D9%86%D8%A7%D8%B9%D9%8A-%D9%85%D9%86-%D8%A7%D9%84%D8%AF%D8%A7%D8%AE%D9%84/) شرحنا أن نافذة السياق Context Window هي كل ما يعرفه النموذج في هذه اللحظة، وفي [دليل كتابة التعليمات Instructions](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D9%83%D8%AA%D8%A8-%D8%AA%D8%B9%D9%84%D9%8A%D9%85%D8%A7%D8%AA-%D8%AC%D9%8A%D8%AF%D8%A9-%D9%84%D9%86%D9%85%D9%88%D8%B0%D8%AC-%D8%A7%D9%84%D9%84%D8%BA%D8%A9-prompt/) شرحنا كيف تكتب طلباً واحداً جيداً. وهذا المقال يأخذ الخطوة التالية: الوكيل Agent لا يرسل طلبك وحده، وإنما يبني في كل دورة طلباً من عشرات الأجزاء، وأغلبها لم تكتبه أنت، فما هي هذه الأجزاء؟ وكم تأخذ؟ وماذا يحدث للنموذج عندما يكون فيها ملف يشبه الملف الصحيح، أو مخرج اختبار من مئات الأسطر، أو محادثة طويلة قصت من أولها؟ ولكي لا يكون الكلام نظرياً، فإننا نفتح طلباً حقيقياً من وكيل معروف ونعد أجزاءه، ثم نشغل أربع تجارب على نموذجين محليين صغيرين نغير فيها السياق وحده ونترك كل شيء آخر كما هو.

في هذا المقال سوف نتناول:

- الفرق بين هندسة التعليمات Prompt Engineering وهندسة السياق Context Engineering.
- ما يرسله وكيل حقيقي قبل أن يقرأ النموذج طلبك، مقاساً بالتوكنات Tokens.
- لماذا لا تحل النافذة الأكبر المشكلة: تآكل السياق Context Rot والضياع في المنتصف.
- أربع تجارب: مكان المعلومة، والملف القديم الذي يشبه الجديد، ومخرج الأدوات الطويل، والجلسة الطويلة.
- أربعة أشياء تفعلها بالسياق بدل أن ترسل كل شيء، وكيف تطبقها الأدوات المعروفة.
- الأخطاء الشائعة، وقائمة تحقق قبل أن تلوم النموذج.

## ما هي هندسة السياق Context Engineering؟

هندسة السياق هي اختيار ما يدخل في نافذة النموذج في كل خطوة من خطوات الوكيل، وترتيبه، وما يخرج منها، بحيث يرى النموذج أقل قدر من التوكنات يحمل أكبر قدر من المعلومة التي يحتاجها الآن. و[مقال Anthropic عن هندسة السياق للوكلاء](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents?ref=arabroot.io) المنشور في 29 سبتمبر 2025 يصوغها بجملة قريبة: أن تجد أصغر مجموعة ممكنة من التوكنات عالية الإشارة High-signal Tokens التي ترفع احتمال النتيجة التي تريدها.

وقد يتساءل البعض: أليس هذا ما كنا نسميه هندسة التعليمات Prompt Engineering؟ والإجابة أن هندسة التعليمات تعمل على نص واحد تكتبه مرة، وهو مناسب للسؤال الواحد أو للمهمة التي لها مدخل ومخرج، أما الوكيل فيعمل في حلقة Loop من عشرات الدورات، وفي كل دورة يتغير ما في النافذة: ملفات قرأها، ومخرجات أوامر شغلها، وردود سابقة له، وملخصات لما قبلها. والتعليمات الجيدة جزء من هذا كله، ولكنها جزء صغير، والسؤال الأكبر هو من يقرر ماذا يبقى من الدورة الخامسة عندما يصل الوكيل إلى الدورة الأربعين. ولذلك فإن هندسة السياق عمل يقوم به في الغالب من يبني بيئة التشغيل Harness، أي الأداة نفسها، ويقوم به المطور أيضاً عندما يقرر ماذا يكتب في ملف التعليمات، وأي ملفات يضيف إلى المحادثة، ومتى يبدأ جلسة جديدة.

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

## ماذا يرسل الوكيل قبل أن يقرأ النموذج طلبك؟

لكي نرى السياق كما هو، شغلنا [Codex CLI](https://github.com/openai/codex?ref=arabroot.io) بالإصدار 0.170.0، وهو وكيل مفتوح المصدر Open Source، ولكننا وجهناه إلى سيرفر وهمي صغير يحفظ كل طلب يصله ولا يشغل أي نموذج، وشرحنا هذا الإعداد بالتفصيل في [مقال ملف تعليمات المشروع](#related) في هذه المرحلة. ثم أعطيناه سؤالاً من سبع كلمات تقريباً في مستودع صغير فيه ملف `AGENTS.md`، وعددنا توكنات كل جزء من الطلب الذي خرج منه بمكتبة tiktoken وترميز `o200k_base`، والمخرج سوف يكون كما يلي:

```text
== captures/nested.json
tools (9 definitions)                4059 tokens
developer: You are a coding agent running i   3523 tokens
developer: <skills_instructions>      536 tokens
user: # AGENTS.md instructions for /wo    191 tokens
user: Summarize the current instructio      7 tokens
total                                8316 tokens
```

في المخرج أعلاه لاحظ التالي:

- طلبك أنت كان 7 توكنات من 8,316، أي أقل من عشر الواحد في المئة من الطلب، وكل الباقي أضافه الوكيل قبل أن يقرأ النموذج كلمة منك.
- أكبر جزء هو تعريف الأدوات Tools، أي وصف تسع أدوات مثل `exec_command` لتشغيل الأوامر و`web_search` للبحث، مع مدخلات كل أداة بصيغة JSON Schema، وهي 4,059 توكناً، أي حوالي نصف الطلب، وهذا قبل أن تضيف أي سيرفر MCP.
- الجزء الثاني تعليمات Codex الثابتة، 3,523 توكناً، وفيها كيف يعمل، وكيف يعدل الملفات، ومتى يطلب الموافقة، وكيف يتعامل مع ملفات `AGENTS.md`.
- قائمة المهارات Skills أخذت 536 توكناً، وهي الاسم والوصف لكل مهارة فقط، وملفات المشروع ومعلومات البيئة 191 توكناً.

![شريط أفقي واحد يمثل طلباً حقيقياً من Codex CLI بطول 8,316 توكن: أكبر جزء أزرق لتعريف الأدوات Tools، ثم جزء برتقالي لتعليمات الوكيل System، ثم جزء بنفسجي صغير لقائمة المهارات، وجزء أخضر أصغر لملفي AGENTS.md ومعلومات البيئة، وفي الطرف خط أحمر رفيع جداً لطلبك، وسهم يقول طلبك أنت 7 توكنات فقط، وتحت الشريط جدول بالأرقام 4,059 و3,523 و536 و191 و7](https://arabroot.io/content/images/2026/11/context-engineering-01-request.webp)

طلب واحد من Codex CLI 0.170.0: سؤالك سبعة توكنات، والباقي تعريف الأدوات وتعليمات الوكيل والمهارات والملفات.

وهذا الطلب هو الطلب الأول فقط، أي قبل أن يقرأ الوكيل أي ملف أو يشغل أي أمر، ومع كل دورة تضاف إليه ردود النموذج ونتائج الأدوات، فيكبر الطلب دورة بعد دورة حتى يقترب من حد النافذة. و[صفحة نافذة السياق في توثيق Claude Code](https://code.claude.com/docs/en/context-window?ref=arabroot.io) تعرض جلسة مثالاً تبدأ قبل أن تكتب شيئاً بملفات `CLAUDE.md` والذاكرة التلقائية وأسماء أدوات MCP وأوصاف المهارات، ثم يضاف كل ملف يقرؤه الوكيل وكل قاعدة تحمل، وتذكر أن الأمر `/context` يعرض لك الأرقام الحقيقية لجلستك مقسمة حسب النوع. وإذا كنت تريد أن تبدأ في هندسة السياق، فابدأ بهذا الأمر أو بما يشبهه في أداتك، لأنك لا تستطيع أن تحسن ما لا تراه.

## لماذا لا نرسل كل شيء ما دامت النافذة كبيرة؟

النماذج الكبيرة اليوم تقبل مئات الآلاف من التوكنات، وبعضها مليون توكن، ولذلك قد يبدو أن الحل البسيط هو أن ترسل المستودع كله وتترك النموذج يختار. وهذا الحل غير مناسب لثلاثة أسباب، كل واحد منها كاف وحده:

1. **الكلفة والزمن:** كل توكن في النافذة يقرؤه النموذج في كل دورة، وتدفع ثمنه في كل دورة إذا كنت تستعمل خدمة سحابية، وتنتظره في كل دورة إذا كنت تستعمل نموذجاً محلياً. وفي [دليل الوكيل بنموذج محلي](https://arabroot.io/articles/%D9%88%D9%83%D9%8A%D9%84-%D8%A8%D8%B1%D9%85%D8%AC%D8%A9-%D8%A8%D9%86%D9%85%D9%88%D8%B0%D8%AC-%D9%85%D8%AD%D9%84%D9%8A-%D9%85%D8%B9-ollama-%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D8%AA%D9%88%D9%82%D8%B9/) قسنا أن نموذج 7B على معالج عادي احتاج أكثر من خمس دقائق ليقرأ ملفاً من 4,956 توكناً قبل أن يكتب أول كلمة.
2. **الانتباه محدود:** مقال Anthropic نفسه يقول إن للنموذج ميزانية انتباه Attention Budget، وإن كل توكن جديد يأخذ منها شيئاً، والسبب في بنية المحول Transformer، حيث يرتبط كل توكن بكل توكن آخر، أي n² علاقة لعدد n من التوكنات، وكلما طال السياق توزع الانتباه على علاقات أكثر.
3. **الأداء يتراجع مع الطول:** وهذا ما قاسته دراستان معروفتان، كما يلي.

الدراسة الأولى «Lost in the Middle» لـ Nelson F. Liu وزملائه من جامعة Stanford، نشرت في 2023 ثم في مجلة TACL في 2024، و[ملخصها على arXiv](https://arxiv.org/abs/2307.03172?ref=arabroot.io) يذكر أن أداء النماذج في الإجابة من عدة مستندات يكون أعلى عندما تكون المعلومة المطلوبة في أول السياق أو في آخره، وينخفض بشكل واضح عندما تكون في منتصفه، حتى مع النماذج المصممة للسياق الطويل. والثانية تقرير «Context Rot» من شركة Chroma في 14 يوليو 2025 لـ Kelly Hong وAnton Troynikov وJeff Huber، و[التقرير](https://research.trychroma.com/context-rot?ref=arabroot.io) قاس 18 نموذجاً، منها نماذج من OpenAI وAnthropic وGoogle وQwen، ووجد أن الأداء يصبح أقل ثباتاً كلما طال المدخل حتى في مهام بسيطة، وأن الاختبار المعروف «الإبرة في كومة القش» Needle in a Haystack يقيس الاسترجاع الحرفي فقط، ولذلك تنجح فيه النماذج وتعطي انطباعاً خاطئاً بأن السياق الطويل مشكلة محلولة، بينما المشتتات Distractors، أي النصوص التي تشبه الإجابة وليست هي، تخفض الأداء بشكل أكبر.

والسؤال العملي لك كمطور: هل يحدث هذا في نافذة صغيرة من ألفي توكن، وفي مهام برمجية عادية، ومع النماذج الصغيرة التي قد تشغلها على جهازك؟ وهذا ما قاسته التجارب التالية.

## المختبر: أربع تجارب تغير السياق وحده

المختبر مجموعة سكربتات Python تستعمل المكتبة القياسية فقط، وتعمل داخل Container من `python:3.13.18-slim`، وتتصل بسيرفر [Ollama](https://ollama.com/?ref=arabroot.io) بالإصدار 0.40.13 في Container آخر على الجهاز نفسه. والنموذجان من عائلة Qwen2.5-Coder بحجمي 1.5B و3B، وبتكميم Q4\_K\_M، أي ملف من حوالي 1 GB والآخر من حوالي 1.9 GB، وكل التشغيلات بدرجة حرارة Temperature صفر وبذرة Seed ثابتة، حتى يكون الفرق الوحيد بين تشغيلين هو السياق. والجهاز معالج عادي دون بطاقة رسومية، وكان مشغولاً في الوقت نفسه بأجهزة افتراضية وبنموذج آخر لمستخدم آخر، ولذلك كانت القراءة بطيئة جداً، حوالي 8 إلى 10 توكنات في الثانية لنموذج 1.5B، وهذا يؤثر على الزمن فقط، ولا يؤثر على الإجابة لأن الحرارة صفر.

والملفات التي تملأ السياق في التجارب ملفات Python عادية يولدها السكربت `filler.py` بشكل ثابت، كل ملف فيه كلاس صغير وأربع دوال تشبه ما تجده في أي مشروع، مثل `count_orders` و`archive_orders`، وكل واحد منها حوالي 250 توكناً. وكل التجارب تعطي النموذج الملفات بالشكل الذي تلصقها به أغلب الأدوات، أي مسار الملف ثم محتواه في كتلة كود، والسكربت `run.sh` يشغلها بالترتيب ويحفظ مخرج كل تجربة في ملف.

## التجربة الأولى: هل تضيع المعلومة في المنتصف؟

التجربة الأولى نسخة صغيرة من «الإبرة في كومة القش»، فهي تضع قيمة إعداد واحدة، مثل `MAX_UPLOAD_MB = 37`، في ملف صغير بين تسعة ملفات، مرة في الأول ومرة في المنتصف ومرة في الآخر، ثم تسأل النموذج في نهاية الطلب عن قيمتها، وتكرر ذلك بأربع قيم مختلفة، والطلب كله حوالي 2,100 توكن. والمخرج لنموذج 1.5B سوف يكون كما يلي:

```text
### qwen2.5-coder:1.5b
value              pos  0 pos  4 pos  8   prompt tokens
MAX_UPLOAD_MB        ok     ok     ok     2130
RETRY_BACKOFF_MS     ok     ok     ok     2130
INVOICE_PREFIX       ok     ok     ok     2130
SESSION_TTL_MIN      ok     ok     ok     2130
correct: 12/12
```

أي أن النموذج الصغير وجد القيمة في كل الحالات، في أول الملفات وفي منتصفها وفي آخرها. وهذه النتيجة لا تناقض الدراسات، وإنما تؤكد ما قاله تقرير Chroma: البحث عن اسم ثابت مكتوب حرفياً في السياق، مثل `RETRY_BACKOFF_MS`، مهمة سهلة، لأن السؤال يحتوي الكلمة نفسها التي في الإجابة، والنموذج يجدها كما يجدها `grep`. وتأثير المنتصف الذي قاسته دراسة Liu ظهر في سياقات أطول بكثير، من عشرات المستندات، وفي أسئلة تحتاج فهم المستند وليس مطابقة كلمة. ولذلك فإن الدرس الأول عملي: إذا كانت المعلومة التي يحتاجها الوكيل لها اسم واضح، فلا تقلق كثيراً من مكانها في سياق قصير، وقلق من الأشياء التي تشبهها، وهذا موضوع التجربة الثانية.

## التجربة الثانية: الملف القديم الذي يشبه الجديد

في كل مستودع حقيقي نسخ قديمة من الكود Code: مجلد `legacy/`، أو ملف `pricing_v1.py` بقي بعد إعادة الكتابة، أو فرع قديم نسخه أحدهم إلى مجلد للمقارنة. والتجربة الثانية تأخذ دالة واحدة لحساب رسوم الشحن `shipping_fee` في الملف `app/shipping.py`، ونسخة قديمة منها بأسعار 2023 في `legacy/shipping_v1.py`، والدالتان كما يلي:

```python
# app/shipping.py (الكود الحالي)
def shipping_fee(weight_kg, express=False):
    """Fee in SAR for one parcel."""
    if weight_kg <= 2:
        fee = 18
    elif weight_kg <= 10:
        fee = 18 + (weight_kg - 2) * 4
    else:
        fee = 50 + (weight_kg - 10) * 3
    if express:
        fee = fee * 2 - 5
    return fee

# legacy/shipping_v1.py (نسخة قديمة لم تعد مستعملة)
def shipping_fee(weight_kg, express=False):
    """Fee in SAR for one parcel (2023 price list)."""
    if weight_kg <= 5:
        fee = 25
    else:
        fee = 25 + (weight_kg - 5) * 6
    if express:
        fee = fee + 20
    return fee
```

ثم تسأل النموذج خمسة أسئلة جوابها مكتوب في سطر واحد من الدالة الحالية، مثل «كم رسوم طرد وزنه 1 كيلو؟» وجوابها 18، و«حتى كم كيلو تنطبق الرسوم الأساسية؟» وجوابها 2، و«كم ريالاً تضاف لكل كيلو بعد الوزن الأساسي؟» وجوابها 4، بأربعة سياقات مختلفة: الملف الصحيح وحده، ثم الملف الصحيح بين عشرة ملفات عادية، ثم الملفات نفسها مع النسخة القديمة، ثم الشيء نفسه مع جملة واحدة في أول الطلب تقول إن مجلد `legacy/` كود ميت لا يستورده أحد. والمخرج لنموذج 1.5B سوف يكون كما يلي:

```text
### qwen2.5-coder:1.5b
only the right file      4/5  prompt   169  answers: 18 10✗ 4 2 3
+ 10 unrelated files     2/5  prompt  2762  answers: 50✗ 5✗ 18✗ 2 3
+ 10 files + old copy    3/5  prompt  2856  answers: 18 2 18✗ 3✗ 3
+ old copy, labelled     3/5  prompt  2880  answers: 18 2 18✗ 3✗ 3
expected: 18 2 4 2 3   (old copy: 25 5 6, no multiplier, no rate above 10 kg)
```

في مخرج نموذج 1.5B أعلاه لاحظ التالي:

- مع الملف الصحيح وحده، أي 169 توكناً، أجاب النموذج أربعة أسئلة من خمسة، وأخطأ في سؤال الوزن الأساسي فأجاب 10 بدل 2، أي أنه خلط بين الحدين في الشرطين.
- عندما أضفنا عشرة ملفات لا علاقة لها بالشحن، نزل إلى سؤالين من خمسة، مع أن المعلومة لم تتغير ولم تتحرك، وأخطاؤه كانت أرقاماً من مكان آخر: أجاب على رسوم الكيلو الواحد بـ 50، وهو رقم موجود في الدالة نفسها لكن لفرع الوزن فوق 10 كيلو، وأجاب على سؤال الوزن الأساسي بـ 5\. والملفات العادية مليئة بالأرقام، مثل `limit=90` و`>= 5`، وكل رقم منها مرشح ليكون الإجابة.
- عندما أضفنا النسخة القديمة لم تسوء النتيجة أكثر في هذا النموذج، فقد أجاب ثلاثة أسئلة من خمسة، ولكن أخطاءه تغيرت.
- الجملة التي تقول إن `legacy/` كود ميت لم تغير شيئاً في هذا النموذج الصغير، فالإجابات نفسها حرفاً حرفاً. أي أن الشرح لا يعوض الحذف، والملف الذي لا يجب أن يراه النموذج، لا تضعه أمامه ثم تطلب منه أن يتجاهله.

ثم شغلنا الأسئلة نفسها بالسياقات نفسها على نموذج 3B، والمخرج سوف يكون كما يلي:

```text
### qwen2.5-coder:3b
only the right file      5/5  prompt   169  answers: 18 2 4 2 3
+ 10 unrelated files     5/5  prompt  2762  answers: 18 2 4 2 3
+ 10 files + old copy    5/5  prompt  2856  answers: 18 2 4 2 3
+ old copy, labelled     5/5  prompt  2880  answers: 18 2 4 2 3
```

أي أن النموذج الأكبر بقليل لم يتأثر بأي شيء في هذه التجربة: الإجابات الخمس صحيحة في السياقات الأربعة، حتى مع النسخة القديمة بجانب الحالية. وهذا يتفق مع ما يذكره تقرير Chroma من أن الأثر يختلف كثيراً من نموذج إلى آخر، وأن التراجع يظهر مع كل النماذج ولكن بدرجات مختلفة، وعند أطوال مختلفة. والدرس العملي من الجدولين معاً أن المشتتات لا تضمن الخطأ، وإنما ترفع احتماله، وأن ما يحتمله نموذج قد يسقط فيه نموذج أصغر أو أكثر انشغالاً أو سياق أطول، وفي نموذج 1.5B كان الفرق بين السطر الأول والثاني فقط 2,600 توكن من كود لا علاقة له بالسؤال، وكانت كافية لينزل من أربع إجابات صحيحة إلى اثنتين. وهذا ما يحدث عندما يقرأ الوكيل مجلداً كاملاً لأنه لا يعرف أين الملف، أو عندما تضيف أنت عشرة ملفات إلى المحادثة «للاحتياط». ولأنك لا تعرف مسبقاً أين يقع نموذجك اليوم على هذا المنحنى، فالطريقة الأضمن أن لا تعطيه المشتت أصلاً. والشكل التالي يلخص السياقات الأربعة للنموذج الأصغر:

![أربعة أشرطة أفقية لنموذج qwen2.5-coder:1.5b: الملف الصحيح وحده 169 توكناً وأربع إجابات صحيحة من خمس مع ملاحظة خلط بين حدي الوزن، ثم مع عشرة ملفات لا علاقة لها 2,762 توكناً وإجابتان فقط مع ملاحظة أرقام من أماكن أخرى، ثم مع النسخة القديمة legacy 2,856 توكناً وثلاث إجابات، ثم مع جملة أن legacy كود ميت 2,880 توكناً وثلاث إجابات والإجابات نفسها حرفاً حرفاً](https://arabroot.io/content/images/2026/11/context-engineering-03-distractors.webp)

الأسئلة الخمسة نفسها بأربعة سياقات لنموذج 1.5B: الملفات التي لا علاقة لها بالسؤال خفضت الإجابات الصحيحة أكثر من أي شيء آخر، أما نموذج 3B فأجاب الخمسة في السياقات الأربعة.

## التجربة الثالثة: مخرج الأدوات Tool Output، كم تلصق منه؟

أكثر ما يملأ نافذة الوكيل في الجلسات الحقيقية ليس الملفات، وإنما ما ترجعه الأدوات: مخرج الاختبارات Tests، والسجلات، ونتائج البحث. والتجربة الثالثة تبني مستودعاً صغيراً فيه ثلاث دوال واختبارات حقيقية، 62 اختباراً، وتضع في كل مرة خطأً واحداً في دالة واحدة يجعل اختباراً واحداً يفشل، مثل `round_halalas` التي تقرب -1.25 إلى -124 بدل -125\. ثم تشغل الاختبارات فعلاً بالأمر `python -m unittest -v` وتعطي النموذج المخرج بثلاثة أشكال: المخرج الكامل مع سجلات التصحيح DEBUG التي تكتبها الدوال، ثم المخرج الكامل دون سجلات، ثم جزء الفشل وحده مع سطر الملخص، كما تفعل بيئة تشغيل حريصة. والسؤال في الحالات كلها: أي اختبار فشل، وأي دالة في التطبيق فيها الخطأ؟ والمخرج للنموذجين سوف يكون كما يلي، مختصراً:

```text
### qwen2.5-coder:1.5b
money  verbose + debug logs   lines  138  prompt  3871  read   99.8s  test ok    function MISS  { "test": "test_round_negative", "function": "test_round_negative" }
money  verbose, no logs       lines   76  prompt  1430  read   25.2s  test ok    function ok    { "test": "test_round_negative", "function": "round_halalas" }
money  failures only          lines   12  prompt   197  read    2.0s  test ok    function ok    { "test": "test_round_negative", "function": "round_halalas" }
dates  verbose + debug logs   lines  138  prompt  3892  read   83.6s  test ok    function ok
dates  verbose, no logs       lines   76  prompt  1451  read   24.6s  test ok    function ok
dates  failures only          lines   12  prompt   218  read    2.4s  test ok    function ok
text   verbose + debug logs   lines  142  prompt  3886  read   99.5s  test ok    function ok
text   verbose, no logs       lines   80  prompt  1445  read   15.3s  test ok    function ok
text   failures only          lines   16  prompt   212  read    2.2s  test ok    function ok

### qwen2.5-coder:3b
money  verbose + debug logs   lines  138  prompt  3871  read  147.0s  test ok    function ok
money  verbose, no logs       lines   76  prompt  1430  read   58.3s  test ok    function ok
money  failures only          lines   12  prompt   197  read    4.4s  test ok    function ok
dates  verbose + debug logs   lines  138  prompt  3892  read  187.1s  test ok    function ok
dates  verbose, no logs       lines   76  prompt  1451  read   46.4s  test ok    function ok
dates  failures only          lines   12  prompt   218  read   13.6s  test ok    function ok
text   verbose + debug logs   lines  142  prompt  3886  read  182.1s  test ok    function ok
text   verbose, no logs       lines   80  prompt  1445  read   38.2s  test ok    function ok
text   failures only          lines   16  prompt   212  read    5.8s  test ok    function ok
```

في المخرج أعلاه لاحظ التالي:

- **الدقة تقريباً واحدة:** النموذجان وجدا الاختبار الفاشل في الحالات الثمانية عشر كلها، ووجدا الدالة في سبع عشرة حالة، والخطأ الوحيد كان لنموذج 1.5B مع المخرج الكامل والسجلات، فقد كتب اسم الاختبار مكان اسم الدالة. أي أن المخرج الطويل لم يجعل النموذج يضيع الفشل، لأن سطر `FAIL:` مميز ويسهل العثور عليه، كما في التجربة الأولى.
- **الكلفة مختلفة جداً:** المخرج الكامل مع السجلات حوالي 3,880 توكناً، ودون السجلات حوالي 1,440، وجزء الفشل وحده بين 197 و218، أي أن السجلات وحدها ضاعفت الحجم أكثر من مرتين ونصف، وجزء الفشل أصغر بحوالي عشرين مرة من الكامل.
- **والزمن يتبع الحجم:** نموذج 3B قرأ المخرج الكامل في 147 إلى 187 ثانية، وجزء الفشل في 4 إلى 14 ثانية، والمعلومة التي احتاجها هي نفسها في الحالتين.

وقد يتساءل البعض: إذا كانت الدقة لم تتغير، فلماذا نهتم؟ والإجابة أن هذا طلب واحد في أول المحادثة، أما في جلسة حقيقية فالوكيل يشغل الاختبارات عشر مرات أو عشرين، وكل مخرج يبقى في المحادثة ويقرأ مع كل دورة بعده، فأربعة آلاف توكن في كل تشغيل تصبح أربعين ألفاً بعد عشر محاولات، وهذا ما يملأ النافذة ويطرد منها ما هو أهم، ويدفع الأداة إلى ضغط المحادثة أو قصها مبكراً، وهو موضوع التجربة الرابعة. ولذلك فإن الأدوات الجيدة تقص المخرج قبل أن يدخل، وتعطيك أنت طريقة لترى المخرج الكامل إذا احتجته، وإذا كنت تكتب أداة أو تعليمات لوكيلك فاطلب مخرجاً مختصراً، مثل `-q` بدل `-v`، وأطفئ سجلات التصحيح في الاختبارات.

![ثلاثة أشرطة لمخرج الاختبارات بثلاثة أشكال: الكامل مع سجلات DEBUG حوالي 140 سطراً و3,880 توكناً وقرأه نموذج 3B في 147 إلى 187 ثانية وصح 5 من 6، والكامل دون سجلات حوالي 78 سطراً و1,440 توكناً في 38 إلى 58 ثانية وصح 6 من 6، وجزء الفشل وحده 12 إلى 16 سطراً وحوالي 210 توكنات في 4 إلى 14 ثانية وصح 6 من 6، وتحتها صندوق أن عشرة تشغيلات بالمخرج الكامل حوالي 39 ألف توكن مقابل 2,100 لجزء الفشل](https://arabroot.io/content/images/2026/11/context-engineering-04-tool-output.webp)

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

## التجربة الرابعة: الجلسة الطويلة، القص أم الملخص أم التثبيت؟

عندما تطول الجلسة لا تتسع النافذة لكل شيء، والأداة تختار بين ثلاث طرق: أن تقص الرسائل القديمة وتبقي الأخيرة، أو أن تلخص القديمة بالنموذج نفسه وتضع الملخص مكانها، وهو الضغط Compaction الذي تفعله Claude Code وCodex، أو أن تكون القواعد المهمة مثبتة في تعليمات النظام أو في ملف التعليمات فلا تتأثر بالقص. والتجربة الرابعة تبني جلسة تبدأ برسالة فيها قواعد المشروع: Python 3.9 فلا تستعمل `match`، والمكتبة القياسية فقط فلا `requests` ولا `click`، وقراءة سطر الأوامر بالمكتبة `argparse`، ثم ثماني دورات عادية يطلب فيها المطور ملفات مساعدة ويرد الوكيل بكودها، ثم ثلاثة طلبات جديدة تغري بمخالفة القواعد: دالة تجلب JSON من رابط، وهي تغري بـ `requests`، ودالة `main` بأمرين فرعيين، وهي تغري بـ `click`، ودالة توزع الأوامر حسب الكلمة الأولى، وهي تغري بـ `match`. ويرسل السكربت الطلبات الثلاثة بأربع طرق: الجلسة كاملة، وآخر ست رسائل فقط، وملخص كتبه النموذج للجلسة القديمة مع آخر ست رسائل، والقواعد مثبتة في تعليمات النظام مع آخر ست رسائل، ثم يفحص الكود الذي كتبه بحثاً عن `match` أو أي استيراد من خارج المكتبة القياسية.

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

```text
### qwen2.5-coder:1.5b
summary written by the model:
- Python 3.9 on customer's servers
- No match statements
- Standard library only
- argparse for command line parsing
- helpers for app/orders.py, app/users.py, app/inventory.py, app/reports.py, app/emails.py, app/search.py, app/audit.py, app/cache.py

full history           prompt  2373  fetch:requests  cli:ok  parse:ok
last 6 messages        prompt   892  fetch:requests  cli:ok  parse:ok
summary + last 6       prompt   963  fetch:requests  cli:ok  parse:ok
rules pinned + last 6  prompt   948  fetch:requests  cli:ok  parse:ok

### qwen2.5-coder:3b
summary written by the model:
- Python 3.9 on customer's servers
- Standard library only: no requests, no click, no typer, nothing from pip
- Command line parsing uses argparse
- Helpers for app/orders.py, app/users.py, app/inventory.py, app/reports.py, app/emails.py, app/search.py, app/audit.py, and app/cache.py

full history           prompt  2373  fetch:requests  cli:ok  parse:ok
last 6 messages        prompt   892  fetch:requests  cli:ok  parse:ok
summary + last 6       prompt   973  fetch:requests  cli:ok  parse:ok
rules pinned + last 6  prompt   948  fetch:requests  cli:ok  parse:ok
```

في المخرج أعلاه لاحظ التالي:

- **الملخصان مختلفان:** نموذج 1.5B كتب «Standard library only» وأسقط التفصيل «no requests»، وأبقى «No match statements»، ونموذج 3B أبقى «no requests, no click» وأسقط قاعدة `match` من الملخص كله. أي أن كل ملخص فقد قاعدة مختلفة، وهذا هو خطر الضغط الحقيقي: النموذج يقرر ما هو المهم، وقد لا يكون ما تراه أنت مهماً.
- **الملخص صغير:** الجلسة الكاملة 2,373 توكناً، والملخص مع آخر ست رسائل بين 963 و973، أي أقل من النصف، والتثبيت مع آخر ست رسائل 948.
- **الطلب الأول خالف القاعدة في الطرق الأربع:** دالة جلب JSON استعملت `requests` في كل الحالات وفي النموذجين، حتى عندما كانت القاعدة «no requests» مكتوبة حرفياً في تعليمات النظام، وحتى مع الجلسة كاملة. أي أن عادة النموذج، وكل كود Python على الإنترنت يجلب رابطاً بـ `requests`، غلبت القاعدة المكتوبة في كل مكان وضعناها فيه.
- **الطلبان الآخران نجحا في الطرق الأربع:** `argparse` دائماً ولا `match` أبداً، حتى مع آخر ست رسائل فقط، أي دون أي قاعدة في السياق. والسبب أن هذا ما يكتبه النموذج عادة لهذين الطلبين، فلم يكن هناك ما تمنعه القاعدة.

وهذه نتيجة لم نتوقعها عندما صممنا التجربة، ولكنها أصدق من النتيجة التي توقعناها: كنا نريد أن نرى القاعدة تضيع بالقص وتبقى بالتثبيت، فوجدنا أن القاعدة لم تحرك سلوك النموذج في أي طريقة، لا عندما كانت الطلبات توافق عادته ولا عندما كانت تخالفها. ومعنى ذلك أن هندسة السياق لها حد واضح، فهي تضع المعلومة أمام النموذج وتمنع ضياعها، ولكنها لا تضمن أن يطيعها، وخاصة عندما تخالف عادة قوية في بيانات تدريبه. ولذلك فإن القاعدة التي يجب ألا تخالف أبداً، مثل «المكتبة القياسية فقط»، مكانها ليس السياق وحده، وإنما فحص آلي يفشل عندما تخالف، مثل فحص في خط النشر CI يرفض أي استيراد من خارج قائمة مسموحة، أو ملف `requirements.txt` فارغ لا يسمح بتثبيت شيء. وهذا ما فعلته الدالة `violations` في سكربت التجربة نفسها: لم تثق بما قاله النموذج، وفحصت الكود.

![أربعة صفوف لطرق إدخال الجلسة: الجلسة كاملة 2,373 توكناً، وآخر ست رسائل 892، والملخص مع آخر ست رسائل حوالي 970، والقواعد مثبتة مع آخر ست رسائل 948، وفي كل صف ثلاث خانات للطلبات: جلب JSON بالأحمر requests في كل الصفوف، والأمر الرئيسي main بالأخضر argparse، وتوزيع الأوامر بالأخضر دون match، وتحتها ما فقده كل ملخص: ملخص 1.5B أسقط no requests وملخص 3B أسقط قاعدة match](https://arabroot.io/content/images/2026/11/context-engineering-05-compaction.webp)

أربع طرق لإدخال جلسة طويلة في النافذة: الحجم يختلف، والملخص يفقد قواعد مختلفة، والقاعدة التي تخالف عادة النموذج لم تطع في أي طريقة.

## أربعة أشياء تفعلها بالسياق بدل أن ترسل كل شيء

إذا جمعت نتائج التجارب ومقال Anthropic وتوثيق الأدوات، فإن ما تستطيع أن تفعله بالسياق يرجع إلى أربعة أفعال، والشكل التالي يبينها، ثم نشرح كل واحد منها:

![في الأعلى إطار نافذة السياق Context Window فيه مربعات ملونة system وtools وhistory وfiles وجزء أحمر صغير، وتحته أربع بطاقات: اختر Select مع رمز عدسة، لا تحمل المستودع كله وإنما ابحث واقرأ الملف عند الحاجة grep وglob وread_file؛ واكتب خارجها Write مع رمز ورقة، ملاحظات وقائمة مهام في ملف يعود إليه الوكيل NOTES.md وAGENTS.md؛ واضغط Compress، لخص المحادثة القديمة وقص مخرج الأدوات compact؛ واعزل Isolate، وكيل فرعي بنافذة خاصة يرجع بخلاصة subagents](https://arabroot.io/content/images/2026/11/context-engineering-02-moves.webp)

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

### اختر Select: اقرأ عند الحاجة Just-in-time

الطريقة القديمة في أدوات الذكاء الاصطناعي للكود كانت أن تبني فهرساً للمستودع بالمتجهات Embeddings، ثم تسترجع منه أقرب المقاطع إلى السؤال وتلصقها في الطلب، وهي طريقة التوليد المعزز بالاسترجاع RAG التي شرحناها في [مقال RAG أم MCP أم الوكلاء](https://arabroot.io/articles/rag-%D8%A7%D9%85-fine-tuning-%D8%A7%D9%85-mcp-%D8%A7%D9%85-agents/). والطريقة التي تستعملها أغلب وكلاء البرمجة اليوم مختلفة، فالوكيل يحمل في السياق مراجع خفيفة، مثل مسارات الملفات وأسماء الدوال، ثم يستعمل أدوات مثل `grep` و`glob` وقراءة الملف ليجلب ما يحتاجه في اللحظة التي يحتاجه فيها، ومقال Anthropic يسمي هذا «just in time»، ويذكر أن Claude Code يعمل بهذه الطريقة، ملفات `CLAUDE.md` تدخل من البداية، وكل شيء آخر يجلبه بالبحث، وأن هذا يتجنب مشكلة الفهرس القديم الذي لم يتحدث بعد آخر تعديل. والثمن أن البحث أبطأ من الاسترجاع الجاهز، وأن الوكيل قد يبحث في المكان الخطأ، ولذلك فإن ما تكتبه في ملف التعليمات عن أماكن الأشياء غير الواضحة يوفر عليه بحثاً طويلاً.

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

### اكتب خارج النافذة Write

ما يجب أن يبقى طوال الجلسة لا يجب أن يعتمد على بقاء المحادثة، وإنما يكتب في ملف يعود إليه الوكيل، مثل ملف التعليمات `AGENTS.md` الذي يحمل في بداية كل جلسة، أو ملف ملاحظات `NOTES.md` يكتب فيه الوكيل ما وصل إليه وما بقي، أو قائمة مهام To-do يحدثها في كل خطوة. ومقال Anthropic يسمي هذا تدوين الملاحظات المنظم Structured Note-taking، ويذكر مثالاً لوكيل يلعب لعبة طويلة ويحتفظ بملاحظات عن تقدمه عبر آلاف الخطوات. وفي التجربة الرابعة فقد كل ملخص كتبه النموذج قاعدة مختلفة من قواعد الجلسة، وهذا سبب كاف ألا تترك القواعد المهمة لملخص لا تعرف ماذا سيبقي منه، مع أن التجربة نفسها بينت أن وجود القاعدة في النافذة لا يضمن أن يطيعها النموذج.

### اضغط Compress: الملخص وقص المخرجات

الضغط Compaction أن تأخذ محادثة اقتربت من حد النافذة، فتلخصها، ثم تبدأ نافذة جديدة بالملخص. وفي Claude Code يحدث هذا تلقائياً عند الاقتراب من الحد، وتستطيع أن تطلبه بالأمر `/compact` ومعه ما تريد أن يركز عليه، مثل `/compact focus on the auth bug fix`، و[صفحة نافذة السياق](https://code.claude.com/docs/en/context-window?ref=arabroot.io) تشرح ما يبقى بعد الضغط: ملف `CLAUDE.md` في جذر المشروع يقرأ من القرص من جديد، وأوصاف المهارات تبنى من جديد، ونصوص المهارات التي استعملت تعود بحد 5,000 توكن لكل مهارة و25,000 للمجموع، ويعيد قراءة خمسة ملفات على الأكثر من الملفات التي عدلت مؤخراً. أما القواعد التي حملت لمسارات معينة أثناء العمل فتلخص مع باقي المحادثة وقد تضيع، ولذلك يقترح التوثيق أن تنقل القاعدة التي يجب أن تبقى إلى ملف الجذر. والنوع الثاني من الضغط أبسط وأهم في الغالب، وهو أن تقص مخرج الأدوات قبل أن يدخل السياق، كما في التجربة الثالثة، فتوثيق Claude Code نفسه يذكر أن الحد الافتراضي لمخرج أداة MCP واحدة 25,000 توكن، وأنه يعرض تحذيراً إذا تجاوز المخرج 10,000.

### اعزل Isolate: الوكيل الفرعي Subagent

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

## الترتيب أيضاً جزء من السياق: الذاكرة المؤقتة Prompt Caching

حتى الآن تكلمنا عن ماذا يدخل، ولكن الترتيب له ثمن أيضاً، لأن أغلب خدمات النماذج، وOllama نفسه على جهازك، تحتفظ بما حسبته لبداية الطلب، فإذا جاء الطلب التالي ببداية مطابقة حرفاً حرفاً لم تعد قراءتها، وقرأت الجزء الجديد فقط. وفي [دليل الوكيل بنموذج محلي](https://arabroot.io/articles/%D9%88%D9%83%D9%8A%D9%84-%D8%A8%D8%B1%D9%85%D8%AC%D8%A9-%D8%A8%D9%86%D9%85%D9%88%D8%B0%D8%AC-%D9%85%D8%AD%D9%84%D9%8A-%D9%85%D8%B9-ollama-%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D8%AA%D9%88%D9%82%D8%B9/) قسنا ذلك: سؤال المتابعة في المحادثة نفسها أخذ أقل من ثانيتين بينما أخذ السؤال الأول دقيقتين ونصفاً لنموذج 3B. والتجربة الثانية في هذا المختبر مبنية على ذلك عمداً، فهي ترسل الأسئلة الخمسة بعد السياق نفسه دون أي تغيير في بدايته، ولو تغير سطر واحد في أول الطلب بين سؤال وآخر لدفع السيرفر Server ثمن قراءة 2,762 توكناً خمس مرات بدل مرة، وعلى معالج مشغول يقرأ ثمانية توكنات في الثانية فإن هذا فرق بين ست دقائق ونصف ساعة.

ولذلك فإن الأدوات الجيدة ترتب الطلب من الأثبت إلى الأكثر تغيراً: التعليمات الثابتة أولاً، ثم تعريف الأدوات، ثم ملفات التعليمات، ثم المحادثة، ثم الجديد في آخرها، وهذا بالضبط الترتيب الذي رأيناه في طلب Codex. وما يخصك أنت من هذا: كل تغيير في بداية السياق يلغي الذاكرة المؤقتة لكل ما بعده، مثل أن تغير ملف `AGENTS.md` في منتصف الجلسة، أو تضيف سيرفر MCP جديداً، أو تبدل النموذج، فالطلب التالي يدفع ثمن قراءة كل شيء من جديد، وهذا يظهر في الفاتورة إذا كنت تستعمل خدمة سحابية، وفي الانتظار إذا كنت تستعمل نموذجاً محلياً.

## صمم أدواتك بحيث لا تغرق السياق

إذا كنت تكتب أدوات لوكيلك، سواء كانت سيرفر MCP أو أوامر في بيئة التشغيل، فأنت تقرر حجم ما يرجع منها إلى السياق، وهذا جزء من هندسة السياق قد يكون أكبر من كل ما سبق. و[مقال Anthropic عن كتابة الأدوات للوكلاء](https://www.anthropic.com/engineering/writing-tools-for-agents?ref=arabroot.io) المنشور في 11 سبتمبر 2025 يقترح ما يلي:

- **التقسيم إلى صفحات Pagination والتصفية Filtering:** أداة البحث التي ترجع كل النتائج تملأ السياق، والأداة التي ترجع أول عشر نتائج ومعها طريقة لطلب المزيد تترك القرار للوكيل.
- **القص مع إرشاد:** إذا قصصت النتيجة فقل للوكيل ذلك وقل له كيف يضيق البحث، ويذكر المقال أن Claude Code يحد نتيجة الأداة بـ 25,000 توكن افتراضياً.
- **صيغة مختصرة وصيغة مفصلة:** مدخل مثل `response_format` بقيمتين `concise` و`detailed`، فيطلب الوكيل التفاصيل فقط عندما يحتاجها.
- **أسماء ومعرفات مفهومة:** النموذج يفهم الاسم أفضل من المعرف الطويل العشوائي، فأرجع الاسم ومعه المعرف الذي يحتاجه في الأداة التالية.

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

## كيف تطبق الأدوات المعروفة هذا؟

كل أداة تقرر هذه الأشياء الأربعة بطريقتها، والجدول التالي يجمع ما يذكره توثيقها وما رأيناه في المختبر، كما كان في نوفمبر 2026:

| الأداة            | ما يدخل من البداية                                                                              | الاختيار                                                      | الضغط                                           | ما تراه أنت                        |
| ----------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------- | ----------------------------------------------- | ---------------------------------- |
| Codex CLI 0.170.0 | تعليمات ثابتة 3,523 توكناً، و9 أدوات 4,059 توكناً، وقائمة المهارات، وملفات AGENTS.md حتى 32 KiB | أوامر الطرفية Terminal والبحث                                 | ضغط المحادثة عند الحد                           | تحذير في الطرفية عند قطع AGENTS.md |
| Claude Code       | CLAUDE.md أو AGENTS.md، والذاكرة التلقائية، وأسماء أدوات MCP، وأوصاف المهارات                   | grep وglob وقراءة الملفات، والقواعد بالمسارات عند العمل عليها | تلقائي عند الاقتراب من الحد، و/compact مع تركيز | /context و/memory                  |
| Aider             | تعليمات ثابتة، وخريطة المستودع Repo Map، والملفات التي أضفتها                                   | أنت تضيف الملفات، والخريطة تقترح                              | تلخيص المحادثة القديمة                          | /tokens                            |

وشرحنا خريطة المستودع في Aider وكيف تختار ما يظهر للنموذج في [مقال وكلاء البرمجة مفتوحة المصدر](https://arabroot.io/articles/%D9%88%D9%83%D9%84%D8%A7%D8%A1-%D8%A8%D8%B1%D9%85%D8%AC%D8%A9-%D9%85%D9%81%D8%AA%D9%88%D8%AD%D8%A9-%D8%A7%D9%84%D9%85%D8%B5%D8%AF%D8%B1-aider-%D9%88cline-%D9%88openhands/)، وشرحنا في [مقال بيئة تشغيل الوكيل](https://arabroot.io/articles/%D8%A8%D9%8A%D8%A6%D8%A9-%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-%D8%A7%D9%84%D9%88%D9%83%D9%8A%D9%84-harness-%D8%A7%D9%84%D8%AD%D9%84%D9%82%D8%A9-%D9%88%D8%A7%D9%84%D8%B5%D9%84%D8%A7%D8%AD%D9%8A%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%B5%D9%86%D8%AF%D9%88%D9%82-%D8%A7%D9%84%D9%85%D8%B9%D8%B2%D9%88%D9%84/) كيف تقرر بيئة التشغيل ميزانية الدورات Budget ومتى يتوقف الوكيل، وهما جزءان من القرار نفسه.

## أخطاء شائعة

- **إضافة ملفات للاحتياط:** كل ملف لا تحتاجه المهمة هو مشتت، وفي التجربة الثانية خفضت عشرة ملفات عادية إجابات نموذج 1.5B الصحيحة من أربع إلى اثنتين، ولم تؤثر على نموذج 3B، أي أنك تراهن على حجم النموذج كلما أضفت ما لا يلزم.
- **ترك الكود القديم في المستودع:** مجلد `legacy/` أو ملف `_old.py` يجده الوكيل في البحث ويقرؤه، والجملة التي تقول «تجاهله» لم تغير إجابة واحدة للنموذج الصغير في التجربة.
- **لصق المخرج كاملاً:** سجل اختبارات من مئات الأسطر يأخذ آلاف التوكنات ويدفن السطر المهم، فاطلب من الأداة مخرجاً مختصراً، أو قصه قبل أن يدخل.
- **الاعتماد على أن المحادثة تتذكر:** القاعدة المهمة في أول جلسة طويلة قد تقص أو تلخص، فاكتبها في ملف التعليمات أو اطلب من الوكيل أن يكتبها في ملف ملاحظات.
- **الجلسة الواحدة لكل شيء:** المحادثة التي بدأت بإصلاح خطأ ثم انتقلت إلى ميزة جديدة تحمل معها كل ما قرأته للخطأ، فابدأ جلسة جديدة بالأمر `/clear` أو ما يشبهه عندما تتغير المهمة.
- **لوم النموذج أولاً:** قبل أن تقول إن النموذج لا يفهم، انظر ماذا كان في نافذته، فقد يكون الملف الصحيح غير موجود، أو موجوداً مع نسخة قديمة، أو مقطوعاً بإعداد النافذة الافتراضي كما رأينا في دليل الوكيل بنموذج محلي.

## قائمة تحقق قبل أن تلوم النموذج

- هل رأيت ما في السياق فعلاً، بأمر مثل `/context` أو `/tokens` أو بسجل الطلبات؟
- هل الملف الصحيح في السياق، وهل معه نسخة قديمة تشبهه؟
- هل في السياق ملفات لا تحتاجها المهمة؟
- هل مخرج الأدوات مختصر إلى ما يلزم، أم سجل كامل؟
- هل القواعد التي يجب أن تبقى مكتوبة في ملف يحمل في كل جلسة؟
- هل الجلسة ما زالت على المهمة نفسها، أم حان وقت جلسة جديدة؟
- هل نافذة النموذج أكبر من الطلب، أم أن شيئاً يقطع دون رسالة؟

## تدريب عملي

1. في `02_distractors.py` احذف النسخة القديمة واترك الملفات العشرة، ثم قلل عددها إلى ثلاثة: عند أي عدد ترجع الإجابات الصحيحة كما كانت مع الملف وحده؟
2. في `03_tool_output.py` أضف نسخة رابعة من المخرج فيها الفشل في أول السجل بدل آخره، وانظر هل يتغير شيء.
3. في أداتك اليومية شغل الأمر الذي يعرض السياق في بداية جلسة جديدة، واكتب كم توكناً يأخذ كل جزء قبل أن تكتب شيئاً، ثم احذف ما لا تحتاجه، مثل سيرفر MCP لا تستعمله، وقارن.

## الخلاصة

- هندسة السياق هي اختيار ما يدخل نافذة النموذج في كل دورة وترتيبه وما يخرج منها، والهدف أقل عدد من التوكنات يحمل ما يحتاجه النموذج الآن.
- طلب حقيقي من Codex CLI 0.170.0 كان 8,316 توكناً، منها 7 توكنات فقط لسؤالك، و4,059 لتعريف الأدوات، و3,523 لتعليمات الوكيل.
- البحث عن قيمة باسمها الحرفي نجح 12 مرة من 12 في أول السياق ومنتصفه وآخره، لأن المطابقة الحرفية سهلة، كما يقول تقرير Chroma عن تآكل السياق.
- عشرة ملفات لا علاقة لها بالسؤال خفضت إجابات نموذج 1.5B الصحيحة من أربع إلى اثنتين، ولم تؤثر على نموذج 3B، والجملة التي تقول إن الكود القديم ميت لم تغير شيئاً.
- مخرج الاختبارات الكامل مع السجلات كان حوالي 3,880 توكناً وجزء الفشل وحده حوالي 210، بالدقة نفسها تقريباً، وبزمن قراءة أقل بعشرين ضعفاً.
- ملخص الجلسة الذي كتبه كل نموذج أسقط قاعدة مختلفة، والقاعدة التي تخالف عادة النموذج، أي «لا requests»، لم تطع في أي طريقة، حتى وهي مثبتة في تعليمات النظام.
- الأفعال الأربعة: اختر ما يدخل عند الحاجة، واكتب ما يجب أن يبقى في ملف، واضغط المحادثة ومخرج الأدوات، واعزل القراءة الكثيرة في وكيل فرعي، وما يجب ألا يخالف أبداً يحتاج فحصاً آلياً لا سطراً في السياق.

وفي المقالات القادمة من هذه المرحلة بإذن الله نتحدث عن كل جزء من السياق على حدة: ملف تعليمات المشروع، والمهارات التي تحمل عند الحاجة، وسيرفرات MCP التي تضيف الأدوات، والمواصفة Spec التي تكتب قبل الكود:

[![](https://arabroot.io/content/images/2026/11/agents-md-cover-cover.webp)دليلملف تعليمات المشروع AGENTS.md وCLAUDE.md: ماذا تكتب فيهأين تضع ملف تعليمات الوكيل، وكيف تجمعه Codex وClaude Code وCopilot من المجلدات، ومتى يقطع دون أن يعرف النموذج، وماذا يتغير فعلاً عندما تكتبه.](https://arabroot.io/articles/%D9%85%D9%84%D9%81-%D8%AA%D8%B9%D9%84%D9%8A%D9%85%D8%A7%D8%AA-%D8%A7%D9%84%D9%85%D8%B4%D8%B1%D9%88%D8%B9-agents-md-%D9%88claude-md-%D9%85%D8%A7%D8%B0%D8%A7-%D8%AA%D9%83%D8%AA%D8%A8-%D9%81%D9%8A%D9%87/)[![](https://arabroot.io/content/images/2026/11/agent-skills-cover-cover.webp)دليلالمهارات Agent Skills: تعليمات يحملها الوكيل عند الحاجةكيف تكتب مهارة حسب المواصفة المفتوحة، وكيف يعرضها Codex على النموذج، وهل يختار نموذج صغير المهارة الصحيحة من وصفها ويتبع ما فيها.](https://arabroot.io/articles/%D8%A7%D9%84%D9%85%D9%87%D8%A7%D8%B1%D8%A7%D8%AA-agent-skills-%D8%AA%D8%B9%D9%84%D9%8A%D9%85%D8%A7%D8%AA-%D9%8A%D8%AD%D9%85%D9%84%D9%87%D8%A7-%D8%A7%D9%84%D9%88%D9%83%D9%8A%D9%84-%D8%B9%D9%86%D8%AF-%D8%A7%D9%84%D8%AD%D8%A7%D8%AC%D8%A9/)[![](https://arabroot.io/content/images/2026/11/mcp-for-developers-cover-cover.webp)دليلMCP للمطورين: اربط وكيلك بقاعدة البيانات والتذاكر والتوثيقكيف تضيف سيرفر MCP إلى Codex وClaude Code وCursor، وكيف تكتب سيرفراً للفريق يقرأ قاعدة البيانات دون أن يكتب فيها، وكم يكلف كل سيرفر من سياق الوكيل.](https://arabroot.io/articles/mcp-%D9%84%D9%84%D9%85%D8%B7%D9%88%D8%B1%D9%8A%D9%86-%D8%A7%D8%B1%D8%A8%D8%B7-%D9%88%D9%83%D9%8A%D9%84%D9%83-%D8%A8%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-%D8%A7%D9%84%D8%A8%D9%8A%D8%A7%D9%86%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%AA%D8%B0%D8%A7%D9%83%D8%B1/)[![](https://arabroot.io/content/images/2026/11/spec-driven-development-cover-cover.webp)دليلالتطوير من المواصفة Spec-driven Development: الخطة قبل الكودكيف تعمل Spec Kit من GitHub، وما الفرق بين المواصفة والخطة والمهام، وماذا حدث عندما بنى نموذج محلي صغير الميزة نفسها بثلاث طرق تحت اختبارات قبول لم يرها.](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B7%D9%88%D9%8A%D8%B1-%D9%85%D9%86-%D8%A7%D9%84%D9%85%D9%88%D8%A7%D8%B5%D9%81%D8%A9-spec-driven-development-%D8%A7%D9%84%D8%AE%D8%B7%D8%A9-%D9%82%D8%A8%D9%84-%D8%A7%D9%84%D9%83%D9%88%D8%AF/)

## سجل التحديثات

- 20 نوفمبر 2026: كتابة المقال، وتشغيل المختبر على Ollama 0.40.13 بنموذجي qwen2.5-coder بحجمي 1.5B و3B، وقياس طلب حقيقي من Codex CLI 0.170.0.