يقرأ الوكلاء كودك وملفات التعليمات الموجودة في مستودعك. السياق يجمع بين ملفات الذاكرة تلك مع ملاحظات المشروع والسياق المولد والمراجع.
لمعرفة الأسباب وراء وجود هذه العناصر هنا، اقرأ سياق المشروع في قسم المفاهيم. تغطي هذه الصفحة طريقة إدارته.
ملفات ذاكرة المستودع
افتح إعدادات ← معرفة ← سياق وابحث تحت مصادر المستودع. تقرأ أداة Coroid هذه الملفات من المستودع المتصل:
AGENTS.mdفي مسار جذر المستودع: تعليمات عامة للوكيلCLAUDE.mdفي مسار جذر المستودع: تعليمات ClaudeGEMINI.mdفي مسار جذر المستودع: تعليمات Gemini.cursor/rules: ملف قواعد Cursor المدعوم
غالبًا ما تُسمى هذه الملفات بملفات الذاكرة. يتم تضمين محتوياتها المفعلة في سياق المشروع الخاص بالوكيل قبل بدء العمل. لا تقتصر أسماؤها على نموذج معين؛ فالمصادر المفعلة تُدمج معًا لاستخدامها من قبل وكلاء Coroid.
تظهر الملفات الموجودة بجانب زر تحرير ، مع عدّ عدد الرموز التقديري وخيار للتحكم في ما إذا كان الوكلاء سيستقبلونها أم لا. تظل المصادر مفعلة ما لم تقم بتعطيلها صراحةً. إذا تكررت عدة ملفات أو تناقضت فيما بينها، فاحتفظ بالمصادر التي تريد أن يتبعها الوكلاء مفعلة وعطل الباقية.
إنشاء يعني أن الملف غير موجود في نسخة مستودع Coroid المؤكدة. إذا فشلت عملية القراءة، تقدم الصفحة خيار إعادة المحاولة؛ ففشل الوصول لا يعني غياب الملف. تحقق من أن الملف ملتزم به في فرع المستودع المتصل. بالنسبة لتنفيذ المهمة، يقرأ الوكيل نسخة المهمة، لذا فإن أي تغييرات على ملفات التعليمات في ذلك الفرع تنطبق على المهمة.
يمكن لملفات الذاكرة المفعلة استيراد نصوص Markdown من المستودع باستخدام @path، على سبيل المثال
@AGENTS.md في CLAUDE.md أو @docs/conventions.md. تُحدد المسارات بشكل نسبي بالنسبة للملف الذي يحتوي على المرجع. تتابع أداة Coroid عمليات الاستيراد المتداخلة، وتوقف حدوث الحلقات، وتضمن تضمين كل ملف وكل نص تعليمي مطابق مرة واحدة فقط. تُترك محتويات أمثلة الكود وعناوين البريد الإلكتروني دون تغيير. لا يتم تحميل المراجع الخارجية عن المستودع، ولا يمكن للاستيراد تجاوز مصدر مستودع معطل صراحةً.
يتم اكتشاف مصادر الجذر المدرجة فقط تلقائيًا. أما الملفات المتداخلة AGENTS.md والملفات الفردية .cursor/rules/*.mdc فيمكن تضمينها عبر استيراد @ ؛ حيث لا يتم استنتاج نطاق الدليل تلقائيًا.
سياقات التطبيق
تحت قسم سياقات التطبيق، يمكن تخزين التعليمات والمراجع في Coroid. ويمكن تفعيل أو تعطيل الملاحظات اليدوية وسياق المشروع المولد بشكل مستقل عن ملفات المستودع. استخدم هذه العناصر للمعلومات التي تنتمي إلى خارج نظام Git.
إضافة سياق
اختر إضافة سياق وأضف عنصرًا جديدًا. يحتوي كل عنصر على عنوان ونص، ويمكن تعديله أو حذفه لاحقًا.
العناصر الجيدة قصيرة ومحددة ودائمة. تنتمي إلى هذه الفئة قرارات الهندسة والتقاليد الأسلوبية وعقود API وحدود المسؤولية والقيود الصريحة. أما سرد عملية التوظيف وأي معلومات واضحة بالفعل من المستودع فلا تنتمي إلى هذه الفئة.
احتفظ بالعناصر منفصلة ومسماة
عنصر واحد لكل موضوع، مع عنوان يوضح محتواه. يمكن استرجاع عناوين مثل "اتفاقيات معالجة الأخطاء" و"الوحدات المتجمدة"؛ أما العنصر الواحد المسمى "ملاحظات" الذي يحتوي على كليهما فلا يمكن استرجاعه.
وهذا أمر مهم لأن السياق يُحمّل بشكل انتقائي بناءً على العمل المطلوب — انظر مهارات تدريجية. فالعناصر المنفصلة جيدًا تسمح بتحميل العنصر المناسب للمهمة المناسبة.
مراجع
بالإضافة إلى المدخلات المكتوبة، يمكنك إرفاق مراجع — وهي روابط ووثائق تشير إلى مواد موجودة في أماكن أخرى. استخدم هذه المراجع عندما يكون النسخة الأصلية من المحتوى موجودة في ويكي أو أداة تصميم، ولا ترغب في وجود نسخة ثانية قد تتقادم مع الوقت.
سياق كل مهمة على حدة
ينطبق سياق المشروع على جميع عناصر المشروع. أما المواد المتعلقة بجزء معين من العمل — مثل تذكرة، تقرير عميل، أو وثيقة تصميم — فيجب إرفاقها بتلك المهمة تحديدًا. فالملاحظات الخاصة بالمهمة المخزنة في سياق المشروع ستتحول إلى ضجيج في جميع المهام اللاحقة.
الحفاظ على دقة المعلومات
السياق القديم أسوأ من غياب السياق، لأن الوكلات تعتبره مصدرًا موثوقًا به. عندما يتغير معيار ما، يجب تحديث الإدخال في نفس التغيير الذي يطرأ على الكود.
مراجعة ما هو موجود
اقرأ محتوى السياق من حين لآخر كما لو كنت مستخدمًا جديدًا. فالإدخالات تتراكم، والإدخالات التي تم كتابتها خلال عملية ترحيل انتهت قبل عام قد تصبح الآن مضللة بشكل كبير.