إذا شعرت يوماً بالضيق عندما قرأت تعليقاً على طلب الدمج Pull Request الذي تعبت فيه، أو وجدت نفسك تدافع عن تصميم Design تعرف في داخلك أن فيه مشكلة، أو ترددت قبل أن تكتب لمهندس أول Senior Engineer أن في كوده خطأ Bug، فهذا المقال لك. وهو أيضاً لك إذا كنت المراجع Reviewer الذي يلاحظ أن زملاءه يتجنبون أن يرسلوا له كودهم.
الفكرة التي يدور حولها المقال قديمة، وعمرها أكثر من خمسين سنة: أن الكود ليس أنت. فعندما تربط قيمتك بالكود الذي كتبته، يصبح كل خطأ فيه هجوماً عليك، وتصبح كل مراجعة معركة، وتتوقف عن رؤية أخطائك. وسمى Gerald Weinberg الطريقة المقابلة البرمجة بلا أنا Egoless Programming، وهي اليوم أساس ما نسميه مراجعة الكود Code Review.
سوف نناقش في هذا المقال:
- من أين جاءت الفكرة في كتاب Weinberg سنة 1971، وماذا قال بالضبط.
- ما الذي لا تعنيه البرمجة بلا أنا، لأن كثيراً من الناس يفهمونها خطأ.
- الوصايا العشر Ten Commandments المشهورة، ومن كتبها فعلاً، وكيف تطبق كل واحدة منها.
- كيف تفصل نفسك عن الكود ككاتب Author وكمراجع، بحسب دليل مراجعة الكود في Google.
- الأنا في أماكن أخرى غير المراجعة: التصميم، والأعطال Incidents، و«الجزء الخاص بي» من النظام.
- مواقف شائعة، وأخطاء، وقائمة تحقق.
وقد شرحنا في مقال مراجعة الكود Code Review طريقة المراجعة نفسها: حجم الطلب، وما تبدأ به، ومتى توافق. وهنا لا نكرر ذلك، وإنما نتكلم عن الجانب النفسي الذي يجعل نفس المراجعة مفيدة في فريق ومؤذية في فريق آخر.
باختصار Quick Summary
المصدر: Gerald Weinberg في كتاب «The Psychology of Computer Programming» سنة 1971، الفصل الرابع.
ما لا تعنيه: ليست أن تتخلى عن رأيك أو عن مسؤوليتك عن الكود، وإنما ألا تربط قيمتك بأنه بلا أخطاء.
ككاتب: اطلب المراجعة مبكراً، واكتب ما لست متأكداً منه، ولا ترد وأنت غاضب.
كمراجع: علق على الكود لا على كاتبه، واشرح السبب، وحدد وزن كل تعليق، واذكر ما هو جيد.
للفريق: اجعل اكتشاف الخطأ في المراجعة نجاحاً للفريق، لا فشلاً لكاتب الكود.
من أين جاءت الفكرة؟ Weinberg 1971
نشر Gerald M. Weinberg كتابه The Psychology of Computer Programming سنة 1971، وكان من أوائل الكتب التي درست البرمجة كعمل يقوم به بشر، لا كعلاقة بين المبرمج والآلة فقط. وينقسم الكتاب إلى خمسة أجزاء: البرمجة كأداء بشري، والبرمجة كنشاط اجتماعي، والبرمجة كنشاط فردي، وأدوات البرمجة، ثم الخاتمة.
وجاءت فكرة البرمجة بلا أنا في الجزء الثاني، في الفصل الرابع بعنوان «مجموعة البرمجة» The Programming Group، تحت قسمين متتاليين: «الخطأ والأنا» Error and Ego، ثم «البرمجة بلا أنا» Egoless Programming. وفي سنة 1998 صدرت طبعة اليوبيل الفضي Silver Anniversary Edition عن دار Dorset House، وفيها النص الأصلي كما هو بنفس ترقيم الصفحات، مع تعليق جديد من Weinberg في آخر كل فصل.
ماذا قال Weinberg بالضبط؟ Error and Ego
الحجة التي يبني عليها Weinberg الفكرة بسيطة، ويلخصها في الصفحة 55 من الكتاب بما معناه: المبرمج الذي يرى برنامجه امتداداً لذاته لن يحاول أن يجد كل الأخطاء في هذا البرنامج. ثم يضيف جملة أصبحت من أشهر ما في الكتاب: أن للعين البشرية قدرة تكاد لا تنتهي على ألا ترى ما لا تريد أن تراه.
أي أن المشكلة ليست أخلاقية في الأساس، وإنما مشكلة في الإدراك. فأنت لا تخفي أخطاءك عمداً، وإنما لا تراها، لأن رؤيتها تعني أنك أخطأت، ولأنك تعرف ما كنت تقصده فتقرأ الكود كما قصدته لا كما كتبته. ولذلك فالحل الذي يقترحه ليس أن يكون المبرمج أكثر تواضعاً بالموعظة، وإنما أن تكون هناك بيئة يقرأ فيها كل مبرمج كود غيره بشكل طبيعي ومستمر.
ما الفائدة التي ذكرها؟ Benefits
ويذكر Weinberg في الصفحة 59 فوائد عملية لأن يراجع المبرمجون كود بعضهم، بعيداً عن جودة الكود نفسها:
- يقل التفاوت في وقت تصحيح الأخطاء Debugging، لأن الأخطاء تكتشف قبل أن تصل إلى مرحلة البحث الطويل.
- يصبح هناك أكثر من شخص يعرف البرنامج، وبالتالي لا يعتمد الفريق على شخص واحد.
- يصبح من الأسهل أن تعرف التقدم الحقيقي في العمل، لأنك لا تعتمد على حكم شخص واحد، وهو بتعبيره الشخص الأقل حياداً، أي كاتب الكود نفسه.
والنقطة الأخيرة مهمة لأي مدير مشروع Project Manager. فعندما يقول المبرمج «الجزء جاهز بنسبة 90%» فهو يقيم عمله هو، وهو أكثر الناس رغبة في أن يكون جاهزاً. أما عندما يقرأ الكود زميل آخر، فالتقدير يصبح أقرب إلى الواقع.
ونقلنا هذه الصفحات من مراجعة للكتاب كتبها Bruce F. Webster سنة 2012 على موقعه، واقتبس فيها من طبعة 1998 بنفس ترقيم الطبعة الأولى. ويعلق Webster بأن الفكرة كانت مثيرة للجدل في وقتها، بينما أصبحت مراجعة الكود اليوم من أفضل الممارسات المتفق عليها.

