AI CodeOps

كيف تراجع كودا كتبه وكيل ذكاء اصطناعي

آخر تحديث

نهج عملي لمراجعة طلبات السحب التي يولدها الذكاء الاصطناعي: ما الذي تقرؤه أولا، والأخطاء التي يقع فيها وكلاء البرمجة عادة، وكيف تتجنب الموافقة الشكلية.

مراجعة كود كتبه وكيل ذكاء اصطناعي تعني فحص ثلاثة أمور قبل الكود نفسه: أن التغيير يفعل ما طلب ولا شيء أكثر، وأن الأدلة عليه حقيقية، وأن الاختبارات لم تلو لتناسبه. والكود الذي يكتبه الوكلاء عادة جيد التنسيق ويقرأ بثقة، فتميل المشكلات إلى الوجود في الافتراضات والنطاق والتحقق أكثر من الأخطاء الواضحة. والمراجعة الجيدة تقرأ المهمة ونتائج الاختبارات وفروقات الاختبارات أولا، ثم تركز على أجزاء التغيير التي يكون الخطأ فيها مكلفا.

وتتوسع هذه الصفحة في القسم الخاص بمراجعة الكود الذي يكتبه الذكاء الاصطناعي في ما مراجعة الكود بالذكاء الاصطناعي؟.

ما المختلف في التغييرات التي يكتبها الوكلاء

تخفق التغييرات البشرية وتغييرات الذكاء الاصطناعي بطرق مختلفة، والمراجع المعتاد على إحداهما قد تفوته الأخرى.

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

ابدأ من المهمة، لا من الفروقات

اقرأ المهمة التي أعطيت للوكيل قبل فتح أي ملف. ثم اسأل:

  1. هل يفعل التغيير ما طلبته المهمة؟
  2. هل يفعل شيئا لم تطلبه المهمة؟
  3. هل فسر الوكيل مهمة مبهمة بطريقة ما كنت لتفسرها بها؟

الوكيل الذي أساء فهم المهمة قد ينتج تنفيذا صحيح المظهر للشيء الخطأ. وهذا أسهل رؤية حين تبقي الطلب في ذهنك منه حين تقرأ الكود أولا وتستنتج المقصد منه.

وكل ما يقع خارج نطاق المهمة يستحق نظرة أدق أو تغييرا منفصلا. والتعديلات غير المطلوبة على الإعدادات أو تعريفات CI أو ملفات تعريف التبعيات أو كود المصادقة هي التي يجب التوقف عندها.

اقرأ الأدلة قبل الكود

قبل قراءة التنفيذ، تحقق مما جرى التحقق منه.

  • هل عملت الاختبارات على هذا الإصدار بالذات؟ تشغيل اختبار سابق لآخر تعديل لا يقول شيئا عن الكود الحالي.
  • أي الاختبارات عملت، وهل تخطي أي منها؟ النتيجة الخضراء من مجموعة تخطت الاختبارات ذات الصلة ليست نجاحا.
  • ماذا وجدت المراجعة المؤتمتة، وكيف فرزت ملاحظاتها؟ الملاحظات المفتوحة عالية الخطورة، أو الملاحظات المرفوضة دون سبب، تخبرك أين تنظر.
  • هل بقي شيء دون تحقق إطلاقا؟ عبارة «لم تعمل أي اختبارات» يجب أن تكون ظاهرة، لا مختبئة خلف حالة محايدة.

إذا غابت الأدلة، تصبح المراجعة أصعب، ويجب أن يعرف من يوافق ذلك قبل أن يقرر.

اقرأ فروقات الاختبارات قبل فروقات الكود

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

  • اختبارات محذوفة، أو معلقة بالتعليق، أو موسومة بالتخطي؛
  • تأكيدات مرخاة، مثل استبدال مقارنة دقيقة بفحص لوجود قيمة؛
  • قيم متوقعة غيرت لتطابق أي شيء يعيده الكود الجديد؛
  • محاكاة واسعة إلى حد أن الكود المختبر لا يعمل فعلا؛
  • اختبارات جديدة تنفذ الكود دون أن تتحقق من أي شيء في النتيجة.

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

أخطاء يقع فيها وكلاء البرمجة عادة

تظهر هذه الأنماط بما يكفي لتبحث عنها عن قصد.

النمطما تبحث عنه
واجهات API أو حزم مختلقةاستدعاءات لدوال أو خيارات أو حزم غير موجودة في الإصدار الذي تستخدمه
أخطاء مبتلعةكتل catch واسعة، أو أخطاء تسجل ثم تتجاهل، أو إخفاقات تتحول إلى نتائج فارغة
بدائل صامتةقيم افتراضية تخفي فشلا، مثل إعادة صفر أو قائمة فارغة حين يفشل بحث
تفويض ناقصنقاط نهاية أو إجراءات جديدة بلا فحص الصلاحيات الموجود في الكود المشابه
أنماط قديمةاستدعاءات مكتبات مهملة، أو تشفير قديم، أو إعدادات افتراضية غير آمنة متعلمة من كود أقدم
دوال مساعدة مكررةأداة مساعدة جديدة تكرر أداة موجودة أصلا في قاعدة الكود
تبعيات جديدةحزمة أضيفت لشيء تفعله المكتبة القياسية أو تبعية موجودة أصلا
تقلب لا علاقة له بالمهمةإعادة تنسيق أو تسمية أو هيكلة خارج المهمة، ممزوجة بالتغيير الحقيقي

