استخدم سير عمل المراجعة المدمج للحصول على مراجعات أكواد مدعومة بالذكاء الاصطناعي مباشرةً في IDE. يحلل Bob التغييرات ويُضع علامة على المشكلات المحتملة قبل commit عملك.

لماذا تستخدم مراجعات الأكواد؟

اكتشف الأخطاء مبكراً: حدد المشكلات قبل دخولها إلى عملك المُنفَّذ.

وفّر الوقت: عالج تعليقات المراجعين المحتملة بشكل استباقي، مما يقلل وقت موافقة PR.

حسّن جودة الأكواد: احصل على اقتراحات لممارسات برمجة أفضل وقابلية الصيانة.

تحقق من معالجة المشكلات: تأكد من توافق تغييراتك مع متطلبات issue (يتطلب GitHub).

كيف يعمل

يعمل سير عمل المراجعة بالكامل داخل IDE. يوفر Bob لوحة مراجعة مخصصة. افتحها باستخدام أمر /review.

يراجع Bob الـ diff بين فروعك المحددة، ثم يضع علامة على المشكلات المحتملة في لوحة Bob Findings. يمكنك اختياراً إدراج GitHub issue للتحقق من معالجة تغييراتك لمتطلباته.

تعمل المراجعات مع الموافقة التلقائية. يمضي Bob عبر جميع خطوات التحليل دون الحاجة إلى تأكيد يدوي.

مراجعة أكوادك

المتطلبات الأساسية

الوصول إلى الفروع المحلية أو البعيدة التي تريد مقارنتها.

للتحقق من issue: حساب GitHub وعنوان URL للـ issue (مطلوب GitHub للميزات المتعلقة بالـ issue).

ملاحظة:

يمكن لـ Bob العمل مع GitHub وGitLab لمقارنات الفروع. ومع ذلك، يتطلب التحقق من issue استخدام GitHub.

بدء مراجعة

افتح لوحة Bob Review من شريط الجانب باستخدام أمر /review أو أيقونة لوحة Review. توفر اللوحة واجهة مرئية لتهيئة مراجعتك وبدئها.

اختر الفرع الذي تريد المقارنة معه من القائمة المنسدلة للفروع. يمكنك المقارنة مع فرعك الحالي أو الفروع المحلية أو الفروع البعيدة أو الفرع الافتراضي للمستودع.

فعّل Include Uncommitted Changes إذا أردت تضمين التعديلات المحلية التي لم تُنفَّذ بعد.

اختياراً، اختر GitHub issue من قائمة الـ issues للتحقق من معالجة تغييراتك لمتطلباته.

انقر على Start Review للبدء.

يراجع Bob تغييراتك ويعرض النتائج في لوحة Bob Findings.

خيارات المراجعة

اختيار فرع المقارنة

تُظهر القائمة المنسدلة للفروع:

Current branch: فرعك النشط.

Default branch: الفرع الافتراضي لمستودعك (مُميَّز بشارة).

Remote branches: الفروع من مستودعك البعيد (مُميَّزة بشارة).

Local branches: الفروع المحلية الأخرى (مُميَّزة بشارة).

يمكنك مقارنة main البعيد مع main المحلي، أو فرعك الحالي مع أي فرع آخر، أو أي مجموعة من المراجع.

عرض التغييرات غير المُنفَّذة

فعّل خانة Include Uncommitted Changes لتضمين التعديلات المحلية غير المُنفَّذة في مراجعتك. يُفعَّل هذا الخيار تلقائياً عند مراجعة فرعك الحالي.

تهيئة استثناءات المراجعة

يمكنك استثناء ملفات أو أنماط محددة من مراجعات الأكواد:

افتح إعدادات Bob.

انتقل إلى تبويب Bob Findings.

تحت Review Exclusions، أضف أنماط glob للملفات المراد استثناؤها (مثلاً .vscode/**، *.test.ts).

لن تظهر الملفات المستثناة في قائمة ملفات لوحة المراجعة ولن تُحلَّل أثناء المراجعات.

استخدام Bob Findings

بمجرد إتمام Bob للمراجعة، تظهر النتائج في لوحة Bob Findings. يمكنك التفاعل مع هذه النتائج بعدة طرق:

عرض النتائج

انقر على أي نتيجة في لوحة Bob Findings لرؤية التفاصيل الكاملة.

استخدم @issues في القائمة المنسدلة لسياق واجهة المحادثة للإشارة إلى النتائج في المحادثة.

انتقل إلى الملف بالنقر على النتيجة لرؤية الكود في السياق مع التعليقات التوضيحية المضمّنة.

للمزيد من المعلومات حول إشارات السياق، راجع إشارات السياق.

اتخاذ إجراء على النتائج

توفر كل نتيجة الإجراء التالي:

Fix with Bob: اطلب من Bob إصلاح المشكلة تلقائياً. سيُنشئ Bob مهمة لمعالجة النتيجة.

Dismiss: أزل النتيجة من اللوحة إذا لم تكن ذات صلة.

نصائح وأفضل الممارسات

ادمج مع المراجعات اليدوية: استخدم مراجعات Bob الآلية كتمريرة أولى قبل مراجعات الأكواد البشرية.

تحقق من تغطية issue: أدرج GitHub issue لضمان معالجة تغييراتك الكاملة للمتطلبات قبل إنشاء pull request.

هيّئ الاستثناءات: استثنِ ملفات الاختبار والأكواد المولَّدة أو ملفات التهيئة التي لا تحتاج مراجعة.

قارن مع الفروع البعيدة: استخدم منتقي الفروع لمراجعة عملك مع أحدث التغييرات البعيدة.

مراجعات الأكواد

في هذه الصفحة