أفضل الممارسات
اتبع هذه الإرشادات للحصول على أفضل تجربة مع Bob Shell.
فهم الأوضاع واستخدامها
أوضاع Bob هي شخصيات متخصصة بالمهام تُشكّل سلوكه. يساعدك اختيار الوضع المناسب على الحصول على أفضل النتائج.
الأوضاع المدمجة
يأتي Bob Shell مع ثلاثة أوضاع مدمجة، كل منها مصمم لأغراض محددة:
| الوضع | الغرض | متى تستخدمه |
|---|---|---|
| Agent | كتابة الكود وتعديله | لتطبيق الميزات وإصلاح الأخطاء أو إجراء تحسينات على الكود |
| Plan | التخطيط والتصميم | قبل التطبيق، عندما تحتاج لتخطيط البنية أو إنشاء مواصفات تقنية |
| Ask | الحصول على معلومات | عندما تحتاج إلى شروحات أو معلومات دون تعديل الملفات |
استراتيجية اختيار الوضع
لسير عمل أكثر فعالية:
ابدأ بوضع Plan للمشاريع الجديدة أو الميزات المعقدة لإنشاء خطة تطبيق تفصيلية قبل كتابة أي كود. اقرأ الخطة بعناية للتأكد من توافقها مع هدفك.
انتقل إلى وضع Agent لمعظم مهام التطوير اليومية عندما تكون مستعداً للتطبيق.
استخدم وضع Ask عندما تحتاج إلى شروحات أو معلومات دون تعديل الملفات.
بدّل بين الأوضاع في جلسة bob chat بكتابة /mode agent أو /mode plan أو /mode ask. لمزيد من التفاصيل، راجع الأوضاع.
الأوضاع المخصصة
يمكنك إنشاء أوضاع متخصصة لمهام أو سير عمل محددة:
- أنشئ أوضاعاً للمهام المتخصصة مثل مراجعات الأمان أو كتابة التوثيق.
- هيّئ الأوضاع المخصصة بأذونات وصول محددة للأدوات وتعريفات الأدوار.
- شارك الأوضاع مع فريقك لتوحيد سير العمل.
اعرف المزيد حول إنشاء وتهيئة الأوضاع المخصصة في توثيق الأوضاع المخصصة.
تحسين سير العمل
خطط قبل البرمجة
ابدأ دائماً المشاريع أو الميزات المعقدة في وضع Plan من أجل:
- توليد خطة تطبيق تفصيلية.
- تقسيم المشكلات المعقدة إلى خطوات قابلة للإدارة.
- تحديد التحديات المحتملة قبل ظهورها.
- إنشاء خارطة طريق للتطبيق.
يمنع هذا النهج التغييرات المعطِّلة ويوفر توجيهاً واضحاً للتطوير.
استخدم git كشبكة أمان
اعتمد commits متكررة حتى تتمكن من التعافي من التغييرات غير المرغوبة:
- أنشئ commits صغيرة ومتكررة برسائل واضحة.
- ادفع التغييرات إلى المستودعات البعيدة بانتظام.
- استخدم branches للميزات التجريبية.
إذا أنتج Bob نتائج دون المستوى، فالرجوع إلى commit سابق أكثر فعالية من محاولة تصحيح المخرجات المعيبة بتعليمات جديدة. ابدأ جلسة bob chat جديدة بعد الرجوع حتى لا تبقى المخرجات السيئة في السياق.
راقب الاستخدام وحسّن التكاليف
تتبع استهلاك Bobcoin بمراجعة استخدام حسابك. انتبه لحجم نافذة السياق — المحادثات الطويلة تستهلك المزيد من الـ tokens وبالتالي المزيد من Bobcoins.
تكامل مع إدارة الإصدارات
يوفر Git شبكة أمان أساسية لمنع الحذف العرضي الدائم للكود. اعتمد commits بانتظام قبل وبعد التغييرات المهمة بمساعدة الذكاء الاصطناعي وبعدها.
استراتيجيات التواصل
اكتب موجّهات فعّالة
جودة موجّهاتك تؤثر مباشرةً على جودة ردود Bob:
- كن محدداً وواضحاً: الموجّهات المبهمة تؤدي إلى مخرجات مبهمة. فصّل ما يجب وما لا يجب أن يفعله Bob.
- قدّم أمثلة: عند الإمكان، أدرج أمثلة على تنسيق المخرجات أو الأسلوب المطلوب.
استخدم إشارات السياق
تتيح لك إشارات السياق الرجوع إلى عناصر محددة من مشروعك مباشرةً في محادثاتك مع Bob Shell:
- استخدم
@/path/to/file.jsلإدراج محتويات ملف محدد. - استخدم
@/path/to/folderلإدراج جميع الملفات في مجلد.
bob chat
# Reference a specific file
> Explain what @src/utils.js does and how it works
# Reference a directory
> Review the tests in @tests/ and identify any gapsهذا النهج أكثر كفاءة من نسخ ولصق الكود أو وصف مواقع الملفات.
إدارة نافذة السياق
يمتلك Bob نافذة سياق بسعة 270,000 token، تشمل سجل محادثتك ومحتويات الملفات ومخرجات الأدوات. لاستخدامها بفعالية:
- ابدأ جلسات
bob chatجديدة بانتظام بأهداف محددة. - تجنب إعطاء Bob قاعدة الكود الكاملة دفعة واحدة.
- استخدم مراجع الملفات المباشرة لتوفير سياق مستهدف.
- قسّم المهام المعقدة إلى مهام فرعية أصغر ومركزة.
راجع إدارة نافذة السياق للحصول على شرح أعمق حول كيفية عمل نافذة السياق واستراتيجيات إدارتها.
الأمان والتحكم
تهيئة إعدادات الموافقة التلقائية
يتيح لك Bob Shell التحكم في الإجراءات التي تتطلب موافقتك قبل تشغيلها:
- الموافقة اليدوية: مراجعة والموافقة على كل إجراء يتخذه Bob (الإعداد الأكثر أماناً).
- الموافقة التلقائية: منح Bob القدرة على تشغيل مهام محددة دون انقطاع.
- النهج الهجين: الموافقة التلقائية على الإجراءات المنخفضة المخاطر مع طلب تأكيد للمهام الأكثر خطورة.
- الأوامر ذات الموافقة التلقائية: حدّد قائمة بالأوامر الموثوقة التي يمكن لـ Bob تشغيلها دون طلب موافقة في كل مرة.
هيّئ هذه الإعدادات في ~/.bob/settings/settings.json بناءً على مستوى راحتك وحساسية مشروعك.
اعرف المزيد حول إعدادات الموافقة التلقائية في توثيق إجراءات الموافقة التلقائية.
استخدم .bobignore
يتيح لك ملف .bobignore تحديد الملفات والمجلدات التي لا يجب على Bob الوصول إليها أو تعديلها:
أنشئ ملف .bobignore في جذر مشروعك.
أضف أنماطاً للملفات الحساسة ومخرجات البناء والأصول الكبيرة.
استخدم نفس تركيب .gitignore.
يساعد هذا في حماية المعلومات الحساسة ومنع التغييرات العرضية على الملفات المولّدة.
اعرف المزيد حول التحكم في الوصول للملفات في توثيق تجاهل الملفات.
للاطلاع على معلومات تفصيلية حول إرشادات الأمان، راجع إرشادات الأمان.
إعداد القواعد
يتيح لك Bob تحديد قواعد للتحكم في كيفية أداء Bob للمهام:
- حدّد القواعد عالمياً أو لكل مشروع في مجلد
.bob. - أنشئ قواعد خاصة بالوضع في مجلدات
.bob/rules-{mode-slug}/. - استخدم القواعد لفرض معايير البرمجة ومتطلبات التوثيق أو قيود سير العمل الأخرى.
لمزيد من المعلومات حول الأوضاع المخصصة والقواعد، راجع توثيق الأوضاع المخصصة.