السياق: ملف القواعد وMCP

الدرس 20 من 26 في دورة «البرمجة بالإحساس». مجاني، مع رسوم متحركة واختبار.

الوكيل ينسى كل شيء

بالأمس شرحت للوكيل كيف يعمل تطبيق تتبع تمارينك. اليوم جلسة جديدة، وهو لا يعرف شيئًا من جديد. السياق هو كل ما يراه الوكيل الآن: رسالتك والملفات المفتوحة والتعليمات. وبين الجلسات لا يتذكر شيئًا عادةً. الحل بسيط: اكتب الأهم في ملف داخل المشروع. يقرؤه الوكيل بنفسه عند بدء العمل. هذا الملف على يسار الرسم.

ملف AGENTS.md وأقاربه

AGENTS.md صيغة مفتوحة: ملف نصي عادي في جذر المشروع، أي في مجلده الرئيسي. يقرؤه وكلاء كثيرون. أما Claude Code فيقرأ ملفه الخاص CLAUDE.md، ولـ Cursor ملفات قواعد خاصة به. الفكرة واحدة في كل مكان: ورقة تعريف لزميل جديد في الفريق. الامتداد ‎.md يعني Markdown، أي نصًا بسيطًا بعناوين وقوائم. يمكنك أن تحتفظ بملف رئيسي واحد وتشير إليه من الملفات الأخرى.

ماذا تكتب فيه

الأسطر الأربعة في الرسم هي الأساس. المشروع: جملة واحدة عن ماهيته ولمن هو. التشغيل: الأمر الذي يشغّل الموقع على حاسوبك، مثل npm run dev. الاختبارات: أمر الفحص، مثل npm test. أبدًا: مفاتيح في الكود، أو commit مباشرة إلى main. ويمكنك إضافة قواعد أسلوب: «أسماء واضحة، والنصوص بالعربية». إنها مثل ورقة تتركها لزميلك في الوردية التالية: قصيرة ومباشرة.

قصير وصحيح

الملف الطويل بطول عشر شاشات يضر: يستهلك السياق، ويضيع المهم بين التفاصيل. والملف غير الصحيح أسوأ. مكتوب npm start والمشروع يعمل بـ npm run dev؟ سيخطئ الوكيل مرة بعد مرة. غيّرت شيئًا في المشروع؟ حدّث الملف أو اطلب من الوكيل «حدّث AGENTS.md بما فعلناه». ولا مفاتيح فيه أبدًا: الملف موجود في Git، وGit يتذكر كل شيء.

MCP: مقابس للوكيل

MCP (Model Context Protocol) طريقة قياسية لتوصيل الخدمات والأدوات بالوكيل. مثل USB: شكل واحد للمنفذ وأجهزة كثيرة مختلفة. على يمين الرسم ثلاثة مقابس. GitHub: يقرأ الوكيل المهام وPR. قاعدة البيانات: يطّلع على جداول البيانات. المتصفح: يفتح موقعك ويضغط الأزرار بنفسه. كل اتصال من هذا النوع يسمى خادم MCP.

وصّل بحكمة

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

اختبر نفسك

1. لماذا يوجد ملف AGENTS.md في المشروع؟
   الإجابة الصحيحة: يقرؤه الوكيل ليعرف قواعد المشروع. الوكيل ينسى بين الجلسات، وملف القواعد يعطيه الأهم: ما المشروع، وكيف يُشغَّل، وما الممنوع. لا تضع المفاتيح فيه أبدًا: الملف في Git.
2. ما هو MCP؟
   الإجابة الصحيحة: معيار لتوصيل الخدمات بالوكيل. MCP مثل USB للوكيل: GitHub وقاعدة البيانات والمتصفح وأدوات أخرى تتصل بالطريقة نفسها.
3. توصل قاعدة بيانات بالوكيل عبر MCP. ما الطريقة الصحيحة؟
   الإجابة الصحيحة: تمنح أقل الصلاحيات، مثل القراءة فقط. كلما قلّت الصلاحيات قلّ الضرر من خطأ الوكيل أو من أمر مخفي. والنسخة التجريبية أفضل من بيانات المستخدمين الحقيقية.

← خريطة وكلاء الذكاء الاصطناعي الأخطاء البرمجية: نقرأ الخطأ →