ما الذي لا تعنيه البرمجة بلا أنا؟ Common Misreadings
الاسم نفسه يسبب سوء فهم، لأن «بلا أنا» قد تفهم على أنها «بلا شخصية» أو «بلا رأي». وفيما يلي أشهر الأخطاء في فهمها:
- ليست أن تتخلى عن رأيك: المبرمج بلا أنا يدافع عن الحل الذي يراه صحيحاً، لكنه يدافع بالحجة، ويغير رأيه عندما يرى حجة أقوى. والفرق أنه يدافع عن الفكرة لا عن نفسه.
- ليست أن يملك الجميع كل شيء: بعض المراجعات للكتاب تنبه إلى أن الفكرة تفهم أحياناً كأنها ملكية جماعية للكود Collective Code Ownership، بينما يبقى كاتب الكود عند Weinberg مسؤولاً عنه. فالمراجعة تساعده، ولا تأخذ المسؤولية منه.
- ليست أن تقبل كل تعليق: بعض التعليقات خاطئة، وبعضها رأي شخصي. والمطلوب أن تفكر في التعليق بهدوء، لا أن تنفذه لأن من كتبه أعلى منك.
- ليست أن تتوقف عن الفخر بعملك: الفخر بالصنعة Craft شيء جيد، ويدفعك إلى أن تكتب كوداً أفضل. والمشكلة تبدأ عندما يصبح الفخر سبباً لترفض رؤية خطأ فيه.
- ليست أن تكون لطيفاً بلا صراحة: المراجعة التي تجامل حتى لا تجرح أحداً تفشل في وظيفتها. والهدف أن تكون الصراحة عن الكود، لا أن تختفي الصراحة.
ولاحظ أن دراسة Microsoft التي قدمها Paul Luo Li وزملاؤه في مؤتمر ICSE سنة 2015، بعد مقابلة 59 مهندساً ذوي خبرة، وضعت بين صفات المهندس العظيم صفتين تشرحان هذا التوازن. الأولى «لا يجعلها شخصية» Not making it personal، أي أن يفصل نفسه عن مشاعره وتحيزاته، ونقلوا عن أحد المهندسين أن النقاشات قد تكون مفتوحة وحادة لكنها مهنية تماماً، ولا يأخذها أحد على محمل شخصي. والثانية «يثبت على موقفه» Stands their ground، أي أن يقول لا عندما يجب، بناء على مبادئ سليمة. أي أن المهندس الجيد يجمع الاثنين معاً.
ماذا وجدت الأبحاث بعد ذلك؟ Mantei 1981
قبل أن نكمل، من الأمانة أن نذكر أن البرمجة بلا أنا ليست نتيجة بحث تجريبي، وإنما فكرة من خبرة Weinberg وملاحظاته. وأشهر دراسة قارنت بينها وبين طريقة أخرى هي دراسة Marilyn Mantei المنشورة في مجلة Communications of the ACM سنة 1981 بعنوان «The Effect of Programming Team Structures on Programming Tasks».
وقارنت Mantei بين الفريق بلا أنا، وهو فريق بلا تسلسل واضح يتشارك فيه الجميع القرار والمراجعة، وبين فريق المبرمج الرئيسي Chief Programmer Team الذي يقوده مبرمج واحد يتخذ القرارات. وبحسب ما يلخصه ملخص الموضوع في Wikipedia، رأت أن الفريق بلا أنا يناسب المهام المعقدة، وأن التواصل المفتوح يجعل المعلومة تنتقل بحرية، ويرفع رضا أعضاء الفريق. ورأت في المقابل أن المشاريع تأخذ وقتاً أطول، وأن كثرة التواصل غير المركزي قد ترفع احتمال الفشل.
ونفس الملخص ينبه إلى أن الدراسة اعتمدت في معظمها على تجارب مخبرية على طلاب ومهام قصيرة، أي أنها لا تثبت شيئاً قاطعاً عن الفرق الحقيقية. والخلاصة العملية لك أن هذه الدراسة تتكلم عن بنية الفريق كله، أما الجزء الذي بقي من الفكرة في الصناعة حتى اليوم فهو الجزء الأبسط: أن يقرأ كل كود شخص غير كاتبه، وأن يعامل الخطأ كمعلومة لا كفضيحة.
الوصايا العشر Ten Commandments of Egoless Programming
إذا بحثت عن البرمجة بلا أنا ستجد قائمة مشهورة من عشر نقاط، تنسب غالباً إلى كتاب Weinberg مباشرة، كما في تدوينة Jeff Atwood على مدونة Coding Horror سنة 2006. لكن القائمة بهذا الشكل ليست من نص الكتاب، وإنما كتبها Lamont Adams في مقال على موقع TechRepublic بعد الكتاب بأكثر من ثلاثين سنة، كما يذكر Ted Neward في مقاله في CODE Magazine سنة 2011. فهي تلخيص لروح الفكرة، لا اقتباس من Weinberg.
وهي مع ذلك تلخيص جيد، ولذلك نعرضها هنا مع ما تعنيه كل نقطة في عملك اليومي:
| الوصية | ما تعنيه في العمل |
|---|---|
| 1. افهم وتقبل أنك ستخطئ | الهدف أن تكتشف الخطأ قبل الإنتاج، لا ألا تخطئ أبداً |
| 2. أنت لست الكود الذي تكتبه | تعليق على دالة Function ليس حكماً عليك |
| 3. مهما عرفت، سيعرف غيرك أكثر | اسأل المبتدئ أيضاً، فقد يرى ما لم تره |
| 4. لا تعد كتابة كود غيرك دون أن تستشيره | التحسين دون كلام يقرأ كاحتقار، ويضيع سياقاً لا تعرفه |
| 5. عامل من يعرف أقل منك باحترام وصبر | وهذا موضوع مقال احترام من لا يعرف في نفس المرحلة |
| 6. الشيء الوحيد الثابت هو التغير | الكود الذي تحبه سيتغير، فلا تتعلق بشكله الحالي |
| 7. السلطة الحقيقية من المعرفة لا من المنصب | الحجة تحسم الخلاف، لا المسمى الوظيفي |
| 8. دافع عما تؤمن به، وتقبل الخسارة بلطف | قل رأيك بوضوح، وإذا قرر الفريق غيره فنفذه دون مقاومة خفية |
| 9. لا تكن الشخص المنعزل في غرفته | لا تعمل أسابيع دون أن يرى أحد عملك |
| 10. انتقد الكود لا الشخص | كن لطيفاً مع الكاتب، وصريحاً مع الكود |
ولاحظ أن الوصية التاسعة، في أصلها الإنجليزي «لا تكن الرجل في الغرفة» Don't be the guy in the room، تصف المبرمج الذي يختفي ويكتب وحده ثم يظهر بكود ضخم لا يستطيع أحد مراجعته. وهذا السلوك هو أوضح علامة على الأنا، لأن صاحبه يتجنب أن يرى أحد عمله قبل أن يصبح «كاملاً»، فيصل الخطأ متأخراً ويصبح إصلاحه مكلفاً.

