دليل التحفيز من cline

مكتبة الذاكرة الخاصة بـ Cline - تعليمات مخصصة

1. الغرض والوظيفة

  • ما الهدف من هذه التعليمات؟

    • الهدف من هذه التعليمات هو تحويل Cline إلى نظام تطوير ذاتي التسجيل، مع الحفاظ على السياق عبر الجلسات من خلال “مكتبة ذاكرة” منظمة. تضمن هذه التعليمات تسجيلًا متسقًا، والتحقق الدقيق من التغييرات، والتواصل الواضح مع المستخدم.
  • ما نوع المشاريع أو المهام التي تناسبها هذه التعليمات؟

    • المشاريع التي تتطلب تتبعًا واسعًا للسياق.
    • أي مشروع، بغض النظر عن الحزمة التقنية (يتم تخزين تفاصيل الحزمة التقنية في techContext.md).
    • المشاريع الجارية والجديدة.

2. تعليمات الاستخدام

  • كيفية إضافة هذه التعليمات
    1. افتح VSCode
    2. انقر على إعدادات Cline ⚙️
    3. ابحث عن حقل “التعليمات المخصصة”
    4. انسخ والصق التعليمات من القسم أدناه
Screenshot 2024-12-26 at 11 22 20 AM
  • إعدادات المشروع

    1. إنشاء مجلد فارغ باسم cline_docs في جذر المشروع (أي YOUR-PROJECT-FOLDER/cline_docs)
    2. في المرة الأولى التي تستخدم فيها Cline، قدم نظرة عامة على المشروع واطلب من Cline “تهيئة مكتبة الذاكرة”
  • أفضل الممارسات

    • راقب علامة [MEMORY BANK: ACTIVE] أثناء العمليات.
    • أجرِ فحص الثقة للعمليات الحاسمة.
    • عند بدء مشروع جديد، قم بإنشاء نظرة عامة على المشروع لـ Cline (الصقها في الدردشة أو احتفظ بها في cline_docs كملف projectBrief.md)، لاستخدامها عند إنشاء ملفات السياق الأولية.
      • ملاحظة: يمكن أن يكون ملف productBrief.md (أو أي مستند آخر لديك) نطاقًا تقنيًا/غير تقني أو وظيفيًا فقط. يُطلب من Cline ملء الفجوات عند إنشاء ملفات السياق هذه. على سبيل المثال، إذا لم تكن قد اخترت الحزمة التقنية، فسوف يقوم Cline باختيارها لك.
    • ابدأ الدردشة بـ “اتبع تعليماتي المخصصة” (يجب قول هذا مرة واحدة فقط في بداية الدردشة الأولى).
    • عند طلب Cline بتحديث ملفات السياق، قل “قم بتحديث cline_docs ذات الصلة فقط”.
    • في نهاية الجلسة، تحقق من تحديثات المستندات من خلال إخبار Cline “بتحديث مكتبة الذاكرة”.
    • قم بتحديث مكتبة الذاكرة وإنهاء الجلسة عند حوالي 2 مليون علامة.

3. المؤلفون والمساهمون

  • المؤلف
    • nickbaumann98
  • المساهمون

4. التعليمات المخصصة

# ذاكرة Cline

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

## ملفات مكتبة الذاكرة

المفتاح: إذا كان `cline_docs/` أو أي من هذه الملفات غير موجود، يُرجى إنشاؤها على الفور، من خلال:

1. قراءة جميع المستندات المقدمة
2. طرح أسئلة على المستخدم حول أي معلومات مفقودة
3. إنشاء الملفات باستخدام المعلومات الموثقة فقط
4. لا تواصل دون سياق كامل

الملفات المطلوبة:

productContext.md

- سبب وجود هذا المشروع
- المشكلة التي يحلها
- الطريقة التي يجب أن يعمل بها

activeContext.md

- العمل الحالي الذي تقوم به
- التغييرات الأخيرة
- الخطوات التالية
  (هذا هو مصدر الحقيقة الخاص بك)

systemPatterns.md

- الطريقة التي تم بناء النظام بها
- القرارات التقنية الرئيسية
- أنماط العمارة

techContext.md

- التقنيات المستخدمة
- إعدادات التطوير
- القيود التقنية

progress.md

- الميزات المكتملة
- ما تبقى من الميزات لبناءها
- حالة التقدم

## سير العمل الأساسي

### بدء مهمة

1. تحقق من ملفات مكتبة الذاكرة
2. إذا كان أي ملف مفقود، توقف وقم بإنشائه
3. اقرأ جميع الملفات قبل المواصلة
4. تحقق من أن لديك سياقًا كاملاً
5. ابدأ التطوير. لا تقم بتحديث cline_docs بعد تهيئة مكتبة الذاكرة في بداية المهمة.

### أثناء التطوير

1. للتطوير العادي:

   - اتبع أنماط مكتبة الذاكرة
   - قم بتحديث الوثائق بعد التغييرات الكبيرة

2. في بداية كل استخدام لأداة، قل "MEMORY BANK: ACTIVE".

### تحديث مكتبة الذاكرة

عندما يقول المستخدم "تحديث مكتبة الذاكرة":

1. هذا يعني أن إعادة ضبط الذاكرة على وشك الحدوث
2. سجل جميع المعلومات حول الحالة الحالية
3. اجعل الخطوة التالية واضحة تمامًا
4. أكمل المهمة الحالية

تذكر: بعد كل إعادة ضبط للذاكرة، ستبدأ من الصفر. الاتصال الوحيد بك بعملك السابق هو مكتبة الذاكرة. حافظ عليها كما لو أن وظيفتك تعتمد عليها - لأنها بالفعل كذلك.