أنشئ pull requests ووصف PR مباشرةً من IDE. يحلل Bob التغييرات ويُنشئ أوصافاً مفصّلة ويُبسّط سير عملك.

لماذا تستخدم هذه الميزة؟

وفّر الوقت: أنشئ أوصاف PR مفصّلة تلقائياً بناءً على تغييراتك.

حافظ على الاتساق: تأكد من اتباع جميع PRs تنسيقاً متسقاً.

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

بسّط سير العمل: أنشئ PRs دون مغادرة IDE.

يحلل Bob تغييرات فرعك وسجل commits واسم الفرع لفهم غرض عملك ونطاقه. ثم يولّد عنواناً ذا معنى لـ PR ووصفاً مفصّلاً يلخّص تغييراتك، مما يسهّل على المراجعين فهم سياق PR وغرضه. بعد التوليد، يمكنك مراجعة وصف PR وتعديله قبل الإرسال.

عملية توليد PR تفاعلية، مما يتيح لك اختيار الفرع الهدف والمستودع البعيد قبل إنشاء PR.

البدء

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

يجب أن تكون تغييراتك مُنفَّذة (committed) في فرع.

يجب أن يكون لديك صلاحية push للمستودع البعيد.

الاستخدام الأساسي

يمكنك الاختيار من 3 خيارات لبدء تدفق PR:

انقر على أيقونة PR في لوحة Source Control.

استخدم command palette (Cmd + Shift + P على Mac، Ctrl + Shift + P على Windows/Linux) وابحث عن "Bob: Generate PR".

اكتب /create-pr في واجهة محادثة Bob.

سيرشدك Bob بعد ذلك عبر الخطوات التالية:

اختر الفرع الأساسي الذي تريد الدمج إليه. سيقترح Bob الفروع الثلاثة الأكثر احتمالاً.

اختر المستودع البعيد، إذا كان لديك عدة مستودعات بعيدة.

راجع وصف وعنوان PR المولَّد.

أنشئ PR.

احصل على رابط PR المنشأ حديثاً في محادثتك.

استخدام القوالب لأوصاف PR

يكتشف Bob تلقائياً قوالب PR الموجودة في مشروعك ويستخدمها عند توليد أوصاف pull request. هذا يضمن اتساق PRs مع المعايير المعتمدة لدى فريقك. عندما يكتشف Bob قوالب PR متعددة في مشروعك، يمكنك اختيار القالب المراد تطبيقه على pull request الخاص بك.

اكتشاف القوالب

يبحث Bob عن قوالب PR في المواقع التالية بالنسبة لجذر مشروعك:

${cwd}/pull_request_template.md

${cwd}/docs/pull_request_template.md

${cwd}/.github/pull_request_template.md

${cwd}/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md

${cwd}/PULL_REQUEST_TEMPLATE/pull_request_template.md

${cwd}/docs/PULL_REQUEST_TEMPLATE/pull_request_template.md

إذا وجد Bob قوالب متعددة، سيطلب من المستخدم اختيار القالب المراد استخدامه لوصف PR.

القالب الافتراضي

إذا لم يُعثر على قالب في مشروعك، يستخدم Bob قالباً مدمجاً يتضمن:

عنواناً وصفياً مشتقاً من اسم فرعك

ملخصاً للتغييرات

تفاصيل تطبيقية رئيسية

معلومات الاختبار

أي روابط أو مراجع ذات صلة

تعديل الوصف المولَّد

بعد توليد وصف PR، يعرضه Bob مضمّناً في المحادثة. يمكنك بعد ذلك:

التأكيد والمتابعة: الموافقة على الوصف كما هو للمتابعة بإنشاء PR.

طلب التغييرات: اكتب تعليقاتك في المحادثة وسيعيد Bob توليد الوصف بناءً على مدخلاتك. يمكنك التكرار بالقدر الذي تحتاجه قبل التأكيد.

تخصيص القوالب

للحصول على أفضل النتائج مع توليد PR في Bob:

استخدم عناوين أقسام واضحة في قوالبك (مثل ## Summary، ## Changes)

أدرج نصاً توضيحياً يوفر سياقاً (مثل )

فكر في إضافة أقسام لتعليمات الاختبار والمشكلات ذات الصلة

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

استخدم أسماء فروع وصفية لمساعدة Bob على توليد أوصاف PR أكثر دقة.

راجع الوصف المولَّد وعدّله قبل إنشاء PR.

طلبات السحب (pull requests)