ككاتب الكود: كيف تفصل نفسك عنه؟ The Author
أغلب العمل في البرمجة بلا أنا يقع على كاتب الكود، لأنه هو من يشعر بالتعليق شخصياً. وفيما يلي خطوات عملية قبل المراجعة وأثناءها.
قبل أن تطلب المراجعة Before the Review
- اطلب المراجعة مبكراً: لا تنتظر أن يصبح الكود «كاملاً». فطلب دمج صغير في يومه الأول أسهل في مراجعته، وأسهل عليك في تقبل تغييره، لأنك لم تستثمر فيه أسبوعاً بعد. وإذا كانت الفكرة نفسها غير مؤكدة، فاطلب رأياً في مسودة Draft قبل أن تكتب الكود كله.
- راجع كودك أولاً: اقرأ الفروقات Diff كما سيقرؤها المراجع، فستجد نصف الأخطاء الواضحة وحدك. وهذا ليس لتحمي صورتك، وإنما لتوفر وقت المراجع لما لا تستطيع أن تراه أنت.
- اكتب ما لست متأكداً منه: في وصف الطلب، قل «لست متأكداً من طريقة التعامل مع المهلة Timeout هنا، وأريد رأيك فيها». وبهذا الشكل تحول المراجعة من بحث عن أخطائك إلى تعاون على سؤال حقيقي.
- افصل التغييرات: تغيير التنسيق Formatting في طلب، والمنطق في طلب آخر. فالطلب الذي يخلط الاثنين يجعل المراجع يعلق على كل شيء، ويجعلك تشعر أن الكود كله مرفوض.
عندما تصل التعليقات During the Review
يضع دليل التعامل مع تعليقات المراجعة في Google قواعد واضحة لكاتب الكود. فهو يطلب منك أولاً ألا تأخذ التعليق على محمل شخصي، وأن تراه محاولة من المراجع لمساعدتك ومساعدة قاعدة الكود Codebase. ويقول بوضوح: لا ترد أبداً على تعليقات المراجعة وأنت غاضب، وإذا كنت منزعجاً لدرجة أنك لا تستطيع أن ترد بلطف، فابتعد قليلاً وعد عندما تهدأ.
ومن أذكى ما في الدليل قاعدة «أصلح الكود» Fix the Code: إذا لم يفهم المراجع جزءاً من كودك، فأول رد عليك هو أن تجعل الكود نفسه أوضح، لا أن تشرحه في التعليق. والسبب أن المراجع هو أول قارئ للكود، وكل من سيقرؤه بعد سنة سيقع في نفس الحيرة ولن يجد تعليقك في أداة المراجعة.
ويطلب الدليل أيضاً أن تفكر بطريقة تعاونية لا دفاعية، وأن تتأكد أنك فهمت ما يطلبه المراجع قبل أن ترد على تعليق لا توافق عليه، وأن تسأل إذا لم تفهم. وإذا بقي الخلاف، فالخطوة الأولى دائماً أن تحاول الوصول إلى اتفاق مع المراجع نفسه قبل أن ترفع الأمر لغيره.
ردود قبل وبعد Author Replies
الجدول التالي يجمع ردوداً يكتبها الكاتب الذي يشعر بالتعليق شخصياً، وبجانب كل منها رد يقول نفس الموقف دون دفاع:
| التعليق | رد دفاعي | رد بلا أنا |
|---|---|---|
| «هذه الدالة طويلة وصعبة القراءة» | «هي تعمل، وكل الاختبارات ناجحة» | «صحيح، سأقسمها إلى دالتين، هل التقسيم عند التحقق مناسب؟» |
| «لماذا لم تستخدم المكتبة الموجودة؟» | «لأني أعرف ما أفعله» | «لم أكن أعرف أنها موجودة، سأجربها»، أو «جربتها وكانت بطيئة في حالتنا، وهذه الأرقام» |
| «هذا الشرط لا يغطي القائمة الفارغة» | «هذه حالة لن تحدث» | «شكراً، أضفت الحالة واختباراً لها» |
| «Nit: اسم المتغير غير واضح» | تجاهل التعليق | «غيرته»، أو «أفضل الاسم الحالي لأنه نفس اسم الحقل في قاعدة البيانات» |
| تعليق تراه خاطئاً | «أنت لم تفهم الكود» | «أظن أن الحالة التي ذكرتها لا تحدث لأن الطلب يمر بالتحقق قبل ذلك، هل فاتني شيء؟» |
| تعليق بنبرة حادة | رد بنبرة أحد | رد على المضمون فقط، ثم حديث خاص عن النبرة إذا تكررت |
لاحظ أن الرد بلا أنا لا يعني دائماً الموافقة. ففي الصف الثاني والرابع والخامس يحتفظ الكاتب برأيه، لكنه يعرضه كمعلومة يمكن أن يفحصها المراجع، لا كدفاع عن نفسه.
كمراجع: كيف تعلق على الكود لا على الشخص؟ The Reviewer
المراجع هو من يحدد هل يشعر الكاتب بالأمان أم بالهجوم. ويضع دليل كتابة تعليقات المراجعة في Google قواعد بسيطة لذلك، وفيما يلي أهمها مع ما تعنيه:
- كن مهذباً ومحترماً Courtesy: وعلق على الكود دائماً، ولا تعلق على الكاتب أبداً. ومثال الدليل نفسه: بدل «لماذا استخدمت الـ Threads هنا مع أنه لا فائدة واضحة من التوازي؟» اكتب «لأنه لا فائدة في الأداء هنا، الأفضل أن يعمل هذا الكود في Thread واحد».
- اشرح السبب Explain Why: التعليق الذي يذكر سببه يعلم الكاتب ويجعله قادراً على أن يحكم في المرة القادمة وحده، أما الأمر بلا سبب فيبدو كفرض للذوق الشخصي.
- وازن بين الإشارة والحل Giving Guidance: بحسب الدليل، إصلاح الكود مسؤولية الكاتب لا المراجع. فلا تكتب الحل كاملاً في كل مرة، ولا تكتفي بالإشارة إلى المشكلة إذا كان الكاتب مبتدئاً لا يعرف الحل.
- حدد وزن التعليق Label Severity: فرق بين ما يجب تغييره وما هو اقتراح. ويقترح الدليل كلمات مثل Nit لملاحظة صغيرة، وOptional للاختياري، وFYI لمعلومة لا يطلب تنفيذها في هذا الطلب. وهذا وحده يغير شعور الكاتب كثيراً، لأن عشرين تعليقاً بلا وزن تبدو رفضاً كاملاً.
- اذكر ما هو جيد Praise: يقول الدليل إن الناس يتعلمون من تأكيد ما يفعلونه جيداً، لا مما يحتاجون تحسينه فقط. وتعليق مثل «طريقة الاختبار هنا ممتازة» ليس مجاملة إذا كان صحيحاً.
ويضيف دليل معيار مراجعة الكود قاعدة تحسم كثيراً من خلافات الأنا: الحقائق التقنية والبيانات تتقدم على الآراء والتفضيلات الشخصية. فإذا كان الخلاف على أمر من الذوق لا يغطيه دليل الأسلوب Style Guide، فهو تفضيل شخصي، ويجب أن يقبل المراجع أسلوب الكاتب.
تعليقات قبل وبعد Reviewer Comments
| تعليق يهاجم الشخص | تعليق عن الكود |
|---|---|
| «أنت لا تعرف كيف تتعامل مع الأخطاء» | «إذا فشل الاتصال هنا يضيع الخطأ دون تسجيل، ممكن نسجله في Logs ونعيد المحاولة؟» |
| «من كتب هذا؟» | «هذا الجزء صعب الفهم بالنسبة لي، هل يمكن تقسيمه أو إضافة تعليق عن الهدف منه؟» |
| «هذا كود مبتدئ» | «هذه الحلقة تقرأ قاعدة البيانات في كل دورة، والأسرع أن نقرأ مرة واحدة قبلها» |
| «لماذا تفعل هذا دائماً؟» | «نفس الملاحظة في ثلاثة أماكن، ربما نضيفها إلى قائمة الفحص الآلي Linter» |
| «خطأ» | «هذا الشرط يعكس النتيجة عندما تكون القيمة صفراً، وهذا مثال يفشل» |
| «غير هذا» | «Optional: أفضل اسماً أوضح مثل retryCount، والقرار لك» |
والقاعدة التي تجمع الجدول: إذا كان في تعليقك كلمة «أنت» تسبق فعلاً سلبياً، فأعد كتابته عن الكود. وإذا لم تستطع أن تشرح لماذا تطلب التغيير، فربما هو ذوقك الشخصي، وعندها اكتبه كاقتراح أو احذفه.

