راجع أول طلب سحب

ما الذي ستبنيه

بنهاية هذا الدرس ستكون قد:

• فتحت طلب سحب في منضدة طلبات السحب في Control Center
• قرأت فروقه وتركت تعليقًا مضمّنًا
• أرسلت حكم مراجعة
• دمجت طلب السحب

المتطلبات السابقة: إتمام أرسل وكيلك الأول ووجود طلب سحب مفتوح على مستودع مسجّل في مساحة العمل هذه. لخطوات المراجعة، اختر طلب سحب لم تفتحه أنت — يُخفى زر مراجعة على طلبات السحب التي ألفتها. الدمج يظل متاحًا على طلب سحب ألّفته.

الخطوة 1: افتح طلب السحب

1. انقر طلبات السحب في الشريط الجانبي
2. اعثر على طلب السحب وانقره

نقطة التحقّق. يُفتح طلب السحب منضدةً ذات ألسنة — نظرة عامة والفروق وإدارة المصادر والدردشة وإجراءات — مع التركيز على نظرة عامة: العنوان والإجراءات، والوصف والخط الزمني للنشاط، وشريط جانبي فيه الحالة والمراجعون والمُسنَد إليهم والفحوصات والملفات المتغيّرة. النقر على ملف هناك ينقلك إليه في لسان الفروق. لا يُفتح لسان مراجعة PR حتى يطلب أحد مراجعة بالذكاء الاصطناعي.

قائمة فارغة مع مطالبة «اربط GitHub»

هذه الحالة تعني أن الخادم لا يحمل رمز GitHub — عميلك لا يحمل واحدًا أبدًا. عيّنه من الإعدادات ← مساحة العمل ← الملف الشخصي والهوية ← استضافة الكود، ثم حدّث القائمة.

الخطوة 2: اقرأ الفروق

افتح لسان الفروق. شجرة ملفات قابلة للطي على اليسار، والشريط فوق الفروق يحمل منتقي نطاق الإيداعات — لتضييق الفروق إلى إيداع واحد أو مدى منها — مع عدد الملفات والإضافات والحذف الجارية.

زر الإعدادات في شريط أدوات الفروق يتحكّم في طريقة العرض:

• عرض مقسّم أو موحّد
• التفاف الأسطر أو تمرير الأسطر الطويلة
• حروف الربط في خط التعليمات البرمجية

علّم ملفًا بأنه شُوهد لتتبّع تقدّمك في فرق كبير. التنقّل بلوحة المفاتيح في اختصارات لوحة المفاتيح.

الخطوة 3: اترك تعليقًا مضمّنًا

1. مرّر المؤشر فوق سطر في الفروق — تظهر حبة + صغيرة في الهامش
2. انقرها للتعليق على ذلك السطر، أو اسحبها رأسيًا أولًا لتحديد مدى
3. اكتب ملاحظاتك. يقدّم مربّع الكتابة إرسالين:
   • بدء مراجعة (أو إضافة إلى المراجعة إن كانت مراجعة قيد التنفيذ) يُدرج التعليق في الطابور. تُظهر السلسلة مراجعة معلّقة إلى أن ترسل حكمًا في الخطوة 4.
   • إضافة تعليق واحد ينشره على GitHub فورًا. تُظهر السلسلة جارٍ النشر… ثم متزامن، وتعرض إعادة المحاولة إن فشل النشر.

في هذا الدرس، استخدم بدء مراجعة حتى يخرج التعليق مع الحكم.

التعليق المؤجّل ليس على GitHub بعد

بدء مراجعة / إضافة إلى المراجعة يُبقيان التعليق محليًا إلى أن ترسل حكمًا. إضافة تعليق واحد وحده ينشر فورًا. متن المراجعة الذي تكتبه في الخطوة 4 مسودة منفصلة.

الخطوة 4: أرسل مراجعة

1. انقر مراجعة في صف إجراءات نظرة عامة — الزر نفسه موجود أيضًا في شريط أدوات لسان الفروق. يُخفى على طلبات السحب التي ألفتها وعلى طلب سحب مغلق أو مدموج.
2. اكتب ملخصًا في مربّع الكتابة. يُحفظ تلقائيًا مسودة، فتستطيع إغلاق الطبقة العلوية والعودة.
3. اختر حكمًا:
   • طلب تغييرات
   • تعليق
   • موافقة

الحكم هو الزر. بعد موافقة أو طلب تغييرات يُعاد تسمية الزر إلى تمت الموافقة أو طُلبت تغييرات. حكم تعليق يُبقي التسمية مراجعة.

نقطة التحقّق. يقرأ الزر «تمت الموافقة» أو «طُلبت تغييرات» إن اخترت أحدهما.

الخطوة 5: ادمج

يظهر زر دمج كلما أبلغ GitHub أن طلب السحب قابل للدمج — لا يُشترط موافقتك أنت. لونه يبلّغ عن الجاهزية لا عن الصلاحية: أساسي حين تكون الموافقات المطلوبة والفحوصات خضراء، وثانوي ما دام فحص قيد التشغيل، وتدميري حين لم يوافق مراجع مطلوب أو كان فحص يفشل.

1. انقر دمج
2. اختر طريقة: سحق ودمج أو إنشاء إيداع دمج أو إعادة تأسيس ودمج
3. للطريقة الأولى والثانية، عدّل عنوان الإيداع ورسالته المعبّأين مسبقًا
4. أكّد

أي مشكلات معلّقة — «فحوصات فاشلة» و«بعض المراجعات معلّقة» — تُدرَج في اللوحة المنبثقة قبل التأكيد.

الدمج لا رجعة فيه

الدمج يدفع الإيداعات إلى GitHub. لا يدخل مكدس التراجع في Control Center، ولا يمكن التراجع عنه من هنا.

بعد الدمج يُطلَق حدث النطاق PrMerged؛ تستهلكه التحليلات والإشعارات. انظر أحداث النطاق لتعرف ما الذي يستمع أيضًا.

المراجعة بالذكاء الاصطناعي

يستطيع Control Center وضع خط أنابيب مراجعة على طلب سحب مفتوح، لكن حين تطلب ذلك فقط: قالب pr_review له مشغّل يدوي ولا شيء سواه.

1. افتح قائمة ⋯ (مزيد من الإجراءات) في صف إجراءات نظرة عامة واختر اسأل الذكاء الاصطناعي. يبدأ Control Center التشغيل ويفتح لسان مراجعة PR، فتستطيع مشاهدة المتخصصين يعملون.
2. يسجّل وكلاء المراجعة نتائجهم عُقد مراجعة في مساحة طلب السحب؛ وخطوة أخيرة تجمّعها في تقرير واحد.

خط الأنابيب لا ينشر على GitHub عمدًا — ينتهي بعد التجميع. النشر خطوة منفصلة تقوم بها أنت، بزر النشر على GitHub في لسان مراجعة PR. انظر استخدام المراجعة المدعومة بالذكاء الاصطناعي.

الخلاصة

فتحت طلب سحب في المنضدة، وقرأت الفروق مع تمييز الصياغة، وتركت تعليقًا مضمّنًا، وأرسلت حكمًا ودمجت — من غير مغادرة التطبيق.

التالي: ابنِ أول خط أنابيب لأتمتة مسارات العمل متعددة الخطوات.