بدء مشروع بـ /init وAGENTS.md في Bob Shell
شغّل أمر /init في Bob Shell لتوليد AGENTS.md، ملف سياق المشروع الذي يحمّله Bob في كل محادثة، وتعلّم كيفية إبقاء هذا السياق محدّثًا.
يفحص أمر /init المشروع ويولّد ملف ملخص منظّم يُسمى AGENTS.md يستخدمه Bob كسياق دائم في كل محادثة. أمر /init هو الطريقة التي تمنح بها Bob معرفة بهيكل المشروع وأعرافه وقاعدة الكود، دون الحاجة إلى أن يعيد Bob قراءة كل ملف في بداية كل تفاعل.
النماذج اللغوية الكبيرة عديمة الحالة. كل محادثة جديدة تبدأ بلا ذاكرة للتفاعلات السابقة. بدون سياق صريح للمشروع، يجب على Bob اكتشاف قاعدة الكود مع كل تفاعل جديد، وهو أمر غير فعّال ويصبح غير عملي على نطاق واسع.
في هذا الدرس، ستهيّئ Bob Shell في المجلد الجذر لتطبيق تجريبي، وتستكشف السياق الذي يكتسبه Bob حول التطبيق، وتتعلم كيف يحمّل Bob Shell ملفات AGENTS.md.
المتطلبات المسبقة
لإكمال هذا الدرس، تحتاج إلى ما يلي:
- إذا لم يكن لديك بالفعل، استنسخ كود Galaxium Travels التجريبي. أمر الاستنساخ يسحب أيضًا فرع
bob-learning-path-branchالذي يحتوي على الكود الذي تستخدمه في الدروس.git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels - رغم أنه ليس مطلوبًا، فكّر في قراءة بدء جلسة تفاعلية للتعرف على واجهة Bob Shell وميزاته.
تشغيل Bob Shell في المشروع
انتقل إلى المجلد الجذر لـ Galaxium Travels:
cd galaxium-travelsابدأ جلسة تفاعلية:
bob chat --mode agentالعلامة --mode agent تبدأ الجلسة في وضع Agent، الذي يمتلك الأدوات التي يحتاجها Bob لقراءة الملفات وكتابة AGENTS.md.
إذا سألك Bob Shell عما إذا كنت تثق بالمجلد، ثق به حتى يتمكن Bob من العمل في المشروع. لمعرفة المزيد، راجع المجلدات الموثوقة.
توليد AGENTS.md بـ /init
أدخل أمر /init عند الموجه:
/initيقرأ Bob الملفات ذات الصلة في المشروع.
عندما يطلب Bob استخدام أداة، مثل قراءة الملفات أو كتابة AGENTS.md، يظهر مربع حوار الموافقة. اختر Approve لكل طلب.
يولّد Bob الملف الرئيسي AGENTS.md في المجلد الجذر لـ Galaxium Travels. كما يولّد ملفات سياق خاصة بالوضع في .bob/rules-agent/AGENTS.md و.bob/rules-ask/AGENTS.md و.bob/rules-plan/AGENTS.md.
استكشاف ملفات AGENTS.md
ملف AGENTS.md هو وثائق تأهيل لـ Bob. إنه ملخص موجز وقابل للتنفيذ يوفر كل ما يحتاجه Bob لفهم هيكل المشروع وأعرافه.
اطلب من Bob أن يريك الملف:
Show me the contents of @AGENTS.mdرمز @ يُشير إلى ملف في مشروعك، لذلك يقرأه Bob قبل الرد. يمكنك أيضًا فتح طرفية أخرى وعرض الملف مباشرةً:
cat AGENTS.mdيحتوي ملف AGENTS.md عادةً على المكونات التالية:
- نظرة عامة على المشروع وهدفه
- هيكل المجلدات ومواقع الملفات الرئيسية
- حزمة التقنيات والتبعيات
- الأنماط والأعراف المعمارية
- سير عمل التطوير
لرؤية كل ملف أنشأه /init، شغّل git status في مجلد Galaxium Travels:
git statusكيف يحمّل Bob Shell ملفات AGENTS.md
يحمّل Bob Shell تلقائيًا ملفات السياق مثل AGENTS.md في بداية كل مهمة.
- السياق العالمي: يُطبَّق
~/.bob/AGENTS.mdعلى جميع المشاريع. - سياق المشروع: يُطبَّق
AGENTS.mdفي مجلد جذر المشروع والمجلدات الأصلية على المشروع. - السياق المحلي: يُطبَّق
AGENTS.mdفي المجلدات الفرعية على تلك المجلدات الفرعية، للتعليمات الخاصة بالمكونات.
لمنح Bob تعليمات لوضع واحد، أضف قواعد خاصة بالوضع في مجلدات .bob/rules-<mode>/، مثل .bob/rules-plan/ لوضع Plan.
صيانة ملفات AGENTS.md
أعد تشغيل /init بعد التغييرات التالية:
- إضافة وحدات أو خدمات جديدة
- تغيير هيكل المجلدات
- اعتماد تقنيات أو أطر عمل جديدة
- تأهيل أعضاء فريق جدد يستخدمون Bob
يمكنك أيضًا تعديل AGENTS.md يدويًا لإضافة سياق لا تلتقطه مسح Bob الآلي، مثل قواعد العمل أو أعراف النشر أو الممارسات الخاصة بالفريق. احرص على إيداع AGENTS.md في نظام التحكم بالإصدار حتى يشترك فريقك في نفس السياق.
الخطوات التالية
في هذا الدرس، تعلمت ما يلي:
- النماذج اللغوية الكبيرة عديمة الحالة. تشغيل أمر
/initيحل هذه المشكلة عن طريق توليدAGENTS.md، وهو ملف سياق دائم يقرأه Bob في بداية كل محادثة. - أعد تشغيل
/initبعد التغييرات الرئيسية في المشروع للحفاظ على السياق محدّثًا.
انتقل إلى كتابة أوامر فعّالة لـ Bob Shell لتتعلم كيفية كتابة أوامر تُنتج بشكل موثوق المخرجات التي تريدها.