الـ pull requests — اقترح، لا تطلق وحسب

الـ branch الخاص بك عُمل له push. صار على GitHub الآن — لكنه جانبًا. المشروع الحقيقي (main) ما زال لا يملك تغييراتك. تستطيع أن تعمل merge للـ branch مباشرةً وحسب. لكن في أيّ مشروع فيه أشخاص آخرون، لا تفعل ذلك. بل تفتح pull request.

الـ pull request (PR) يقول “إليك تغييري — راجعه قبل أن يدخل المشروع الحقيقي”. إنه يحوّل التغيير إلى اقتراح يدور حوله نقاش.

الاسم مقلوب قليلًا: أنت تطلب أن يسحب المشروع الـ branch الخاص بك إلى داخله. وما هو عليه فعلًا، في الممارسة، صفحة على GitHub تعرض تغييراتك (الـ diff)، ووصفًا تكتبه يشرحها، ومساحة ليعلّق فيها آخرون — كلّ ذلك قبل أن يُعمل merge لأيّ شيء في main.

الفرق عن أن تعمل له merge بنفسك وحسب: الـ PR يضيف توقّفًا متعمّدًا للمراجعة، وسجلًّا دائمًا لـلماذا حدث التغيير.

الوصف هو “لماذا” التغيير بأكمله

رسائل الـ commit لديك (من الدرس 8.3) تشرح كلّ خطوة على حدة. أمّا وصف الـ PR فيتّسع للصورة الأكبر: يشرح التغيير بأكمله دفعة واحدة — ما يفعله، ولماذا كان ضروريًا، وأيّ شيء ينبغي لمراجِع أن يعرفه قبل أن ينظر.

يكتب Claude هذه جيّدًا. وجّهه نحو الـ branch الخاص بك فيقرأ كلّ commit، ثمّ يلخّصها في كتابة نظيفة. ومهمّتك هي ذاتها كما مع الـ commit message: تحقّق من أنها صادقة وكاملة قبل أن تخرج. أنت من يعرف ما إذا كانت جاهزة فعلًا.

على طريقة Claude

مع إعداد الـ tool المسمّى gh (وهو مساعد GitHub على command line)، يفعل Claude الأمر كلّه:

افتح pull request لهذا الـ branch
open a pull request for this branch

يكتب Claude العنوان، ويصوغ الوصف، ويفتح الـ PR، ويسلّمك الرابط. أنت اتخذت القرار بأنه جاهز للاقتراح؛ وClaude أنجز الأعمال الورقية.

ما التالي

بمجرّد أن يُفتح الـ PR، يراجعه الناس — ويتركون تعليقات. بالنسبة لكثيرين، ذلك هو الجزء المرهِب. إنه القطعة الأخيرة من الحلقة، وهو أكثر ودًّا مما يبدو. التالي.