والأخطاء المبتلعة والبدائل الصامتة تستحق انتباها خاصا. فهي تجعل الاختبارات تنجح والعروض التوضيحية تعمل، بينما تحول فشلا ظاهرا إلى بيانات خاطئة، وهذا أعلى كلفة بكثير عند اكتشافه لاحقا.

إبقاء التغييرات الكبيرة قابلة للمراجعة

حين يكون التغيير أكبر من أن يراجع كما ينبغي، فالخيارات أفضل من الموافقة عليه دون قراءة.

  • قسّم المهمة. إعادة عمل الوكيل رخيصة. اطلب التغيير في قطع أصغر، لكل منها حدود واضحة.
  • اقرأ حسب الخطورة. اقرأ الملفات التي تتعامل مع المال والمصادقة والبيانات الشخصية والصلاحيات والتخزين سطرا سطرا. وتصفح الملفات المولدة أو الآلية بسرعة.
  • احم المسارات الحساسة. القاعدة التي تشترط مراجعة إضافية للتغييرات تحت infra/ أو تعريفات CI تعني أن تلك الملفات لا تتسلل أبدا داخل تغيير كبير.
  • ارفض بدل أن ترمم. إذا كان النهج خاطئا، فالرفض مع سبب واضح ومهمة أفضل كثيرا ما يكون أسرع من تعديل كود الوكيل يدويا.

الموافقة بمسؤولية

يجب أن تعني الموافقة أن شخصا نظر في التغيير والأدلة ويقبل المسؤولية عن إطلاقه. وثلاث عادات تبقيها ذات معنى:

  • افصل بين الكاتب ومن يوافق. الشخص الذي كتب المهمة يجب ألا يكون الوحيد الذي يوافق على النتيجة حين يستطيع شخص آخر ذلك.
  • أعد الموافقة بعد التعديلات. إذا عدّل التغيير بعد الموافقة، فالموافقة السابقة لم تعد تنطبق على ما سيطلق.
  • اكتب سببا حين ترفض. فهو يساعد المحاولة التالية، سواء قام بها شخص أو وكيل.

كيف يدعم AI CodeOps المراجعة

في AI CodeOps، كل تغيير في الكود من جلسة يفتح طلب مراجعة. وفي صفحة الجلسة، يرى من يوافق التغييرات المقترحة، والملاحظات، ولوحة Quality gates مع نتائج الاختبارات، وهي تبين أيضا متى لم يتحقق من تغيير لأن الاختبارات تعذر تشغيلها. والفروقات التي تتجاوز 60 KB ترفض بالرسالة "Split the task into smaller changes"، فلا تسلم إلى المراجعين تغييرات أكبر من أن تقرأ.

ولا يستطيع من بدأ الجلسة الإدلاء بصوت الموافقة ما دام في مساحة العمل شخص آخر يستطيع الموافقة. والرفض يحتاج إلى سبب وينهي الطلب. وتعديل التغيير بعد الموافقة يعيده إلى الموافقة من جديد، ولا تحتسب نتيجة الاختبار إلا للإصدار الذي عملت عليه. وتستطيع سياسات مساحة العمل أن تشترط موافقة على التغييرات في مسارات مثل infra/**، أو أن ترفضها. وتستطيع جلسة متابعة أن تبني على تغيير بدل البدء من جديد.

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

الأسئلة الشائعة

هل يجب أن يراجع الكود الذي يولده الذكاء الاصطناعي بصرامة أكبر من الكود البشري؟

يجب أن يراجع بطريقة مختلفة. فالكود كثيرا ما يكون مرتبا ومعقولا، فتختبئ المخاطر فيما يفترضه، وما تخطاه، وما غيره خارج المهمة. اقرأ الأدلة والنطاق أولا، ثم الكود.

كيف أعرف هل أضعف الوكيل الاختبارات؟

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

هل يقبل أن أوافق على تغيير كبير من الذكاء الاصطناعي لم أقرأه كاملا؟

ليس في الكود المهم. اطلب تقسيم المهمة، أو اقرأ الملفات الخطرة كاملة والملفات الآلية بسرعة. فالموافقة إقرار بأنك فحصت التغيير، ويجب أن تعني ذلك.

هل يجب أن يوافق الشخص الذي كتب الموجه للوكيل على تغييره؟

ليس وحده، حين يستطيع شخص آخر المراجعة. فالشخص الذي كتب المهمة هو فعليا كاتب التغيير، والمراجع الثاني يلتقط ما افترضه الكاتب.