بدء مشروع بـ /init وAGENTS.md
امنح Bob سياقًا دائمًا للمشروع عبر المحادثات والأوضاع باستخدام /init، الذي يُولّد ملفات AGENTS.md تلقائيًا.
الأمر /init يفحص مشروعًا ويُولّد ملف ملخص منظّم يُسمى AGENTS.md يستخدمه Bob كسياق دائم في كل محادثة. الأمر /init هو الطريقة التي تمنح بها Bob معرفةً بهيكل المشروع واتفاقياته وقاعدة الكود، دون أن يضطر Bob لقراءة كل ملف في بداية كل تفاعل.
نماذج اللغة الكبيرة عديمة الذاكرة. كل محادثة جديدة تبدأ بلا ذاكرة للتفاعلات السابقة. بدون سياق صريح للمشروع، يجب على Bob اكتشاف قاعدة الكود في كل تفاعل جديد، وهو أمر غير فعّال ويصبح غير عملي على نطاق واسع.
في هذا الدرس، تُهيّئ Bob في المجلد الجذري لتطبيق عرض توضيحي، وتستكشف السياق الذي يكتسبه Bob حول التطبيق، وتتعلم بنية Bob للسياق الخاص بالوضع.
المتطلبات المسبقة
لإتمام هذا الدرس، تحتاج إلى ما يلي:
- إذا لم يكن لديك بالفعل، استنسخ كود عرض Galaxium Travels التوضيحي. يقوم أمر الاستنساخ أيضًا بالانتقال إلى
bob-learning-path-branchالذي يحتوي على الكود الذي تستخدمه في الدروس.
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels- Bob IDE مع فتح كود عرض Galaxium Travels التوضيحي.
- على الرغم من أنه غير مطلوب، فكّر في إتمام درس البدء السريع للتعرف على واجهة Bob وميزاته.
تشغيل /init
لتهيئة سياق المشروع، افتح الشريط الجانبي للدردشة الوكيلية في Bob IDE، وانتقل إلى وضع Code في الزاوية السفلية اليمنى من الشاشة.
أدخل الأمر /init في الدردشة الوكيلية. إذا كانت الموافقة التلقائية مُعطَّلة، سيطلب Bob إذنك لقراءة الملفات وكتابة ملفات AGENTS.md:
/init
يقرأ Bob الملفات ذات الصلة في المشروع. ثم يُولّد Bob الملف الرئيسي AGENTS.md في المجلد الجذري لـ Galaxium Travels. ينشئ Bob أيضًا مجلد .bob يحتوي على AGENTS.md لكل وضع.
استكشاف ملفات AGENTS.md
تعمل ملفات AGENTS.md كوثائق إعداد لـ Bob. AGENTS.md هو ملخص موجز وقابل للتنفيذ يوفر لـ Bob كل ما يحتاجه لفهم هيكل المشروع واتفاقياته.
يمكنك تحديد موقع ملف AGENTS.md الرئيسي في أسفل مستكشف ملفات Bob على الجانب الأيسر. افتح الملف لقراءة محتوياته.
يحتوي ملف AGENTS.md عادةً على المكوّنات التالية:
- نظرة عامة على المشروع وغرضه
- هيكل المجلد ومواقع الملفات الرئيسية
- مكدس التقنيات والتبعيات
- أنماط المعمارية والاتفاقيات
- سير عمل التطوير
يُطبّق Bob ملف AGENTS.md تلقائيًا على المحادثات الجديدة ويتعلم سياق المشروع.
ملفات AGENTS.md الخاصة بالوضع
بالإضافة إلى ملف AGENTS.md الرئيسي في المجلد الجذري لـ Galaxium Travels، يُولّد /init ملفات سياق خاصة بالوضع في مجلد .bob لكل وضع مدمج:
| الملف | الوضع |
|---|---|
.bob/rules-code/AGENTS-code.md | وضع Code |
.bob/rules-plan/AGENTS-plan.md | وضع Plan |
.bob/rules-ask/AGENTS-ask.md | وضع Ask |
.bob/rules-advanced/AGENTS-advanced.md | وضع Advanced |
صيانة ملفات AGENTS.md
أعد تشغيل /init بعد إجراء التعديلات التالية على المشروع:
- إضافة وحدات أو خدمات جديدة
- تغيير هيكل المجلد
- اعتماد تقنيات أو أطر عمل جديدة
- إعداد أعضاء فريق جدد سيستخدمون Bob
الخطوات التالية
في هذا الدرس، تعلمت أن نماذج اللغة الكبيرة عديمة الذاكرة وأن /init يحل هذه المشكلة بتوليد AGENTS.md. انتقل إلى كتابة أوامر فعّالة لتحسين جودة تفاعلاتك مع Bob.