التخطيط للميزات المعقدة وتنفيذها
استخدم وضع Plan في IBM Bob لتحديد نطاق الميزات المعقدة ومراجعتها وتنفيذها باستخدام وكيل برمجة بالذكاء الاصطناعي. تعلّم كتابة طلب للتخطيط وتحسين الخطة المُولّدة وتشغيل التنفيذ في وضع Agent.
في هذا الدرس، تستخدم وضع Plan في Bob لإنشاء خطة تنفيذ منظمة لإضافة فئات مقاعد إلى التطبيق التجريبي Galaxium Travels. ثم توافق على الخطة وتدع Bob ينفذ الميزة عبر طبقات الواجهة الأمامية والواجهة الخلفية وقاعدة البيانات.
يوضح لك الدرس كيفية كتابة طلب تخطيط فعّال، وما الذي يجب مراجعته في الخطة المُولّدة، وكيفية تحسين الخطة قبل أن يكتب Bob أي كود.
المتطلبات المسبقة
لماذا تستخدم وضع Plan
Bob وكيل مستقل. عند استخدام طلب مبهم، يملأ الفجوات بافتراضاته الخاصة. قد لا تطابق هذه الافتراضات نيتك، حتى لو كانت صحيحة من الناحية التقنية.
عند إنشاء خطة، ينشئ Bob مجموعة ملفات Markdown تصف النطاق وقرارات المعمارية وخطوات التنفيذ المرتبة. ولأن الخطة منفصلة عن التنفيذ، يمكنك قراءتها ومناقشتها وتحسينها قبل أن يكتب Bob أي كود.
إعداد البيئة
استنسخ الكود التجريبي Galaxium Travels. يستنسخ الأمر كذلك الفرع bob-learning-path-branch الذي يحتوي على الكود المستخدم في الدروس.
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travelsفي Bob، انقر على File ثم Open Folder.
انتقل إلى الدليل galaxium-travels الذي استنسخته وافتحه.
تهيئة Bob في مشروعك
شغّل /init في لوحة دردشة Bob لكي ينشئ Bob ملف AGENTS.md في الجذر وملفات قواعد AGENTS.md.
يعرّف ملف AGENTS.md الجذري Bob بالبنية العامة للمشروع واتفاقياته وأهدافه، كي يكتب كودًا ملائمًا للمشروع. وبدونه يبدأ Bob من البداية في كل مرة لأنه بلا حالة دائمة.
تنشئ ملفات القواعد في .bob ملف AGENTS.md لكل وضع من أوضاع Bob: Agent وPlan وAsk. لكل وضع مجموعة قواعد مختلفة توجه سلوك Bob فيه.
/initسيطلب Bob إذنك لإنشاء ملفات AGENTS.md. انقر على Approve todo tools for task لإنشائها.
كيفية كتابة طلب Plan
يصبح الطلب الذي تكتبه في وضع Plan المواصفة التي يعمل Bob بناءً عليها. ينتج الطلب المبهم خطة مبهمة. قبل الكتابة، أجب عن هذه الأسئلة الأربعة:
- ما الذي تفعله الميزة، وما الذي لا تفعله؟ يمنع النطاق الصريح Bob من إضافة عمل لم تطلبه.
- ما الطبقات التي تمسها الميزة؟ مثل واجهة المستخدم وAPI وقاعدة البيانات.
- ما القيود المطبقة؟ حدود عدد الملفات واتفاقيات التسمية ومتطلبات التوافق مع الإصدارات السابقة وأي شيء آخر يجب أن يعامله Bob بوصفه غير قابل للتفاوض.
- كيف يبدو الإنجاز؟ معيار قبول ملموس. مثل: «يمكن للمستخدم اختيار Economy أو Business أو Galaxium عند الحجز»؛ فهذا يمنح Bob هدفًا واضحًا.
إنشاء خطة
استخدم وضع Plan لإنشاء خطة يتبعها Bob عند تنفيذ ميزة فئات المقاعد.
فتح الشريط الجانبي لدردشة الوكيل
إذا كانت واجهة الدردشة مغلقة، فافتحها بالنقر على أيقونة Bob بجوار شريط التنقل أو استخدم الاختصار Option + Command + B على Mac أو Ctrl + Alt + B على Windows.
إنشاء الخطة
شغّل الطلب التالي في حقل الإدخال. يطبق مبادئ تحديد النطاق الواردة في قسم كيفية كتابة طلب Plan: يسمي الطبقات المطلوب تغييرها، ويضع حدًا لعدد الملفات، ويستثني لوحة تحكم المشرف، ويذكر معيار قبول.
سيطلب Bob الإذن باستخدام أدوات المهارات والوكلاء الفرعيين ليشغّل مهارة Create plan. انقر على Approve skill tools for task وApprove subagent tools for task للموافقة على الطلب.
I want to add seat classes to Galaxium Travels. Passengers should be able to choose Economy, Business, or Galaxium class when booking a flight.
Scope:
- Update the booking UI to show a seat class selector
- Update the back-end booking API to accept and store the selected class
- Update the database schema to add a seat_class column to the bookings table
- Do not add admin dashboard changes — that is out of scope
Constraints:
- Create a folder called `plans` in the galaxium-travels folder
- Do not create more than three plan files
- Keep the database change backward compatible
Done when: A user can select a seat class during booking and the selected class is saved and displayed in their booking confirmation.تعرض لقطة الشاشة التالية Bob وهو يطرح أسئلة توضيحية لفهم نيتك. قد تختلف أسئلتك حسب صياغة طلبك. أجب عن الأسئلة أو اطلب من Bob اختيار أفضل الخيارات.
عند انتهاء Bob، سيطلب الموافقة على كتابة ملفات الخطة. انقر على Approve edit tools for task.
يضع Bob ملفات الخطة في المجلد plans كملفات Markdown. قد تختلف أسماء ملفات خطتك.
/galaxium-travels/plans/seat-class-plan.mdمراجعة الخطة
ملفات الخطة هي المواصفة التي سيبني Bob بناءً عليها. راجع الخطة الموجودة في المجلد plans لفهم التغييرات المقترحة.
عند مراجعة الخطط، ابحث عن الآتي:
- تطابق النطاق: هل تتضمن الخطة كل ما طلبته؟ وهل تحتوي على شيء لم تطلبه؟
- لغة مبهمة: انتبه لعبارات مثل «أضف عند الحاجة» أو «حدّث بالشكل المناسب». هذه افتراضات غير مصرّح بها. استبدلها بتعليمات محددة قبل الموافقة.
- ملفات مسماة: ينبغي أن تحدد كل خطوة الملفات التي تمسها. إذا ذكرت خطوة «حدّث مكوّن الحجز» دون تسمية الملف، فاطلب من Bob مزيدًا من التحديد.
تحسين الخطة
إذا لم تطابق الخطة نيتك، فاطلب من Bob مراجعتها في محادثة وضع Plan نفسها. لا حاجة إلى البدء من جديد.
على سبيل المثال، لم تحدد الخطة المُنشأة في الخطوة السابقة اللون أو الشارة لكل فئة.
b. Apply a distinct colour or badge per class (e.g. grey for Economy, gold for Business, cosmic-gradient for Galaxium) consistent with the existing status colour patternلتصحيح ذلك، شغّل الطلب التالي لتحديد الألوان صراحةً لكل فئة:
Please update the plan to specify the following colors for each class:
- Economy: green
- Business: gold
- Galaxium: cosmic-gradientقد لا تواجه المشكلة نفسها في خطتك. راجعها واطلب من Bob توضيح أي لغة مبهمة أو إضافة أي تفاصيل ناقصة تلاحظها.
تنفيذ الميزات الجديدة
بدء محادثة جديدة
انقر على علامة الجمع أعلى واجهة الدردشة لبدء محادثة جديدة ومسح نافذة السياق.
يؤدي بدء محادثة جديدة إلى مسح نافذة السياق، مما:
- يمنع مناقشة التخطيط السابقة من استهلاك ميزانية الـ token.
- يبقي سياق التنفيذ مركزًا على الخطة المعتمدة.
- يقلل خطر خلط Bob بين تعليمات التخطيط والتنفيذ.
التبديل إلى وضع Agent
اختر Agent من محدد الوضع للانتقال إلى وضع Agent.
بناء الميزة
أرسل هذا الطلب لتنفيذ الميزات:
Build the features in the plans folder
@plans/يشير المرجع @plans/ إلى جميع الخطط في المجلد، لذلك لا تحتاج إلى تسمية الملفات واحدًا واحدًا.
توضح لقطة الشاشة التالية مثالًا لمجلد خطط:
سيطلب منك Bob Approve todo tools for task وApprove edit tools for task. وافق على الطلبين.
لقد أضفت دعم فئات المقاعد عبر واجهة الحجز وAPI الخلفي وقاعدة البيانات، مع ظهور خيارات Economy وBusiness وGalaxium في النظام كله.
الخطوات التالية
في هذا الدرس، تعلمت كتابة طلب تخطيط محدد النطاق، ومراجعة خطة مُولّدة لاكتشاف الثغرات واللغة المبهمة، وتحسين الخطة حتى تطابق نيتك، وتنفيذ المواصفة المعتمدة بنافذة سياق جديدة.
تابع إلى توحيد سلوك Bob للتعرف إلى إنشاء قواعد مخصصة تتحكم في سلوك Bob.
تعرّف إلى كيفية عمل نافذة سياق Bob في إنشاء نافذة سياق جديدة لفهم سبب تحسين بدء محادثة جديدة لجودة التنفيذ.
استكشف إضافة إمكانات إلى Bob لتوسيع ما يستطيع Bob فعله في مشروعك.
توليد تقارير التدقيق ووثائق الامتثال
استخدم IBM Bob لتحليل قاعدة كود Galaxium Travels وإنتاج تقارير تدقيق منظمة تغطي جودة الكود وصحة التبعيات والديون التقنية وحالة الامتثال. تعلم كيفية تجميع وثائق جاهزة لأصحاب المصلحة من التحليل المدعوم بالذكاء الاصطناعي.
إنشاء commit وpull request مع Bob
استخدم Bob لإنشاء branch، ترتيب التغييرات، توليد رسالة commit، رفع التغييرات إلى مستودعك، وفتح pull request.