الأدوات
تعرّف على كيفية استخدام Bob Shell لأدوات متخصصة لقراءة الملفات وتحرير الكود وتشغيل الأوامر والتفاعل مع بيئة التطوير من سطر الأوامر.
سير عمل الأداة
عندما تصف ما تريد تحقيقه بلغة طبيعية، سيقوم Bob Shell بـ:
- اختيار الأداة المناسبة بناءً على طلبك.
- عرض الأداة مع معاملاتها لمراجعتك.
- تشغيل الأداة المعتمدة وإظهار النتائج لك.
- الاستمرار في هذه العملية حتى اكتمال مهمتك.
فئات الأدوات
تُنظَّم أدوات Bob Shell في فئات بناءً على وظيفتها الأساسية. فهم هذه الفئات يساعدك على معرفة ما يستطيع Bob Shell فعله وكيف يُنجز المهام.
أدوات القراءة
الوصول إلى محتوى الملفات وفهم بنية الكود دون إجراء تغييرات.
| الأداة | الغرض | مثال الاستخدام |
|---|---|---|
read_file | قراءة محتوى ملف واحد أو أكثر | عرض ملفات الإعداد وفحص الكود المصدري |
search_files | البحث عن أنماط عبر ملفات متعددة باستخدام regex | البحث عن جميع تعليقات TODO وتحديد تعريفات الدوال |
list_files | سرد الملفات والمجلدات في مسار محدد | استكشاف بنية المشروع وإيجاد أنواع ملفات محددة |
list_code_definition_names | استخراج أسماء الفئات والدوال والطرق من ملفات المصدر | الحصول على نظرة عامة على تنظيم الكود |
متى يستخدم Bob Shell أدوات القراءة: عندما تطلب من Bob Shell مراجعة الكود أو إيجاد أنماط محددة أو فهم بنية المشروع.
أدوات الكتابة
إنشاء ملفات جديدة أو تعديل الكود الموجود بدقة.
| الأداة | الغرض | مثال الاستخدام |
|---|---|---|
write_to_file | إنشاء ملف جديد أو إعادة كتابة ملف موجود بالكامل | إنشاء مكونات جديدة وملفات إعداد |
apply_diff | إجراء تغييرات مستهدفة على أقسام محددة من الملف | تحديث منطق الدوال وإصلاح الأخطاء وإعادة الهيكلة |
insert_content | إضافة أسطر جديدة في موقع محدد من الملف | إضافة استيرادات وإدراج دوال جديدة |
متى يستخدم Bob Shell أدوات الكتابة: عندما تطلب من Bob Shell إنشاء ملفات أو تنفيذ ميزات أو إصلاح أخطاء أو إعادة هيكلة الكود.
أدوات الأوامر
تشغيل الأوامر وتنفيذ عمليات النظام في طرفيتك.
| الأداة | الغرض | مثال الاستخدام |
|---|---|---|
execute_command | تشغيل أوامر CLI في مساحة عملك | تثبيت التبعيات وتشغيل الاختبارات وبناء المشاريع |
متى يستخدم Bob Shell أدوات الأوامر: عندما تطلب من Bob Shell تشغيل أوامر أو تثبيت حزم أو تشغيل سكريبتات أو إتمام عمليات النظام.
أدوات MCP
توسيع قدرات Bob Shell عبر خوادم Model Context Protocol.
| الأداة | الغرض | مثال الاستخدام |
|---|---|---|
use_mcp_tool | الوصول إلى الأدوات التي توفرها خوادم MCP المتصلة | الاستعلام من قواعد البيانات والتفاعل مع واجهات برمجة التطبيقات والوصول إلى الخدمات الخارجية |
أدوات الوضع
التبديل بين أوضاع Bob Shell المختلفة للمهام المتخصصة.
| الأداة | الغرض | مثال الاستخدام |
|---|---|---|
switch_mode | التغيير إلى وضع مختلف (Agent وPlan وAsk وغيرها) | التبديل إلى وضع Plan لتصميم المعمارية، ووضع Agent للتنفيذ |
متى يستخدم Bob Shell أدوات الوضع: عندما تستفيد المهمة الحالية من قدرات وضع مختلف المتخصصة.
أدوات الأسئلة
جمع معلومات إضافية لازمة لإتمام المهام.
| الأداة | الغرض | مثال الاستخدام |
|---|---|---|
ask_followup_question | طلب توضيح أو تفاصيل إضافية منك | السؤال عن نهج التنفيذ المفضل وطلب معلومات مفقودة |