سياق المشروع

تقرأ الوكلات كودك وملفات التعليمات الموجودة في مستودعك. سياق يجمع بين ملفات الذاكرة هذه وملاحظات المشروع والسياق المُولد والمراجع.

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

ملفات ذاكرة المستودع#

افتح إعدادات ← معرفة ← سياق وابحث تحت مصادر المستودع. تقرأ Coroid هذه الملفات من المستودع المتصل:

• AGENTS.md في جذر المستودع: تعليمات الوكلات العامة
• CLAUDE.md في جذر المستودع: تعليمات Claude
• GEMINI.md في جذر المستودع: تعليمات Gemini
• .cursor/rules: قواعد مشروع Cursor، سواء في مجلد .mdc ملفات القواعد (بما في ذلك المجلدات الفرعية) أو ملف واحد قديم

غالبًا ما تُسمى هذه الملفات بملفات الذاكرة. يتم دمج محتوياتها المفعلة في سياق المشروع الخاص بالوكيل قبل بدء العمل. لا تقتصر أسماؤها على نموذج معين؛ فالمصادر المفعلة تُدمج لاستخدامها من قبل وكلاء Coroid.

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

عند حفظ تعديل في مشروع يحتوي على مستودع GitHub أو GitLab متصل، يتم فتح طلب سحب pull request يحتوي على التغيير، في فرع جديد من فرع أساسي pull request للمشروع. لا تلتزم Coroid بفرعك الافتراضي، وتقرأ الوكلات النسخة الجديدة بمجرد دمج طلب السحب pull request. أما المشروع الذي يستضيفه مستودع Coroid، فيتم إجراء التزام له. يخبرك المحرر بذلك قبل الحفظ.

تقرأ Coroid قواعد Cursor بالطريقة التي يطبقها عليها Cursor:

ملف عادي .md في .cursor/rules يتم تجاهله، لأن Cursor تتجاهله أيضًا. تُحرر قواعد المجلد في المستودع، لذا لا يحتوي الصف على زر تحرير زر.

إنشاء يعني أن الملف لم يُؤكد وجوده في نسخة المستودع الخاصة بـ Coroid. إذا فشلت عملية القراءة، تقدم الصفحة خيار إعادة المحاولة؛ ففشل الوصول لا يعني أن الملف غير موجود. تأكد من أن الملف ملتزم به في فرع المستودع المتصل. بالنسبة لتنفيذ المهام، تقرأ الوكلات نسخة المهمة، لذا فإن أي تغييرات في ملفات التعليمات على ذلك الفرع تؤثر على المهمة.

يمكن لملفات الذاكرة المفعلة استيراد ملفات Markdown من المستودع باستخدام @path، على سبيل المثال @AGENTS.md في CLAUDE.md أو @docs/conventions.md. تُحل المسارات نسبيًا إلى الملف الذي يحتوي على المرجع. تتبع Coroid عمليات الاستيراد المتداخلة، وتوقف عن تكرارها، وتضم كل ملف وكل نص تعليمي مطابق مرة واحدة فقط. تُترك عمليات الاستيراد داخل أمثلة الكود وعناوين البريد الإلكتروني دون تغيير. لا تُحمّل المراجع الخارجية عن المستودع، ولا يمكن للاستيراد تجاوز مصدر مستودع معطّل صراحةً.

فقط المصادر المدرجة يتم اكتشافها تلقائيًا. يمكن تضمين AGENTS.md متداخل من خلال @ استيراد؛ ولا يتم استنتاج نطاق مجلده.

سياقات التطبيق#

تحت سياقات التطبيق، احتفظ بالتعليمات والمراجع المخزنة في Coroid. يمكن تفعيل أو تعطيل الملاحظات اليدوية وسياق المشروع المولد بشكل مستقل عن ملفات المستودع. استخدم هذه المدخلات للمعلومات التي تنتمي إلى خارج نظام Git.

إضافة سياق#

اختر إضافة سياق وأضف مدخلاً. يحتوي كل مدخل على عنوان ونص، ويمكن تحريره أو حذفه لاحقًا.

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

احتفظ بالمدخلات منفصلة ومسماة#

مدخل واحد لكل موضوع، بعنوان يوضح ما يغطيه. يمكن استرجاع "اتفاقيات معالجة الأخطاء" و"الوحدات المتجمدة"؛ أما مدخل واحد باسم "ملاحظات" يحتوي على كليهما فلا يمكن استرجاعه.

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

مراجع#

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

سياق كل مهمة#

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

الحفاظ على دقة المعلومات#

السياق القديم أسوأ من غياب السياق، لأن الوكلاء يعتبرونه مصدرًا موثوقًا. عندما يتغير معيار معين، قم بتحديث المدخل في نفس التغيير الذي يؤثر على الكود.

مراجعة ما هو موجود#

اقرأ سياقك من حين لآخر كما لو كنت مستخدمًا جديدًا. فالمدخلات تتراكم، والمدخلات التي كُتبت خلال عملية ترحيل انتهت قبل عام أصبحت الآن مضللة بشكل كبير.

ذات صلة#

• سياق المشروع (مفهوم)
• اكتب AGENTS.md لوكلائك وCoroid.
• مواصفات
• إنشاء مشروع وتهيئته