الأنا خارج مراجعة الكود Beyond Code Review
مراجعة الكود أوضح مكان تظهر فيه الأنا، لكنها ليست المكان الوحيد. وفيما يلي أماكن أخرى تظهر فيها نفس المشكلة بشكل أخفى.
التصميم الذي اقترحته أنت Design Ownership
عندما تقترح تصميماً لنظام وتعمل عليه أسابيع، يصبح من الصعب أن تعترف بأنه لم يعد مناسباً. فتبدأ بالدفاع عنه بحجج تضعف كل مرة، لأن التراجع عنه يشعرك أنك أضعت وقت الفريق. وهذا قريب مما يسمى انحياز التكلفة الغارقة Sunk Cost، أي أن تستمر في طريق لأنك دفعت فيه كثيراً، لا لأنه الأفضل.
والحل أن تكتب في وثيقة التصميم Design Doc من البداية ما الذي سيجعلك تغير رأيك: «إذا تجاوز عدد الطلبات كذا في الثانية، فهذا التصميم لن يكفي، وسنحتاج طابوراً Queue». وبهذا الشكل يصبح التغيير نتيجة متوقعة لا هزيمة. وقد شرحنا كتابة هذه الوثائق في مقال ثقافة الكتابة في الفريق.
العطل الذي سببه كودك Incidents
عندما يتعطل النظام في الإنتاج ويكون السبب تغييراً كتبته أنت، فإن رد الفعل الطبيعي أن تخفي ذلك أو تصغره أو تبحث عن سبب آخر. ونقلت دراسة Microsoft عن أحد المهندسين أن من يحاول أن يخفي خطأه أو يصغره يراه الجميع، وأن ذلك يضعف أثره في الفريق. ونقلت عن آخر وصفاً لمهندسين ينشغلون بالسؤال «كيف أتأكد أن أحداً لن يظن أن هذا بسببي؟» بدل أن ينشغلوا بإصلاح المشكلة.
والمهندس بلا أنا يقول في أول دقيقة: «التغيير الذي دمجته أمس هو الأرجح، سأرجعه Rollback الآن». وهذا يحتاج فريقاً لا يعاقب على الخطأ، وهو ما يشرحه مقال مراجعة الحادثة دون لوم Blameless Postmortem.
«الجزء الخاص بي» Territoriality
من أشكال الأنا أن يرى المهندس جزءاً من النظام ملكاً شخصياً، فلا يحب أن يعدل فيه أحد، ويرفض التغييرات من خارج الفريق، ويصبح الشخص الوحيد الذي يفهمه. وهذا يبدو في البداية حرصاً على الجودة، لكنه في الحقيقة يجعل الفريق يعتمد على شخص واحد، وهي نفس المشكلة التي ذكرها Weinberg عندما تكلم عن فائدة أن يعرف البرنامج أكثر من شخص.
والحل ليس أن تتخلى عن مسؤوليتك عن الجزء، وإنما أن تجعل غيرك يستطيع أن يعمل فيه: وثيقة تشرحه، ومراجعة لكل تغيير من غيرك بنفس الترحيب، وزميل ثان يعرفه جيداً.
المهندس البطل Hero Engineer
وأخيراً المهندس الذي يحب أن يكون المنقذ: يحل الأعطال وحده في الليل، ويكتب الحل الكبير وحده، ويستمتع بأن الجميع يحتاجه. وهذا السلوك يبدو عكس الأنا لأنه تضحية، لكنه في الحقيقة يضع الشخص في مركز كل شيء. والفريق الذي يعتمد على بطل واحد يتوقف عندما يمرض البطل أو يغادر.
أربعة مواقف شائعة Common Situations
المواقف التالية افتراضية، لكنها تتكرر بأشكال قريبة في أغلب الفرق.
الموقف الأول: رفض الفريق تصميمك Design Rejected
اقترحت تصميماً لخدمة جديدة، وناقشه الفريق، واختار تصميماً آخر اقترحه زميل. وأنت ما زلت ترى تصميمك أفضل.
ما لا ينجح: أن تنفذ التصميم الآخر ببطء وبلا اهتمام، أو أن تنتظر أن يفشل لتقول «قلت لكم». فهذا يجعل فشله أكثر احتمالاً، ويجعلك أنت جزءاً من السبب.
ما ينجح: أن تكتب اعتراضك مرة واحدة بوضوح في وثيقة القرار، مع الشرط الذي سيجعل الفريق يعيد النظر، ثم تنفذ القرار بكامل جهدك. وهذه هي الوصية الثامنة: دافع عما تؤمن به، وتقبل الخسارة بلطف. وتفاصيل الخلاف التقني موجودة في مقال الخلاف في العمل Conflict.
الموقف الثاني: مبتدئ يجد خطأ في كودك Junior Finds Your Bug
أنت مهندس أول، ومهندس مبتدئ في شهره الثالث يراجع كودك ويكتب: «أظن أن هنا خطأ عندما تكون القائمة فارغة». وهو محق.
ما لا ينجح: أن تصلح الخطأ بصمت دون رد، أو أن تقول «كنت سأنتبه له». فالمبتدئ سيفهم أن مراجعة كودك مخاطرة، ولن يكتب مثل هذا التعليق مرة أخرى.
ما ينجح: أن ترد علناً في الطلب: «ملاحظة ممتازة، فاتتني، وأضفت اختباراً لها». هذه الجملة القصيرة تعلم الفريق كله أن المراجعة تعمل في كل الاتجاهات، وهي أقوى من أي محاضرة عن الأمان النفسي.
الموقف الثالث: تجد خطأ في كود مهندس أول Reviewing a Senior
أنت المبتدئ هذه المرة، وتجد في كود قائد الفريق Tech Lead شيئاً تظنه خطأ، لكنك لست متأكداً، وتخاف أن تبدو ضعيفاً.
ما لا ينجح: ألا تكتب شيئاً، لأن الخطأ قد يكون حقيقياً. أو أن تكتب بثقة زائدة «هذا خطأ» فتحرج نفسك إذا كنت مخطئاً.
ما ينجح: أن تكتب سؤالاً يعرض ما رأيته: «لم أفهم ماذا يحدث هنا إذا كانت القائمة فارغة، هل هذه الحالة مغطاة في مكان آخر؟». فإذا كان خطأ، فقد وجدته. وإذا لم يكن، فقد تعلمت شيئاً. وفي الحالتين لم تخسر شيئاً.
الموقف الرابع: مراجع حاد دائماً Harsh Reviewer
زميل في الفريق يكتب تعليقات صحيحة تقنياً، لكنها حادة دائماً: «هذا سيئ»، «لماذا هذا؟». والفريق بدأ يتجنب أن يرسل له كوده.
ما لا ينجح: أن تتجنبه أنت أيضاً، أو أن ترد بنفس النبرة في التعليقات، فيتحول الطلب إلى معركة علنية.
ما ينجح: أن ترد على المضمون فقط في الطلب، ثم تتحدث معه بشكل خاص عن النبرة بأمثلة محددة. وإذا كنت قائد الفريق، فاكتب قواعد مكتوبة للمراجعة تشمل النبرة ووزن التعليقات. وإذا استمر السلوك فقد يكون أقرب إلى ما يشرحه مقال زميل صعب أو عدائي.
كيف يبني الفريق ثقافة بلا أنا؟ Team Practices
البرمجة بلا أنا ليست قراراً فردياً فقط، لأن الفرد لا يستطيع أن يفصل نفسه عن الكود في فريق يعاقب على كل خطأ. وفيما يلي ممارسات تجعل الفكرة جزءاً من طريقة عمل الفريق:
- مراجعة للجميع بلا استثناء: كود قائد الفريق يراجع مثل كود المبتدئ. وإذا كان هناك شخص لا يراجع كوده أحد، فالرسالة للفريق أن المراجعة عقوبة للأقل خبرة.
- تدوير المراجعين Reviewer Rotation: لا يراجع نفس الشخص كل شيء، حتى ينتشر فهم الكود ولا يصبح شخص واحد حارساً عليه.
- قواعد مكتوبة للمراجعة: ما الذي يجب أن يغير وما هو اقتراح، وكيف تكتب التعليق، وكم وقت تأخذ المراجعة. وقد ذكرنا أمثلة في مقال مراجعة الكود.
- البرمجة الثنائية Pair Programming: عندما يكتب اثنان الكود معاً، يصبح من الصعب أن يرى أحدهما الكود ملكاً شخصياً له.
- الآلة للأشياء الصغيرة: التنسيق والأسلوب تتركه لأدوات الفحص الآلي Linters، حتى لا يقضي المراجعون وقتهم في ملاحظات صغيرة يشعر بها الكاتب كأنها ملاحقة.
- الاحتفال بالخطأ الذي اكتشف مبكراً: عندما تمنع مراجعة خطأ خطيراً، اذكر ذلك في اجتماع الفريق كنجاح للفريق، دون أن تذكر من كتب الخطأ.
ومع انتشار الكود الذي تكتبه أدوات الذكاء الاصطناعي، أصبحت المراجعة تواجه مشكلة جديدة هي حجم الكود، لا الأنا. وهذا موضوع مقال مراجعة كود الذكاء الاصطناعي.
كيف تعرف أن الأنا هي التي ترد؟ Self-check
الأنا لا تعلن عن نفسها، وإنما تظهر في ردود تبدو لصاحبها منطقية تماماً. ولذلك جرب أن تراقب نفسك في المراجعات القادمة، وابحث عن هذه العلامات:
- تشعر بحرارة في وجهك أو ضيق في صدرك عندما ترى إشعار تعليق جديد على طلبك، قبل أن تقرأه.
- تبدأ ردك بكلمة «لكن» أو «في الحقيقة» قبل أن تفهم التعليق كاملاً.
- تبحث عن خطأ في كود المراجع بعد أن علق على كودك.
- تتذكر اسم من رفض تصميمك أكثر مما تتذكر سبب الرفض.
- ترسل طلباتك إلى المراجع الأسهل لا إلى من يعرف الجزء أكثر.
- تؤجل دمج طلب فيه تعليق لم ترد عليه، لأنك لا تريد أن تعترف بأنه صحيح.
وإذا وجدت نفسك في واحدة منها، فلا تقلق، فهذه ردود بشرية طبيعية، وWeinberg نفسه بنى الفكرة على أن هذا الشعور موجود عند كل مبرمج. والمطلوب ليس أن يختفي الشعور، وإنما ألا يكتب هو الرد. وأبسط طريقة لذلك قاعدة الانتظار: إذا شعرت بالضيق من تعليق، فلا ترد عليه قبل أن تقرأه مرة ثانية بعد ساعة، وتسأل نفسك سؤالاً واحداً: لو كتب هذا التعليق على كود زميل آخر، هل كنت سأراه صحيحاً؟
وجرب أيضاً أن تعكس الوضع مرة في الأسبوع: اطلب من زميل أن يراجع كودك بعين قاسية، وأخبره أنك تريد أكبر عدد من الملاحظات. وعندما يصبح البحث عن أخطائك شيئاً تطلبه أنت، يتغير شعورك تجاه المراجعة كلها، لأنها تصبح أداة في يدك لا حكماً عليك.
أخطاء شائعة Common Mistakes
| الخطأ | لماذا يضر | ماذا تفعل بدله |
|---|---|---|
| تطلب المراجعة بعد أن يكتمل كل شيء | التغيير يصبح مكلفاً، وتصبح أكثر دفاعاً | اطلب الرأي في المسودة وفي الطلبات الصغيرة |
| ترد على التعليق فوراً وأنت منزعج | يتحول النقاش التقني إلى خلاف شخصي | ابتعد قليلاً، ثم رد على المضمون |
| تشرح الكود في التعليق بدل أن توضحه | القارئ التالي لن يجد شرحك | أصلح الكود نفسه حتى يصبح واضحاً |
| تعلق على الكاتب لا على الكود | يشعر بالهجوم ويتوقف عن الاستماع | احذف «أنت»، وتكلم عن الدالة والحالة |
| كل التعليقات بنفس الوزن | الطلب يبدو مرفوضاً بالكامل | Nit وOptional وFYI لما ليس ضرورياً |
| تفرض ذوقك الشخصي | الكاتب يرى المراجعة تحكماً لا تحسيناً | الحقائق والبيانات قبل التفضيلات |
| تصلح خطأ وجده مبتدئ دون أن تشكره | يتعلم ألا يراجع كود من هو أعلى منه | اشكره علناً في الطلب |
| تنفذ قراراً لم توافق عليه ببطء | تساهم في فشل القرار | اعترض مرة بوضوح، ثم نفذ بكامل جهدك |
| كقائد: لا يراجع أحد كودك | المراجعة تصبح عقوبة للأقل خبرة | اطلب المراجعة من المبتدئين أيضاً |
قائمة تحقق Checklist
| السؤال | إذا كانت الإجابة لا |
|---|---|
| هل طلبت المراجعة قبل أن يكبر الطلب؟ | قسمه، أو اطلب رأياً في المسودة |
| هل كتبت في الوصف ما لست متأكداً منه؟ | أضف سطراً بسؤالك الحقيقي |
| هل قرأت التعليق مرتين قبل أن أرد عليه؟ | اقرأه وافترض أن كاتبه يريد المساعدة |
| هل خلت تعليقاتي من «أنت» قبل الأفعال السلبية؟ | أعد كتابتها عن الكود |
| هل لكل تعليق سبب مكتوب؟ | اكتب السبب، أو حول التعليق إلى اقتراح |
| هل حددت وزن التعليقات الصغيرة؟ | أضف Nit أو Optional |
| هل ذكرت شيئاً جيداً في الطلب؟ | اذكره إذا كان موجوداً فعلاً |
| هل يراجع كودي أشخاص أقل خبرة مني؟ | اطلب ذلك صراحة |
| هل يعرف جزئي من النظام شخص غيري؟ | وثقه، وعلمه لزميل |
وهذا المقال جزء من مرحلة القيم والاحترام في العمل التقني. والمقالات التالية تكمله: احترام من لا يعرف، ومواثيق المهندسين، وأخلاقيات المهنة في ميثاق ACM وIEEE، وكيف تكون زميلاً يريد الجميع العمل معه.
دليلاحترام من لا يعرف: لماذا يخسر المهندس المتعالي فريقهكيف ترد على السؤال البسيط دون أن تحرج صاحبه، ولماذا يكتشف الفريق الذي يسكت أعضاؤه أخطاءه متأخراً.
دليلمواثيق المهندسين Manifestos: من Agile إلى الحرفيةماذا تقول البيانات التي كتبها المهندسون عن مهنتهم بنصها، وما الذي لا تقوله، وكيف يحولها فريقك إلى اتفاق عمل يراجعه كل شهر.
دليلأخلاقيات المهنة Code of Ethics: ميثاق ACM وIEEEماذا يقول ميثاق ACM لسنة 2018 وميثاق هندسة البرمجيات لسنة 1999، وكيف تستخدمهما عندما يطلب منك في العمل شيء يضر المستخدم.
دليلكيف تكون زميلاً يريد الجميع العمل معهثماني عادات يومية تجعل زملاءك يثقون بك ويطلبونك في مشاريعهم، من الوعد الصغير إلى التسليم ونسبة الفضل لأهله.
دليلمراجعة الكود Code Review: كيف تراجع Pull Request بفائدةكيف تفتح طلب دمج يسهل على زميلك مراجعته، وكيف تراجع طلب غيرك بتعليقات تحسن الكود دون أن تتحول إلى موافقة شكلية أو جدال، مع حماية الفرع main في Gitea.
دليلكيف تعطي الملاحظات الصعبة Feedback وتتلقاهاطريقة بسيطة لتقول الملاحظة الصعبة بوضوح واهتمام، وخطوات لتلقيها دون أن تدافع، مع عبارات جاهزة.
دليلمراجعة كود الذكاء الاصطناعي دون أن تصبح شكليةكيف تراجع طلبات الدمج التي يكتبها الذكاء الاصطناعي بحسب خطرها، وتترك للبوابات الآلية ما تستطيع قياسه.
دليلالخلاف في العمل Conflict: كيف تختلف دون أن تخسر زميلككيف تبقي الخلاف على الفكرة لا على الشخص، وتنقله بست خطوات من الآراء إلى قرار مكتوب يلتزم به الجميع.
دليلكيف تدير مراجعة الحادثة دون لوم Blameless Postmortemدليل خطوة بخطوة لمن يدير مراجعة ما بعد الحادثة: الخط الزمني والعوامل المساهمة ولغة دون لوم وإجراءات لها مالك، مع قالب جاهز.الخلاصة
- البرمجة بلا أنا فكرة Gerald Weinberg في كتاب «The Psychology of Computer Programming» سنة 1971: من يرى برنامجه امتداداً لذاته لا يبحث عن أخطائه.
- الحل الذي اقترحه أن يقرأ كل كود شخص غير كاتبه، وهذا أصل مراجعة الكود اليوم.
- الفكرة لا تعني أن تتخلى عن رأيك أو مسؤوليتك، وإنما ألا تدافع عن نفسك بدل الدفاع عن الفكرة.
- الوصايا العشر المشهورة كتبها Lamont Adams تلخيصاً للفكرة، وليست نصاً من الكتاب.
- ككاتب: اطلب المراجعة مبكراً، واكتب ما لست متأكداً منه، ولا ترد وأنت غاضب، وأصلح الكود بدل شرحه.
- كمراجع: علق على الكود لا على الشخص، واشرح السبب، وحدد وزن التعليق، واذكر ما هو جيد.
- الأنا تظهر أيضاً في التصميم والأعطال و«الجزء الخاص بي»، والفريق هو من يجعل الاعتراف بالخطأ آمناً.
سجل التحديثات
- 2026-11-19: كتابة المقال، والتحقق من فهرس كتاب Weinberg على Leanpub، واقتباسات الصفحتين 55 و59 في مراجعة Bruce F. Webster سنة 2012، ودليل مراجعة الكود في Google، ودراسة Li وKo وZhu في ICSE 2015، وملخص دراسة Mantei 1981، ونسبة الوصايا العشر إلى Lamont Adams في مقال Ted Neward سنة 2011، بتاريخ 19 نوفمبر 2026.