تقييس سلوك Bob
قيّس سلوك Bob عبر فريقك باستخدام ملفات قواعد على مستوى المشروع تُوجِّه Bob لتوثيق كوده وتذكر إجراءاته السابقة.
قواعد Bob هي ملفات نصية عادية تُعرِّف تعليمات تُطبَّق على كل محادثة Bob. يُخزِّن Bob القواعد كملفات في مجلد مخصص داخل المشروع أو على مستوى المستخدم العام، ويُضمِّن تلقائياً محتوى كل ملف قواعد في كل محادثة عبر جميع الأوضاع. حقن القاعدة يتيح للفرق والمطورين الأفراد تطبيق معايير الترميز وتفضيلات التواصل وقيود سير العمل دون تكرار التعليمات في كل طلب.
القواعد على مستوى المشروع في galaxium-travels/.bob مُصدَّرة مع كودك في نظام التحكم بالإصدار، مما يعني:
- تنتشر القواعد تلقائياً إلى جميع أعضاء الفريق الذين يستنسخون المستودع.
- تمر التغييرات على القواعد عبر عملية مراجعة الكود العادية.
- تاريخ القواعد مُتتبَّع في git.
في هذا الدرس، ستُخبر 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. - مع أنه غير مطلوب، فكر في إكمال درس البدء السريع للتعرف على واجهة Bob وميزاته.
- Python أو Python 3. يمكنك تنزيل Python من الموقع الرسمي.
إنشاء ملف قواعد Bob مخصص
أمر /init في Bob ينشئ مجلد .bob مع ملفات AGENTS.md لكل وضع Bob مما يُوجِّه سلوك Bob في كل وضع. أنشئ قواعدك المخصصة بإضافة ملف جديد إلى مجلد rules. سيقرأ Bob محتوى ملف القواعد، مما يعني أن التعليمات التي تضيفها ستُطبَّق على جميع التفاعلات مع Bob.
إنشاء مجلد القواعد
إذا لم يكن مجلد rules موجوداً بالفعل في .bob، أنشئه.
إنشاء قواعد Bob المخصصة
في ملف basic_rules.md، أنشئ قواعد مخصصة بإضافة النص التالي:
إضافة قاعدة معيار التوثيق
Always include concise JSDoc strings for every public function.قاعدة معيار التوثيق تضمن أن Bob يُولِّد توثيقاً متسقاً كلما كتب Bob أو عدّل الوظائف العامة، بغض النظر عن المهمة.
إضافة قاعدة أسلوب التواصل
Be very concise in your wording.قاعدة أسلوب التواصل تتحكم في طريقة صياغة Bob للردود والتعليقات، وهي مفيدة للفرق التي تفضل المخرجات الموجزة والمباشرة على التفسيرات التفصيلية.
إضافة قاعدة المونولوج الداخلي
Write a summary of every interaction into the folder `internal-monologue/`.
Name the file starting with a timestamp, followed by a concise description of the interaction.
Example: 2026-01-15_update-readme.mdالمونولوج الداخلي ينتج سجلاً دائماً لكل ما فعله Bob عبر جميع المحادثات.
فوائد المونولوج الداخلي تشمل:
- مسار التدقيق: سجل بالتغييرات التي أجراها Bob ومتى.
- الاستمرارية بين الجلسات: يمكن لـ Bob الرجوع إلى مجلد المونولوج الداخلي في المحادثات المستقبلية لفهم العمل السابق.
- شفافية الفريق: في المستودعات المشتركة، يُظهر المونولوج ما فعله أعضاء الفريق المختلفون مع Bob.
بعد إضافة جميع القواعد، سيبدو ملف basic_rules.md كالتالي:
اختبار القواعد
افتح الشريط الجانبي للدردشة الذكية، بدّل إلى وضع Code، ونفّذ الطلب التالي لجعل Bob يُعدِّل README.md. قد يقدم Bob اقتراحات مثل تحسين استكشاف الأخطاء وإصلاحها، أو إعادة هيكلة كاملة، أو إصلاح الأخطاء. يمكنك اختيار الاقتراح الأنسب لرؤيتك لـ README.
Update the readmeيُحدِّث Bob README.md وينشئ مجلداً يسمى internal-monologue مع ملف يُظهر لك التحديثات التي أجراها على README.
الخطوات التالية
في هذا الدرس، تعلمت كيف تتيح قواعد Bob تعريف تعليمات دائمة تُطبَّق عبر كل محادثة ووضع. القواعد على مستوى المشروع مُصدَّرة مع كودك، لذا يشترك فريقك في نفس المعايير تلقائياً. نمط المونولوج الداخلي يمنحك مسار تدقيق لإجراءات Bob عبر جميع الجلسات.
انتقل إلى إضافة قدرات Bob لتعلم إنشاء أوضاع مخصصة تُعرِّف شخصيات متخصصة بتعليمات محددة وصلاحيات أدوات.
إضافة وضع مخصص
وسّع قدرات Bob من خلال إنشاء وضع مدير منتج مخصص يتضمن تعريف دور مصمم خصيصاً، وتعليمات سلوكية، وقيود محددة على الوصول للأدوات.
فحص قاعدة كود غير مألوفة
استخدم IBM Bob لفهم تطبيق غير مألوف بسرعة، مثل غرضه وهيكل المشروع والمعمارية ومكدس التقنيات والمكونات الرئيسية وتغطية الاختبارات ونموذج النشر. يمكنك فعل ذلك دون الاعتماد على توثيق قديم أو انتظار الزملاء.