أفضل الممارسات
اتبع هذه الإرشادات للاستفادة القصوى من تجربتك مع Bob.
فهم الأوضاع واستخدامها
أوضاع Bob شخصيات مخصصة للمهام تشكّل سلوكه. اختيار الوضع المناسب يساعدك على الحصول على أفضل النتائج.
الأوضاع المدمجة
يأتي Bob بثلاثة أوضاع مدمجة، كل منها مصمم لأغراض محددة:
| الوضع | الغرض | متى تستخدمه |
|---|---|---|
| Agent | كتابة وتعديل الأكواد | لتنفيذ الميزات وإصلاح الأخطاء وإجراء تحسينات الأكواد |
| Plan | التخطيط والتصميم | قبل التنفيذ، عندما تحتاج إلى تخطيط البنية أو إنشاء مواصفات تقنية |
| Ask | الحصول على المعلومات | عندما تحتاج إلى شروحات أو معلومات دون تعديل الملفات |
استراتيجية اختيار الوضع
لأكثر سير عمل فعّال:
ابدأ بوضع Plan للمشاريع الجديدة أو الميزات المعقدة لإنشاء خطة تنفيذ مفصّلة قبل كتابة أي كود. اقرأ الخطة بعناية للتأكد من توافقها مع هدفك.
انتقل إلى وضع Agent لمعظم مهام التطوير اليومية عندما تكون جاهزاً للتنفيذ.
استخدم وضع Ask عندما تحتاج إلى شروحات أو معلومات دون تعديل الملفات.
للمزيد من التفاصيل حول الأوضاع وكيفية التنقل بينها، راجع الأوضاع.
الأوضاع المخصصة
يمكنك إنشاء أوضاع متخصصة لمهام أو سير عمل محددة:
- أنشئ أوضاعاً للمهام المتخصصة مثل مراجعات الأمان أو كتابة التوثيق.
- هيّئ الأوضاع المخصصة مع أذونات وصول محددة للأدوات وتعريفات الأدوار.
- شارك الأوضاع مع فريقك لتوحيد سير العمل.
تعرّف أكثر على إنشاء وتهيئة الأوضاع المخصصة في توثيق الأوضاع المخصصة.
تحسين سير العمل
خطّط قبل البرمجة
ابدأ دائماً المشاريع أو الميزات المعقدة في وضع Plan من أجل:
- توليد خطة تنفيذ مفصّلة.
- تقسيم المشكلات المعقدة إلى خطوات قابلة للإدارة.
- تحديد التحديات المحتملة قبل ظهورها.
- إنشاء خارطة طريق للتنفيذ.
هذا النهج يمنع التغييرات المفاجئة ويوفر توجيهاً واضحاً للتطوير.
استخدم rollback بفعالية
يستخدم Rollback git لاستعادة ملفات workspace إلى الحالة التي كانت عليها في أي نقطة سابقة في المهمة، مما يتيح:
- التجريب الآمن مع التغييرات المقترحة بالذكاء الاصطناعي.
- الاسترداد السهل من التعديلات غير المرغوبة.
- مقارنة نهج التنفيذ المختلفة.
إذا بدأ Bob في إنتاج عمل غير مُرضٍ، استخدم rollback لاستعادة ملفاتك إلى حالة سابقة. هذا أكثر فعالية من محاولة تصحيح المخرجات المعيبة بتعليمات جديدة.
لاستعادة عملك إلى حالة سابقة:
ضع مؤشر الفأرة فوق الطلب في محادثتك الذي تريد الرجوع إليه.
انقر على زر Rollback لاستعادة ملفاتك إلى تلك النقطة في الوقت.
راقب الاستخدام وحسّن التكاليف
تتبع استهلاك Bobcoin وأنماط الاستخدام مع Bobalytics لتحسين سير عملك وإدارة التكاليف بفعالية.
التكامل مع التحكم بالإصدارات
تعهّد بالتغييرات وادفعها إلى نظام التحكم بالإصدارات بانتظام:
- أنشئ commits صغيرة ومتكررة برسائل واضحة.
- ادفع التغييرات إلى repositories البعيدة بانتظام.
- استخدم الفروع للميزات التجريبية.
يوفر Git شبكة أمان أساسية لمنع الحذف العرضي الدائم للأكواد.
استراتيجيات التواصل
اكتب طلبات فعّالة
جودة طلباتك تؤثر مباشرةً على جودة استجابات Bob:
- كن محدداً وواضحاً: الطلبات الغامضة تؤدي إلى مخرجات غامضة. فصّل ما يجب وما لا يجب أن يفعله Bob.
- قدّم أمثلة: عند الإمكان، أدرج أمثلة على تنسيق الإخراج أو الأسلوب المطلوب.
استخدم إشارات السياق
تتيح لك إشارات السياق الإشارة إلى عناصر محددة في مشروعك مباشرةً في محادثاتك مع Bob:
- استخدم
@/path/to/file.jsلتضمين محتويات ملف محدد. - استخدم
@/path/to/folderلتضمين جميع الملفات في مجلد. - استخدم
@problemsلتضمين تشخيصات لوحة Bob Findings. - استخدم
@terminalلتضمين مخرجات الطرفية الأخيرة. - حدد نصاً واستخدم اختصار لوحة المفاتيح ⌘ + L لإضافته إلى المحادثة.
- أرفق ملفات
.docxو.pdfو.xlsxمباشرةً كسياق دون الحاجة إلى استخراج محتواها يدوياً.
هذا النهج أكثر كفاءة من النسخ واللصق للأكواد أو وصف مواقع الملفات.
تعرّف أكثر على إشارات السياق في توثيق إشارات السياق.
إدارة نافذة السياق
لدى Bob نافذة سياق تبلغ 270,000 token تشمل سجل محادثتك ومحتويات الملفات ومخرجات الأدوات. لاستخدامها بفعالية:
- ابدأ مهاماً جديدة بانتظام بأهداف محددة.
- تجنب إعطاء Bob قاعدة أكوادك بأكملها دفعة واحدة.
- استخدم مراجع الملفات المباشرة لتوفير سياق مستهدف.
- قسّم المهام المعقدة إلى مهام فرعية أصغر ومركّزة.
الأمان والتحكم
هيّئ إعدادات الموافقة التلقائية
يتيح لك Bob التحكم في الإجراءات التي تتطلب موافقتك:
- الموافقة اليدوية: راجع كل إجراء يتخذه Bob ووافق عليه (الإعداد الأكثر أماناً).
- الموافقة التلقائية: امنح Bob القدرة على تشغيل مهام محددة دون انقطاع.
- النهج الهجين: وافق تلقائياً على الإجراءات منخفضة المخاطر مع طلب تأكيد للمهام الأكثر خطورة.
- الأوامر القابلة للتعديل: عدّل أي أمر يقترحه Bob قبل تشغيله، مما يمنحك تحكماً دقيقاً دون إلغاء وإعادة صياغة.
- الأوامر الموافق عليها تلقائياً: حدد قائمة بالأوامر الموثوقة التي يمكن لـ Bob تشغيلها دون طلب الموافقة في كل مرة.
- الموافقات على مستوى المهمة: هيّئ موافقات مجموعة الأدوات لكل مهمة، بشكل مستقل عن إعداداتك العامة.
هيّئ هذه الإعدادات بناءً على مستوى راحتك وحساسية مشروعك.
تعرّف أكثر على إعدادات الموافقة التلقائية في توثيق الموافقة التلقائية على الإجراءات.
استخدم .bobignore
يتيح لك ملف .bobignore تحديد الملفات والمجلدات التي لا يجب على Bob الوصول إليها أو تعديلها:
أنشئ ملف .bobignore في جذر مشروعك.
أضف أنماطاً للملفات الحساسة وملفات البناء والأصول الكبيرة.
استخدم نفس صياغة .gitignore.
هذا يساعد على حماية المعلومات الحساسة ومنع التغييرات العرضية على الملفات المُولَّدة.
تعرّف أكثر على التحكم في الوصول إلى الملفات في توثيق استخدام .bobignore.
للمزيد من المعلومات التفصيلية حول إرشادات الأمان، راجع إرشادات الأمان.
إعداد القواعد
يتيح لك Bob تحديد قواعد للتحكم في كيفية تنفيذ Bob للمهام:
- عرّف القواعد بشكل عام أو لكل مشروع في مجلد
.bob. - أنشئ قواعد خاصة بالوضع في مجلدات
.bob/rules-{mode-slug}/. - استخدم القواعد لفرض معايير البرمجة ومتطلبات التوثيق أو قيود سير العمل الأخرى.
للمزيد من المعلومات حول الأوضاع المخصصة والقواعد، راجع توثيق الأوضاع المخصصة.