مقاييس طلبات الدمج ومراجعة الشيفرة
المراجعة هي المكان الذي ينتظر فيه العمل المنتهي في الغالب، لذلك قِس كم يمكث التغيير قبل أن ينظر فيه أحد، وكم حجمه، وكم مرة يعود، واقرن كل رقم سرعة بإشارة جودة حتى لا يعني الأسرع إهمالًا.
نظرة عامة والدافع
طلب الدمج (pull request) هو اقتراح لدمج مجموعة من التغييرات من فرع في مستودع التحكم في الإصدارات (version control) إلى فرع آخر، مع الحوار حول هل ينبغي دمجها. وفي فرق كثيرة هو البوابة الرسمية بين «يعتقد المؤلف أنه يعمل» و«يتفق الفريق على أنه يمكن شحنه». والحوار شكل من مراجعة الشيفرة (code review): يقرأ شخص غير المؤلف التغيير، ويطرح أسئلة، ويوافق عليه أو يطلب تعديلات. تسمي بعض المنصات الشيء نفسه طلب دمج (merge request)؛ ويستخدم هذا الموضوع «طلب الدمج» للاثنين.
تستحق المراجعة القياس لسبب بسيط. في منظور التدفق للتسليم، يقضي بند العمل معظم حياته في الانتظار، والمراجعة من الانتظارات التي تقع كليًا تحت سيطرة الفريق. اختناق منصة مشتركة أو اعتمادية خارجية يحتاج إلى أن يتغير آخرون. أما طلب دمج ينتظر يومين ليُلقى عليه نظرة أولى فيحتاج فقط إلى أن تتغير عادات الفريق نفسه. تعطي مقاييس التدفق في هذا الكتاب المفردات العامة (انظر الموضوع 2.1، مقاييس التدفق، والموضوع 2.2، زمن الانتظار الكلي وزمن الدورة وكفاءة التدفق). ويقرّب هذا الموضوع إلى مرحلة واحدة من الدورة ويعطيها أدواتها الخاصة.
يلتقي منظورا الأجايل وITIL هنا بطريقة مفيدة. من منظور الأجايل، المراجعة حلقة تغذية راجعة وآلية تعليم. إنها تنشر المعرفة بقاعدة الشيفرة، وتلتقط العيوب مبكرًا، وتفرض اتفاقيات عمل الفريق وتعريف الإنجاز. ومن منظور ITIL، يدعم النشاط نفسه عدة ممارسات. في ITIL 4، تغطي ممارسة تطوير البرمجيات وإدارتها كيف تُبنى البرمجيات وتُفحص، ويغطي تمكين التغيير كيف تُقيَّم التغييرات وتُفوَّض، وتغطي إدارة النشر كيف تصل التغييرات إلى البيئة الحية. وطلب الدمج المراجَع من الأقران هو، لمؤسسات كثيرة، الدليل على أن تغييرًا معياريًا قُيِّم قبل الإصدار. ومعاملة المراجعة نشاطًا مقيسًا قابلًا للتحسين تخدم المنظورين: يريد فريق الأجايل تغذية راجعة أسرع، وتريد ممارسة ITIL ضمانًا موثوقًا بأن التغييرات فُحصت.
الخطر الذي ينبغي إبقاؤه في الأفق هو أن سرعة المراجعة وجودتها يسهل فصلهما. يستطيع الفريق أن يخفض زمنه إلى أول مراجعة إلى النصف بالموافقة على كل شيء عند رؤيته، وستعرض اللوحة انتصارًا بينما تسوء قاعدة الشيفرة. ينطبق قانون غودهارت (Goodhart's law) بقوة غير معتادة على هذه العائلة من المقاييس (انظر الموضوع 1.2، قانون غودهارت وسيكولوجية المقاييس)، لأن الأرقام رخيصة الجمع ومرئية للجميع وسهلة التحريك دون تغيير الشيء الذي أُريد لها أن تمثله. وكل توصية أدناه مكتوبة مع وضع ذلك في الحسبان.
المؤلف (author) فتح طلب الدمج والمراجع (reviewer) يقيّمه. وجولة المراجعة (review round) حلقة واحدة من «يدفع المؤلف، ويستجيب المراجع». وإعادة العمل (rework) تغيير يجرى بعد تعليق مراجعة، أو بعد الدمج، لإصلاح شيء أخطأت فيه النسخة الأولى. والتكامل المستمر (CI) هو ممارسة دمج العمل في خط مشترك كثيرًا وفحص كل دمج تلقائيًا؛ انظر التكامل المستمر (continuous integration).
كل المقاييس في هذا الموضوع تصف الفرق والمستودعات. وهي لا ترتّب المراجعين أو المؤلفين أبدًا. أعداد المراجعة على مستوى الفرد سهلة الاستخراج ومغرية الاستخدام، وفعل ذلك يحول ممارسة تعاون إلى مسابقة (انظر الموضوع 9.1، صحة الفريق وتجربة المطورين).
المبادئ الأساسية
- الانتظار يهيمن على المراجعة. في معظم الفرق، الجزء الأكبر من زمن المراجعة هو طلب الدمج جالسًا دون قراءة، لا النقاش بعد أن يبدأ المراجع. قِس الانتظار قبل أن تقيس الحوار.
- التغييرات الصغيرة تُراجَع أسرع وأفضل. الحجم من الرافعات القليلة التي تحسن السرعة والدقة معًا، لأن المراجع يستطيع أن يحمل تغييرًا صغيرًا في رأسه.
- السرعة بدون تدقيق ليست تحسنًا. كل مقياس سرعة في هذا الموضوع يحتاج إلى نظير جودة، ويُقرأ الزوج معًا.
- المراجعة سعة للفريق لا لشخص. ينبغي أن ينتشر الحمل عبر الفريق. المقياس الذي يُظهر تركزًا يشير إلى مشكلة تصميم في الفريق، لا إلى شخص يُمدح أو يُلام.
- التوزيعات تتفوق على المتوسطات. لأزمنة المراجعة ذيل طويل من طلبات الدمج العالقة، فأبلِغ الوسيط ونسبة مئوية عالية (انظر الموضوع 1.6، الثقافة الإحصائية لمقاييس الخدمة).
- عرّف الساعة ثم دعها. اذكر متى تبدأ الساعة وتتوقف، وأي الأحداث توقفها مؤقتًا، وأي النشاط الآلي مستثنى، واكتب ذلك حيث تعيش البيانات (انظر الموضوع 1.5، مصادر البيانات وأدوات القياس).
- تخدم مقاييس المراجعة الفريق الذي يملك العمل. إنها مدخل لاجتماع مراجعة الفريق نفسه، لا بطاقة أداء لغيره.
تعريفات المقاييس
تفترض الساعات أدناه أن منصة التحكم في الإصدارات تسجل أزمنة أحداث الفتح وطلبات المراجعة والتعليقات والموافقات والدفعات والدمج. تُستثنى المسودات وطلبات الدمج التي تفتحها الروبوتات وطلبات الدمج المغلقة دون دمج ما لم يقل صف خلاف ذلك. «ساعات العمل» تعني ساعات عمل الفريق المعلنة، فلا يجمع طلب دمج فُتح مساء الجمعة عطلة نهاية أسبوع من الانتظار.
| المقياس | التعريف | الصيغة | الوحدة | مصدر البيانات | ممارسة ITIL | المقابل في الأجايل | التكرار |
|---|---|---|---|---|---|---|---|
| الزمن إلى أول مراجعة | الانتظار بين صيرورة طلب الدمج جاهزًا للمراجعة وأول استجابة بشرية جوهرية | تبدأ الساعة حين يخرج طلب الدمج من حالة المسودة أو يُفتح جاهزًا، وتتوقف عند أول تعليق مراجعة أو طلب تغيير أو موافقة من أحد غير المؤلف؛ تُستثنى تعليقات الروبوتات والمؤلف وتغييرات الوسوم المحضة. أبلِغ الوسيط والنسبة المئوية 85 بساعات العمل | ساعات عمل | سجل أحداث منصة التحكم في الإصدارات | تطوير البرمجيات وإدارتها؛ تمكين التغيير | اتفاقية عمل حول استجابة المراجعة؛ تدفق العمل قيد التنفيذ | أسبوعي |
| زمن دورة المراجعة | الزمن الكلي من الجاهزية للمراجعة إلى الدمج | تبدأ الساعة حين يصبح طلب الدمج جاهزًا للمراجعة وتتوقف عند الدمج؛ تُستثنى طلبات الدمج المغلقة دون دمج وتُعد على حدة. أبلِغ الوسيط والنسبة المئوية 85 بساعات العمل | ساعات عمل | سجل أحداث منصة التحكم في الإصدارات | إدارة النشر؛ تمكين التغيير | زمن دورة مرحلة المراجعة على لوحة الفريق | أسبوعي |
| حجم طلب الدمج | مقدار التغيير في طلب الدمج | الأسطر المضافة زائد الأسطر المحذوفة، باستثناء الملفات المولدة وملفات القفل والشيفرة المضمنة وإعادات التسمية المحضة، كما هو مسرود في قواعد التجاهل في المستودع. أبلِغ الوسيط والنسبة المئوية 85 لكل طلب دمج مدموج | أسطر متغيرة | إحصاءات الفروق في منصة التحكم في الإصدارات | تطوير البرمجيات وإدارتها | حجم الدفعة الصغير؛ تقطيع القصص | أسبوعي |
| جولات المراجعة | عدد حلقات دفع المؤلف واستجابة المراجع قبل الدمج | عدد دورات «طُلبت تغييرات» أو تعليق-ثم-دفع المتميزة لكل طلب دمج مدموج؛ التقديم الأول هو الجولة صفر وتُستثنى إخفاقات الفحص الآلي. أبلِغ الوسيط والنسبة المئوية 85 | عدد | أحداث المراجعة والدفع في منصة التحكم في الإصدارات | التحسين المستمر؛ تطوير البرمجيات وإدارتها | إشارة إعادة العمل في مرحلة المراجعة؛ تعريف الإنجاز | أسبوعي |
| تركز حمل المراجعة | مدى عدم تساوي توزيع عمل المراجعة عبر الفريق | حصة المراجعات المكتملة للفريق التي عالجها أكثر مراجعين انشغالًا على 4 أسابيع متحركة؛ تُستثنى مراجعات طلب الدمج الخاص بالمرء ومراجعات الروبوتات. يُبلَّغ للفريق، لا بالاسم أبدًا | نسبة مئوية | أحداث المراجعة في منصة التحكم في الإصدارات، مجمعة على مستوى الفريق | التحسين المستمر؛ إدارة المعرفة | ملكية الشيفرة المشتركة؛ الملكية الجماعية | شهري |
| عدد طلبات الدمج الراكدة | طلبات الدمج المفتوحة أكثر من حد الفريق المتفق عليه | طلبات الدمج التي ما زالت مفتوحة وليست مسودات ويتجاوز عمرها منذ الجاهزية للمراجعة حد الفريق، تُعد عند وقت اللقطة؛ تُستثنى المسودات | عدد | قائمة طلبات الدمج المفتوحة في منصة التحكم في الإصدارات | تمكين التغيير؛ التحسين المستمر | عمر بند العمل؛ حد WIP | أسبوعي |
| معدل الإصلاح بعد الدمج | حصة طلبات الدمج المدموجة التي يتبعها تغيير تصحيحي قريبًا | طلبات الدمج المدموجة التي يتبعها خلال 14 يومًا إصلاح أو تراجع أو إصلاح عاجل مرتبط بالتغيير نفسه / طلبات الدمج المدموجة في الفترة؛ يُستثنى عمل المتابعة المخطط الموسوم بذلك | نسبة مئوية | تاريخ التحكم في الإصدارات والقضايا المرتبطة وسجلات الحوادث أو التغيير | تمكين التغيير؛ إدارة الحوادث | الجودة المبنية؛ تعريف الإنجاز | شهري |
الزمن إلى أول مراجعة أكبر رافعة، وهو المقياس الذي ينبغي لمعظم الفرق أن تبدأ به. زمن دورة المراجعة هو مقياس نتيجته وجزء من أزمنة الانتظار الكلي الأطول المناقشة في الموضوع 2.2. نافذة الـ14 يومًا وحد الركود أمثلة؛ يختار كل فريق قيمًا تناسب إيقاع إصداراته ويكتبها. وحيث تغذي الأرقام صورة التسليم الأوسع، تتولى عائلة DORA (انظر الموضوع 2.8، مقاييس DORA) ومقاييس فشل التغيير (انظر الموضوع 4.4، فشل التغيير وإعادة العمل).
التوصيات
قِس الانتظار قبل العمل
1. ابدأ بالزمن إلى أول مراجعة. هذا عادة أكبر مساهم في زمن المراجعة وأرخص ما يُحسَّن. جهّزه من سجل أحداث المنصة حتى لا يضطر أحد إلى إدخال شيء. أبلِغ الوسيط ونسبة مئوية عالية، لأن وسيطًا من ثلاث ساعات مع نسبة مئوية 95 من أربعة أيام يعني أن بعض التغييرات تُنسى.
2. استثنِ الروبوتات والمسودات من الساعة، وقل ذلك. تنشئ الفحوص الآلية وروبوتات تحديث الاعتماديات وأدوات التنسيق تعليقات في ثوان، وعدّها يجعل الانتظار يبدو ممتازًا. ابدأ الساعة حين يعلّم المؤلف التغيير جاهزًا، لا حين يُدفع الفرع أول مرة. انشر هذه القواعد بجوار المخطط.
3. استخدم ساعات العمل، واكتب تقويم الفريق. لا ينبغي أن يحمل طلب دمج فُتح متأخرًا يوم الجمعة عطلة نهاية أسبوع من الانتظار. الفريق الموزع عبر مناطق زمنية يحتاج قاعدة لساعات من تُحتسب، وكثيرًا ما يكون الجواب الصادق أن كلفة التسليم عبر المناطق هي ما يستحق الرؤية. اذكر الاختيار وأبقِه ثابتًا.
شكّل العمل ليكون قابلًا للمراجعة
4. أبقِ طلبات الدمج صغيرة، وعامل الحجم عادة فريق. تتبع الوسيط والنسبة المئوية 85 للحجم، وانظر إلى الكبيرة منها مجموعةً لا إخفاقات فردية. عادة تجد الفرق أن التغييرات الكبيرة تأتي من أسباب قليلة: عمل لم يُقطّع بدقة كافية، أو خلط إعادة الهيكلة بسلوك جديد، أو الانتظار طويلًا للدمج. قطّع العمل بحيث يفعل كل طلب دمج شيئًا واحدًا، وهذا يطابق مبدأ الدفعة الصغيرة وراء التطوير القائم على الجذع (trunk-based development) والنشر المتكرر.
5. لا تضع سقفًا صارمًا للحجم هدفًا. حد مثل «لا أكثر من 400 سطر» يدعو إلى تقسيم تغيير إلى قطع مصطنعة غير مقروءة منفردة أو تكسر البناء حين تُدمج وحدها. استخدم الحجم بادئًا للحوار في اجتماع المراجعة، وأعطِ الفريق تقنيات للتقطيع، مثل مفاتيح الميزات وإعادة الهيكلة التمهيدية في طلب دمج خاص بها والدمج خلف علم.
6. اجعل طلب المراجعة صريحًا. طلب الدمج الذي لا يسمي مراجعًا ينتظر متطوعًا، والمتطوعون نادرون. اتفقوا على من يُطلب منه، وكيف يُبلَّغ الفريق، وما توقع الاستجابة، في اتفاقية العمل. جدول مراجعة مشترك، أو خانة مراجعة يومية، يقلل الانتظار عادة أكثر من أي إعداد أداة.
وزّع الحمل والمعرفة
7. راقب تركز الحمل مخاطرة على مستوى الفريق. إن عالج شخصان معظم المراجعات، فتوافرهما يحد من تدفق الفريق، وغيابهما يوقفه. راجع قياس التركز شهريًا، وتصرف عبر تصميم الفريق: دوّر المراجع الافتراضي، واقرن الأعضاء الأحدث بالخبراء، واكتب مجالات الشيفرة التي لا يستطيع مراجعتها إلا شخص واحد. لا تنشر لوحة ترتيب لكل شخص.
8. استخدم المراجعة لنشر المعرفة، واحمِ هذه الغاية. تشمل القيمة طويلة الأمد للمراجعة التعلم والملكية المشتركة والأسلوب المتسق، إضافة إلى اكتشاف العيوب. تنقل البرمجة الثنائية (pair programming) والبرمجة الجماعية بعض ذلك التبادل إلى مرحلة أبكر في العملية؛ وحيث عمل زوج على تغيير بالفعل، فمراجعة أخف معقولة. اجعل الاختيار قرار فريق، مكتوبًا في اتفاقية العمل، ليكون «عمل ثنائي، فمراجعة خفيفة» قاعدة مرئية لا عذرًا.
اضبط المراجعة نفسها
9. دع الأتمتة تتولى ما تجيده. ينتمي التنسيق وفحص الأسلوب والفحوص الأساسية إلى خط الأنابيب، فيذهب الانتباه البشري إلى التصميم والصحة والمخاطر. يقلل التحليل الساكن للبرامج (static program analysis) والاختبارات الآلية عدد جولات المراجعة التافهة. وتقول الجولات المتبقية حينها أكثر عن حوار التصميم وأقل عن خلافات الأسلوب.
10. اقرأ جولات المراجعة إشارةً عن الوضوح لا عدّ أخطاء. قد تعني الجولات الكثيرة أن المتطلب كان غير واضح، أو أن المؤلف يفتقر إلى السياق، أو أن المراجع طلب تغييرات ذوقية، أو أن التغيير كان كبيرًا. وصفر جولات في كل طلب دمج قد يعني عملًا ممتازًا أو أن أحدًا لم ينظر. خذ عينة من حفنة طلبات دمج ذات جولات كثيرة بشكل غير عادي أو قليلة بشكل غير عادي واقرأها معًا كفريق.
اقرن السرعة بالجودة، وأبقِ الزمن مرئيًا
11. أظهر دائمًا نظير جودة بجوار سرعة المراجعة. معدل الإصلاح بعد الدمج، والحوادث المرتبطة بالتغييرات الأخيرة، وحصة العيوب المكتشفة بعد الإصدار، هي الشركاء الطبيعيون (انظر الموضوع 4.4، فشل التغيير وإعادة العمل). إن تحسن زمن المراجعة بينما ساء معدل الإصلاح، فقد استبدل الفريق الضمان بالسرعة، والإصلاح حوار لا هدف. أظهر الاثنين في المخطط نفسه.
12. اربط المراجعة بصورة التدفق وبالعمل غير المخطط. تفيد المراجعة الأسرع فقط إذا لم تضع المرحلة التالية العمل في طابور (انظر الموضوع 2.3، العمل قيد التنفيذ والطوابير). وطلبات المراجعة العاجلة التي تقاطع العمل المخطط لها كلفتها الخاصة (انظر الموضوع 2.9، العمل التشغيلي والعمل غير المخطط).
مسارات التلاعب وحواجز الحماية
| المقياس | كيف يُتلاعب به | حاجز الحماية أو الممارسة المقترنة |
|---|---|---|
| الزمن إلى أول مراجعة | نشر «يبدو جيدًا» أو رمز تعبيري سريع بوصفه الاستجابة الأولى؛ إسناد روبوت أو مراجع ودود؛ تعليم طلب الدمج جاهزًا فقط بعد أن يتفق أحد مسبقًا على النظر | معدل الإصلاح بعد الدمج؛ عينة من الموافقات بلا تعليقات؛ اشتراط أن تكون الاستجابات الأولى جوهرية في اتفاقية العمل |
| زمن دورة المراجعة | الدمج دون انتظار المراجعة؛ تقسيم تغيير إلى قطع صغيرة ليمر أسرع؛ إغلاق طلب الدمج وإعادة فتحه لإعادة ضبط الساعة | عُدّ طلبات الدمج المغلقة والمعاد فتحها؛ جولات المراجعة؛ معدل الإصلاح بعد الدمج؛ قواعد الفروع المحمية التي تشترط الموافقة |
| حجم طلب الدمج | استثناء ملفات من العدّ؛ تقسيم تغيير واحد إلى قطع لا تُفهم منفصلة؛ حشو الحجم بشيفرة مولدة | راجع قواعد التجاهل كل ربع؛ تحقق من أن القطع المقسمة تبني وتجتاز الاختبارات وحدها؛ اقرأ عينة من الأصغر والأكبر |
| جولات المراجعة | الموافقة من المرة الأولى لإبقاء العدد منخفضًا؛ نقل النقاش إلى الدردشة فلا يترك أثرًا؛ دفع المؤلفين إصلاحات كثيرة في إيداع واحد لإخفاء الجولات | معدل الإصلاح بعد الدمج؛ عينة من طلبات الدمج ذات الجولات الصفرية؛ أبقِ النقاش في طلب الدمج |
| تركز حمل المراجعة | تقسيم المراجعات إلى موافقات صغيرة كثيرة لنشر العدد؛ إسناد المراجعات لمن لديهم وقت فراغ لكن بلا معرفة | راجع معرفة المراجع في المجالات الخطرة؛ راقب معدل الإصلاح بعد الدمج بحسب المجال؛ أبقِ المقياس على مستوى الفريق |
| عدد طلبات الدمج الراكدة | إغلاق طلبات الدمج الراكدة دون دمج؛ تحويلها إلى مسودات لإخفائها؛ رفع حد الركود | عدد طلبات الدمج المغلقة دون دمج؛ عدد المسودات طويلة الأمد؛ راجع الحد مع الفريق كل ربع |
| معدل الإصلاح بعد الدمج | تسجيل الإصلاحات تحت بند عمل جديد بلا رابط؛ وسم العمل التصحيحي متابعة مخططة؛ تجنب المقياس بتأخير الإصلاح خارج النافذة | قارن ببيانات الحوادث وفشل التغيير؛ عينة من بنود المتابعة؛ تدقيق الوسوم المستخدمة |
القراءة السليمة هادئة. الزمن إلى أول مراجعة قصير وذيله قصير أيضًا، فلا ينتظر طلب دمج أيامًا. الحجم في نطاق يجده الفريق سهل القراءة، مع بضعة تغييرات كبيرة يستطيع الفريق شرحها. جولات المراجعة منخفضة لكن ليست صفرًا، والتركز معتدل، وعدد الراكدة صغير، ومعدل الإصلاح بعد الدمج ثابت. وحين يتحسن رقم بحدة، ينبغي أن يتحقق أحد من أن حاجز الحماية المقترن به لم يتحرك في الاتجاه الخاطئ.
المفاضلات: الإيجابيات والسلبيات
| النهج | نقطة القوة | نقطة الضعف |
|---|---|---|
| مراجعة سريعة بتوقعات استجابة صارمة | حلقات تغذية راجعة قصيرة؛ فقدان سياق أقل للمؤلف؛ عمل قيد التنفيذ أقل | ضغط للموافقة بسرعة؛ يقاطع العمل المركز |
| مراجعة بطيئة ودقيقة | قراءة متأنية للتصميم والمخاطر؛ نقل معرفة أقوى | زمن دورة أطول؛ تتراكم دفعات أكبر؛ ينتقل المؤلفون ويفقدون السياق |
| طلبات دمج صغيرة | أسهل في القراءة والتراجع؛ تدفق أسلس | عبء أكبر لكل تغيير؛ قد تجزّئ ميزة إلى خطوات مربكة |
| طلبات دمج كبيرة | تسليمات أقل؛ الميزة كاملة ظاهرة دفعة واحدة | تصبح المراجعات سطحية؛ أصعب في التراجع؛ انتظارات طويلة |
| موافقة مطلوبة من مالك مسمّى | مساءلة واضحة للمجالات الخطرة؛ تدعم تفويض التغيير | تخلق عنق زجاجة ونقطة فشل منفردة |
| فحوص آلية قبل المراجعة البشرية | تحرر الناس للتصميم والمخاطر؛ متسقة | قد تخلق ثقة زائفة؛ تحتاج صيانة |
لا سياسة واحدة تفوز. الغاية تقصير الانتظار مع حفظ التدقيق، والطريق المعتاد تغييرات أصغر، وتوقعات مراجعة واضحة، وأتمتة قوية للفحوص الروتينية، واتفاق فريق على شكل المراجعة الجيدة. مقاييس المراجعة أنفع ما تكون أسئلة لاجتماع مراجعة وأقل نفعًا أهدافًا.
أسئلة للنقاش مع فريقك
1. أين يقضي طلب الدمج معظم حياته، منتظرًا أم مراجَعًا؟ اطلب من الفريق التخمين قبل النظر في البيانات، ثم أظهر الانقسام بين الزمن إلى أول مراجعة وبقية الزمن إلى الدمج. تُفاجأ معظم المجموعات بمدى ما هو انتظار. على الميسّر أن يدوّن أي التخمينات كانت خاطئة ويسأل ماذا يقول كل تخمين خاطئ عن كيفية اختبار الفريق للمراجعة. اختم بتغيير واحد يهاجم أكبر انتظار.
2. كيف تبدو المراجعة الجيدة في هذا الفريق، وكيف سيعرف غريب؟ اسرد السلوكيات التي يقدّرها الفريق، مثل السؤال عن التصميم وفحص الاختبارات وشرح سبب طلب. ثم اسأل أيها يترك أثرًا مرئيًا في طلب الدمج. ناقشوا كيف يُفرَّق بين استجابة أولى جوهرية ورمزية دون مراقبة الأفراد. اتفقوا على وصف مكتوب قصير لوضعه في اتفاقية العمل.
3. ما الحجم الكبير جدًا لنا، وماذا نفعل حين يكون العمل كبيرًا حقًا؟ انظر إلى توزيع الحجم واختر بضعة من أكبر طلبات الدمج. اسأل لماذا كان كل منها كبيرًا وهل كان يمكن تقطيعه. ناقشوا تقنيات مثل مفاتيح الميزات وإعادة الهيكلة التمهيدية والدمج خلف علم. على الميسّر أن يقاوم وضع حد رقمي وأن يتفق بدلًا من ذلك على عادة يجربها الفريق شهرًا.
4. من يراجع شيفرتنا الأخطر، وماذا يحدث حين يغيبون؟ اربط مجالات الشيفرة بالأشخاص القادرين على مراجعتها جيدًا. انظر إلى تركز الحمل وإلى المجالات التي لها مراجع واحد مؤهل. ناقشوا كيف تنمّون مراجعًا ثانيًا في كل منها، بالزمالة أو بتدوير التكليفات. أبقِ الحوار عن مرونة الفريق، لا عن ترتيب حمل أي شخص.
5. لو تضاعفت سرعة مراجعتنا غدًا، فماذا نريد أن يكون صحيحًا عن الجودة؟ اطلب من المجموعة تسمية إشارات الجودة التي ستراقبها، مثل الإصلاحات بعد الدمج أو الحوادث المرتبطة بالتغييرات الحديثة أو عدد التراجعات. تحقق هل هذه الإشارات مرئية حاليًا بجوار مخطط السرعة. ناقشوا ما سيكون علامة مبكرة على أن السرعة اشتريت على حساب التدقيق. اتفقوا على أي نظير يُعرض على اللوحة.
6. أي أرقام المراجعة سنكون مغرين بتحسينها بطريقة لا تفيد؟ مرّوا على كل مقياس واسألوا كيف يمكن لشخص تحت الضغط أن يجعله يبدو أفضل دون تحسين أي شيء. قارنوا الإجابات بجدول التلاعب أعلاه وأضيفوا أفكار الفريق الخاصة. الغاية تسمية الخطر قبل أن يحدث. اتفقوا على أي حاجز حماية سيُراجع إلى جانب كل مقياس.
أربعة منظورات
فرق المنتج والتسليم
تملك فرق التسليم عملية المراجعة وينبغي أن تملك مقاييسها. وتستفيد أكثر من تقصير الانتظار باتفاقيات بسيطة: خانة مراجعة يومية، وعملية طلب واضحة، وتغييرات صغيرة. وعليها استخدام الأرقام في اجتماعات المراجعة، وإبقاء العمل قيد التنفيذ منخفضًا، ومقاومة إغراء تحسين مخطط واحد. والمراجعة أيضًا حيث يتعلم الأعضاء الجدد قاعدة الشيفرة، فاحمِ هذه الغاية.
فرق الخدمة والعمليات
تلتقي فرق العمليات بالمراجعة حيث تتغير شيفرة البنية التحتية والتكوين وأتمتة أدلة التشغيل عبر طلبات الدمج. وبالنسبة لها، كثيرًا ما تكون المراجعة جزءًا من كيفية الموافقة على تغيير معياري وتوثيقه (انظر الموضوع 4.3، مقاييس تمكين التغيير). وعليها الاتفاق على أي التغييرات تحتاج مراجعة من شخص ثان، وبأي سرعة تُراجَع الإصلاحات العاجلة، وكيف تُراجَع التغييرات الطارئة بعد ذلك، لتبقى الإصلاحات المستعجلة مفحوصة. المراجعة الرقيقة على تغيير خطر تظهر لاحقًا حادثة.
القيادة والحوكمة
على القادة معاملة مقاييس المراجعة إشارات عن صحة الفريق والتدفق، لا درجات إنتاجية. وعليهم أن يطلبوا مقياس الجودة المقترن حين يُبلَّغ رقم سرعة، وأن يدعموا الوقت الذي تستغرقه المراجعة الدقيقة، وأن يتجنبوا مقارنة الفرق بزمن المراجعة الخام لأن المستودعات والمخاطر تختلف. ويمكن لهيئات الحوكمة استخدام دليل المراجعة جزءًا من ضمان التغيير، بشرط قبول أن عملية مراجعة موثقة وبالعينة أقوى من عدّ الموافقات.
العملاء والمستخدمون
لا يرى العملاء طلبات الدمج، لكنهم يشعرون بنتائجها: كم يسرع وصول الإصلاح وكم مرة يجلب إصدار عيبًا جديدًا. تساعد أوقات انتظار المراجعة القصيرة الإصلاحات العاجلة على الوصول إليهم أسرع، وتساعد المراجعة المتأنية على إبقاء الأعطال بعيدة عنهم. وحيث للخدمة تاريخ إصدار أو عيوب منشور، يستفيد العملاء حين يُظهر الفريق تراجعات أقل وإصلاحات متكررة أقل عبر الزمن.
في الممارسة: مثال من إدارة الخدمات
تدير إدارة تقنية المعلومات في مستشفى إقليمي خدمة ويب لمواعيد المرضى، بناها فريق منتج من سبعة ويشغّلها فريق موثوقية مواقع صغير. جميع الأرقام في هذا المثال توضيحية.
في مراجعة ربع سنوية، يجد الفريق أن زمن دورة مراجعته له وسيط 26 ساعة عمل ونسبة مئوية 85 قدرها 71 ساعة عمل (توضيحي). ويُظهر تقسيم الدورة أن وسيط الزمن إلى أول مراجعة 19 ساعة عمل، فمعظم التأخير انتظار. وحجم طلب الدمج له وسيط 180 سطرًا ونسبة مئوية 85 قدرها 900 سطر (توضيحي)، ويعالج أكثر مراجعين انشغالًا 68 في المئة من المراجعات (توضيحي). ومعدل الإصلاح بعد الدمج عند 9 في المئة (توضيحي).
يتخذ الفريق ثلاثة اتفاقات. يحدد خانة مراجعة يومية من 30 دقيقة، ويكتب توقع استجابة أولى خلال يوم عمل في اتفاقية عمله، ويدوّر واجب «المراجعة أولًا» كل أسبوع. ويعتمد أيضًا عادة تقطيع للعمل الكبير، مستخدمًا مفاتيح الميزات لتُدمج الميزات الجزئية بأمان. ولا يضع حد حجم ولا هدفًا للزمن إلى أول مراجعة.
بعد شهرين ينخفض وسيط الزمن إلى أول مراجعة إلى 6 ساعات عمل وتنخفض النسبة المئوية 85 لزمن دورة المراجعة إلى 34 ساعة عمل (توضيحي). وينخفض تركز الحمل إلى 52 في المئة (توضيحي)، ويثبت معدل الإصلاح بعد الدمج عند 9 في المئة.
ثم يلتقط الفريق خطر تلاعب. تُظهر عينة من الموافقات أن نحو ثلث الاستجابات الأولى يصل في دقائق ولا يقرأ إلا «LGTM» على تغييرات تمس منطق تذكير المواعيد. كان مكسب السرعة حقيقيًا جزئيًا وختمًا مطاطيًا جزئيًا. لم يتحرك معدل الإصلاح بعد الدمج بعد لأن الشيفرة المتأثرة تعمل في دورة شهرية. يغير الفريق اتفاقية العمل بحيث يجب أن تتضمن الاستجابة الأولى سؤالًا أو تعليقًا عن جزء محدد من التغيير أو ملاحظة صريحة بما فُحص، ويضيف حصة الموافقات المأخوذة بالعينة بلا تعليق إلى مخطط مراجعته. ويتفقون أيضًا على أن التغييرات في منطق التذكير الموجه للمرضى تحتاج مراجعين اثنين، أحدهما من مجموعة العمليات. ويدخل القرار وأسبابه في سجل قرارات الفريق.
الأجايل والذكاء الاصطناعي والأتمتة والتحليلات
الأجايل
المراجعات السريعة الصغيرة تدعم التسليم المستمر والوتيرة المستدامة. وعادة عملية الاتفاق على معيار للفريق للزمن إلى أول مراجعة والحديث عن طلبات الدمج الراكدة في مراجعة الفريق المنتظمة. والتحذير أن سرعة المراجعة المعاملة هدفًا تقود إلى الختم المطاطي، فاقرنها بالإصلاحات بعد الدمج.
الذكاء الاصطناعي
قد ترفع التغييرات المولدة بالذكاء الاصطناعي حجم طلبات الدمج وحجم كل منها، وقد تسرع أدوات المراجعة بالذكاء الاصطناعي النظرة الأولى. اقرن الزمن إلى أول مراجعة بمعدل الإصلاح بعد الدمج للتغييرات المدعومة بالذكاء الاصطناعي، وأبلِغ حمل المراجعة بحسب دور المراجع لا بحسب الشخص. والتحذير أن تعليق مراجعة من روبوت قد يُحتسب مراجعة، فعُدّ المراجعة البشرية على حدة.
الأتمتة
اسحب أحداث المراجعة من مضيف الشيفرة تلقائيًا، وشغّل فحوصًا آلية قبل المراجعة البشرية ليقضي الناس الوقت على الحكم. وقِس الفحوص نفسها على الإنذارات الكاذبة وعلى العيوب التي تفلت منها. والتحذير أن الأتمتة الكثيفة قد تجعل المراجعة البشرية سطحية، إذ يفترض الناس أن الأدوات التقطت كل شيء.
التحليلات
أظهر توزيعات الحجم والزمن إلى أول مراجعة وجولات المراجعة بحسب الفريق، لا الفرد أبدًا. والقرار الذي يفيد فيه هو أين تحتاج سعة المراجعة أو حجم التغيير إلى انتباه. والتحذير أن هذه الأرقام تصف نظام المراجعة، وأي استخدام يرتّب الأشخاص سيدفعها نحو تغييرات أصغر وأكثر أمانًا وأقل فائدة.
منظور القطاعات
الشركات الناشئة. يستطيع فريق صغير المراجعة في دقائق لأن الجميع يعرف الشيفرة، والخطر الرئيسي تخطي المراجعة حين يضيق الوقت. أبقِ المقاييس قليلة: الزمن إلى أول مراجعة والحجم يكفيان. أرسِ عادة التغييرات الصغيرة مبكرًا، فإدخالها أصعب بكثير بعد أن تكبر قاعدة الشيفرة والفريق.
الأعمال الصغيرة. كثيرًا ما يصون البرمجيات مطور أو اثنان، أو مورد خارجي. قد تكون المراجعة من زميل واحد أو من كوادر المورد. اسأل الموردين كيف يراجعون وهل يمكن مشاركة بيانات طلبات الدمج، واحتفظ بسجل بسيط بأي التغييرات راجعها من، لأن المراجعة هي الفحص الرئيسي ضد الأخطاء في فريق صغير.
المؤسسات الكبرى. الفرق والمستودعات وقواعد الموافقة الكثيرة تخلق تباينًا واسعًا. وحّد تعريفات الساعات والاستثناءات لتكون بيانات المنصة قابلة للمقارنة، لكن لا ترتب الفرق بزمن المراجعة الخام، فالمخاطر وقاعدة الشيفرة تختلفان. وراقب متطلبات المراجعة المفروضة للتدقيق التي تضيف انتظارًا دون تدقيق، وابحث عن فرص لاستبدال الموافقات اليدوية بفحوص آلية ومراجعة بالعينة.
الحكومة والقطاع العام. تتطلب قواعد فصل المهام ومسارات التدقيق والمشتريات غالبًا موافقة مستقلة على التغييرات. عاملها مدخلات تصميم: سجّل من وافق على ماذا ومتى، وقِس الانتظار الذي تخلقه. وحيث يكتب الموردون الشيفرة، حدد دليل المراجعة والوصول إلى البيانات في العقد (انظر الموضوع 8.5، التقارير التنظيمية والحكومية).
مبررات الأعمال: الدوافع والعائد على الاستثمار والتكلفة الإجمالية للملكية
الدافع تقصير جزء من التسليم بطيء ومتحكَّم فيه في آن، مع الاحتفاظ بفوائد مراجعة الأقران: عيوب أقل ومعرفة مشتركة ومسار تدقيق. تحجز طلبات الدمج المنتظرة العمل المنتهي عن المستخدمين، وترفع كلفة تبديل السياق للمؤلفين، وتجعل تعارضات الدمج أرجح مع تقادم الفروع. لذلك يؤتي تقليل الانتظار ثماره عبر تسليم أسرع وإعادة عمل أقل وإحباط أقل.
كلفة جمع هذه المقاييس منخفضة حين توفر منصة التحكم في الإصدارات سجل أحداث وواجهة برمجية. الكلف الرئيسية هي وقت تعريف الساعات والاستثناءات، وبناء التقرير أو تكوينه، ومراجعة الأرقام بانتظام. والكلفة الأكبر سلوكية: الوقت الذي يمنحه الناس للمراجعة السريعة، وهو ينافس عملًا آخر. هذا الوقت هو الاستثمار الحقيقي، وينبغي أن يُدرج في الميزانية لا أن يُعامل مجانيًا.
يظهر العائد في صورة زمن دورة مراجعة أقصر، وطلبات دمج راكدة أقل، ومعدل إصلاح بعد الدمج ثابت أو متناقص. تجنب الادعاء مسبقًا بنسبة تحسن محددة، لأن النتائج تعتمد على نقطة البداية والفريق. الحالة الموثوقة تقارن توزيعات الفريق نفسه قبل وبعد، مع نظير جودتها، بدل اقتباس أرقام من مؤسسات أخرى. يفيد كتاب Accelerate لعام 2018، الذي يبلّغ أبحاثًا تربط الممارسات التقنية والثقافية بأداء التسليم، مصدرًا معقولًا للحجة العامة، لكن أرقام فريقك تأتي من بياناتك.
الأنماط المضادة والمزالق
- ترتيب المراجعين أو المؤلفين. قوائم الترتيب الفردية للمراجعات المكتملة أو الأسطر المتغيرة تفسد التعاون. أبلِغ على مستوى الفريق واستخدم الأرقام لضبط عادات الفريق.
- استهداف الزمن إلى أول مراجعة دون نظير جودة. النتيجة الختم المطاطي. أظهر معدل الإصلاح بعد الدمج وعينة من الموافقات بلا تعليق بجوار كل مخطط سرعة.
- وضع سقف صارم للحجم. تقسم الفرق العمل اصطناعيًا للامتثال. استخدم الحجم حوارًا وعلّم تقنيات التقطيع بدلًا من ذلك.
- معاملة صفر تعليقات نجاحًا. قد تعكس الموافقة غير المفحوصة ثقة أو عدم انتباه. خذ عينة من طلبات الدمج هذه واقرأها معًا.
- عدّ نشاط الروبوتات مراجعة. التعليقات الآلية تجعل الانتظار يبدو قصيرًا. استثنِ الروبوتات من الساعة ومن قياسات الحمل.
- تجاهل المناطق الزمنية والتقاويم. ساعة الجدار الخام تجعل انتظار عطلة الأسبوع والمناطق يبدو مراجعة بطيئة. استخدم ساعات العمل وسمِّ التقويم.
- ترك قائمة الراكد تنمو. تتراكم على طلبات الدمج القديمة تعارضات الدمج وتفقد السياق. راجع القائمة أسبوعيًا وإما ادمج أو أعد العمل أو أغلق كل بند بسبب.
نموذج النضج
| البُعد | 1 البدء | 2 التطوير | 3 التوحيد | 4 الإدارة | 5 التنسيق |
|---|---|---|---|---|---|
| التعريف والساعات | زمن المراجعة يُخمَّن أو يُبلَّغ بالإحساس | بعض الفرق تصدّر الأزمنة من المنصة بقواعدها الخاصة | تعريف مكتوب واحد لكل ساعة، مع استثناءات للروبوتات والمسودات والتقاويم | تُراجَع التعريفات بإيقاع؛ تُسجَّل التغييرات بأسبابها | تتسق التعريفات عبر الفرق والموردين وتُنقَّح حين تكف عن الإفادة في القرارات |
| ممارسة المراجعة | المراجعات تحدث حين ينتبه أحد | أعراف غير رسمية في بعض الفرق | اتفاقية عمل مكتوبة حول الطلبات وتوقعات الاستجابة وما تغطيه المراجعة | تُضبط الأعراف من البيانات؛ يُتتبَّع نشر المعرفة والمجالات الخطرة | تُنسَّق ممارسة المراجعة عبر الفرق والموردين، والأتمتة تتولى الفحوص الروتينية |
| نظير الجودة | لا رابط بين المراجعة والعيوب | نظرة عرضية على الإصلاحات بعد الدمج | معدل الإصلاح بعد الدمج معروض بجوار سرعة المراجعة | تُراجَع حواجز الحماية بانتظام؛ تُقرأ الموافقات المأخوذة بالعينة | يرتبط دليل المراجعة بضمان التغيير والتعلم من الحوادث عبر الخدمات |
| الاستخدام في التحسين | الأرقام غير مستخدمة | تُعرض في بعض اجتماعات المراجعة | يراجعها الفريق المالك وفق إيقاع ثابت | تقود الفجوات إلى عمل تحسين مخطط وممول بالموارد | أفكار التحسين تنتقل من الفرق إلى الممارسة المشتركة وتعود |
قائمة التحقق
- ساعات الزمن إلى أول مراجعة وزمن دورة المراجعة مكتوبة، بالبدء والتوقف والاستثناءات.
- الروبوتات والمسودات وطلبات الدمج المغلقة دون دمج مستثناة أو معدودة على حدة، والقواعد مرئية.
- تُبلَّغ الأزمنة وسيطًا ونسبة مئوية عالية بساعات العمل.
- يُقاس حجم طلب الدمج بقائمة تجاهل متفق عليها للملفات المولدة والمضمنة.
- لدى الفريق اتفاقية مكتوبة حول كيفية طلب المراجعات وكم سريعًا تُتوقع الاستجابة الأولى.
- يُبلَّغ تركز حمل المراجعة على مستوى الفريق فقط.
- معدل الإصلاح بعد الدمج أو نظير جودة آخر معروض في المخطط نفسه الذي تُعرض فيه سرعة المراجعة.
- تُقرأ عينة من الموافقات بلا تعليق والسريعة جدًا كل شهر.
- تُراجَع قائمة طلبات الدمج الراكدة أسبوعيًا.
- تُستخدم بيانات المراجعة في اجتماعات المراجعة لا في التقييم الفردي.
- مجالات الشيفرة التي لها مراجع واحد مؤهل مسرودة ولها خطة.
موجِّهات الذكاء الاصطناعي
صُغ تعريفات الساعات لمقاييس المراجعة.
I want to define review metrics for [team or repository]. Our platform is
[version control platform] and our workflow is [describe: draft pull requests,
required approvals, merge rules, bots in use]. Draft precise definitions for time
to first review and review cycle time, stating the event that starts and stops
each clock, what is excluded (bots, drafts, closed unmerged), how working hours
are handled for [time zones and working calendar], and which percentiles to
report. Do not invent benchmark values or tool features. List your assumptions and
the questions I should answer to finish the definitions.
حلّل تصدير بيانات المراجعة.
Here is an anonymized export of merged pull requests for [team] over [period],
with columns [list columns, for example ready time, first review time, merge time,
lines changed, review rounds, linked fix flag]: [paste data or summary]. Compute
the median and 85th percentile for each time measure and for size, split the
review cycle into waiting and reviewing, and point out patterns that deserve a
conversation. Do not rank individuals, and do not compare with outside
benchmarks. List your assumptions and any data quality problems you notice.
ابحث عن مخاطر التلاعب في مقاييس مراجعتنا.
Our team reports these review metrics: [list metrics and how each is calculated].
The pressures on us are [for example a release deadline, a leadership target, a
supplier contract]. For each metric, describe plausible ways it could be improved
without improving review, the early signs of each, and a paired guardrail metric
or practice that would catch it. Do not invent statistics. List your assumptions
and tell me what you would need to know to rank the risks.
أعدّ اجتماع مراجعة حول تدفق المراجعة.
Prepare a 45-minute retrospective agenda for [team] on review flow. Inputs: time
to first review [value], review cycle time [value], median size [value], load
concentration [value], and post-merge fix rate [value], all labeled with their
definitions. Suggest questions that surface causes, one small experiment the team
could run for [duration], and the quality signal to watch during the experiment.
Do not invent causes or targets. List your assumptions and the data I should bring.
مهارات الذكاء الاصطناعي
- Service Management Metrics skill: استخدمها لإيجاد الموضوع الذي يعرّف مقياس تدفق أو جودة ذا صلة وحاجز الحماية الذي ينبغي أن يجلس بجوار مقياس مراجعة.
- Service Management Metrics maintainer skill: استخدمها للتحقق من أن تعديلات هذا الموضوع تُبقي القالب وجدول التلاعب والإحالات متسقة.
أهم الخلاصات
- معظم تأخير المراجعة انتظار، لذا قِس الزمن إلى أول مراجعة وزمن دورة المراجعة توزيعات بساعات العمل.
- طلبات الدمج الأصغر تُراجَع أسرع وبعناية أكبر؛ علّم التقطيع بدل فرض سقف حجم.
- اقرن كل قياس سرعة بنظير جودة، مثل معدل الإصلاح بعد الدمج، واقرأ الاثنين معًا.
- عامل حمل المراجعة سعة للفريق وأبلِغ التركز على مستوى الفريق، لا ترتيبًا للأشخاص أبدًا.
- مقاييس المراجعة أسئلة لاجتماع مراجعة، وهي تخدم الفريق الذي يملك العمل.
المراجع والقراءات الإضافية
- Forsgren, N., Humble, J., and Kim, G., Accelerate: The Science of Lean Software and DevOps, IT Revolution, 2018.
- Forsgren, N., Storey, M.-A., Maddila, C., Zimmermann, T., Houck, B., and Butler, J., "The SPACE of Developer Productivity," ACM Queue, 2021.
- Google, Code Review Developer Guide, Google Engineering Practices documentation, https://google.github.io/eng-practices/review/
- Bacchelli, A., and Bird, C., "Expectations, Outcomes, and Challenges of Modern Code Review," Proceedings of the 35th International Conference on Software Engineering (ICSE), 2013.
- Vacanti, D. S., Actionable Agile Metrics for Predictability: An Introduction, Daniel S. Vacanti, Inc., 2015.
- Schwaber, K., and Sutherland, J., The Scrum Guide, Scrum.org and Scrum Inc., 2020.
- Goodhart, C. A. E., "Problems of Monetary Management: The U.K. Experience," in Papers in Monetary Economics, Reserve Bank of Australia, 1975.
- Wikipedia, Pull request.
- Wikipedia, Version control.
- Wikipedia, Code review.
- Wikipedia, Goodhart's law.
- Wikipedia, Continuous integration.
- Wikipedia, Trunk-based development.
- Wikipedia, Pair programming.
- Wikipedia, Static program analysis.