AI CodeOps

قائمة تحقق لمراجعة الكود بالذكاء الاصطناعي: 25 فحصا لطلبات السحب

آخر تحديث

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

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

النطاق

  • 1. التغيير يطابق المهمة. اقرأ المهمة قبل الفروقات. التغيير يفعل ما طلب، بالطريقة التي كنت ستفهم بها الطلب.
  • 2. لا شيء زائد مدسوس معه. لا إعادة هيكلة أو إعادة تسمية أو إعادة تنسيق لم يطلبها أحد، ولا إصلاحات من نوع «ما دمت هنا» ممزوجة بالتغيير الحقيقي.
  • 3. الملفات الحساسة تغيرت عن قصد. تعريفات CI، وملفات تعريف التبعيات، والمصادقة، والبنية التحتية، وعمليات الترحيل، لم تتغير إلا حيث احتاجت المهمة ذلك.
  • 4. التغيير صغير بما يكفي لمراجعته. إذا لم تستطع قراءة الأجزاء الخطرة كما ينبغي، فاطلب تقسيم المهمة بدل القراءة السريعة.

الأدلة

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

الاختبارات

  • 9. لم تحذف اختبارات ولم توقف. ابحث عن حالات محذوفة، وعلامات تخطٍّ، واختبارات معلقة بالتعليق.
  • 10. التأكيدات لم ترخ. المقارنة الدقيقة لم تتحول إلى فحص لوجود قيمة أو لكونها صحيحة منطقيا.
  • 11. القيم المتوقعة لم تحرك لتناسب الكود. اللقطات والمخرجات المتوقعة التي تغيرت لها سبب تجده في المهمة.
  • 12. الاختبارات الجديدة يمكن أن تفشل. تتحقق من النتائج، ولا تحاكي إلا الأطراف، وكانت ستفشل لو عكس التغيير.

الصحة

  • 13. كل واجهة API وكل حزمة موجودة. الدوال والخيارات والحزم حقيقية في الإصدارات التي يثبتها ملف القفل لديك.
  • 14. الأخطاء لا تبتلع. لا كتل catch فارغة، ولا فشل يسجل ثم يتجاهل، ولا خطأ يتحول إلى نتيجة فارغة.
  • 15. لا بدائل صامتة. القيم الافتراضية مثل الصفر أو السلسلة الفارغة أو القائمة الفارغة لا تخفي بحثا فاشلا.
  • 16. الحالات الحدية معالجة. المدخلات الفارغة والمفقودة، والمناطق الزمنية، وتقسيم النتائج إلى صفحات، وإعادة المحاولة، وطلبان في الوقت نفسه.
  • 17. لا دوال مساعدة مكررة. الأداة المساعدة الجديدة لا تكرر أداة موجودة أصلا في قاعدة الكود.
  • 18. تغييرات البيانات آمنة. عمليات الترحيل إضافية أو قابلة للعكس، ولم تعدّل أي عملية ترحيل سبق تشغيلها.

الأمان

  • 19. فحوص الصلاحيات تطابق جيرانها. نقاط النهاية والإجراءات الجديدة تفحص التفويض بالطريقة التي يفحصه بها الكود المشابه.
  • 20. المدخلات غير الموثوقة تبقى بيانات. لا استعلامات SQL ولا أوامر واجهة الأوامر ولا HTML مبنية من مدخلات المستخدم، ولا تعليمات متبعة من تعليقات أو ملفات في الفروقات.
  • 21. لا أسرار في الفروقات. لا مفاتيح ولا رموز ولا كلمات مرور ولا عناوين URL خاصة في الكود أو الاختبارات أو بيانات الاختبار أو أسطر السجل.
  • 22. لا إعدادات افتراضية غير آمنة. لا تشفير مهمل، ولا فحوص شهادات معطلة، ولا CORS مفتوح، ولا مفاتيح تصحيح أخطاء تركت مفعلة.

التبعيات

  • 23. كل تبعية جديدة تستحق مكانها. إنها لازمة، وتحظى بالصيانة، ومكتوبة بشكل صحيح (لا اسما مشابها مضللا)، وبترخيص تسمح به.

الموافقة

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

استخدام هذه القائمة

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

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

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

الفحوص التي يؤتمتها AI CodeOps

بعض هذه الفحوص يمكن فرضه بدل تذكره. ففي AI CodeOps:

  • الفحص 4: التغيير الذي تتجاوز فروقاته 60 KB يرفض بالرسالة "Split the task into smaller changes".
  • الفحصان 5 و 8: تعمل اختبارات مشروعك على التغيير، ولا تحتسب النتيجة إلا للإصدار الذي عملت عليه، وتبين لوحة Quality gates متى تعذر التحقق من تغيير.
  • الفحص 7: تحمل ملاحظات مراجع الذكاء الاصطناعي درجة خطورة، والملاحظة المفتوحة بخطورة high أو أعلى تمنع التغيير إلى أن توسم بالحالة fixed أو won't fix أو false positive أو duplicate؛ ولا يكفي وسمها بالحالة acknowledged. راجع بوابات الجودة.
  • الفحص 3: تستطيع سياسة مساحة العمل أن تشترط موافقة على التغييرات تحت مسارات مثل infra/**، أو أن ترفضها.
  • الفحص 23: تستطيع بوابة الإصدار التي يستدعيها CI لديك رفض تغيير حين يظهر ترخيص غير مسموح به في قائمة SBOM للمشروع.
  • الفحصان 24 و 25: لا يستطيع من بدأ الجلسة الإدلاء بصوت الموافقة ما دام شخص آخر يستطيع الموافقة، وتعديل التغيير بعد الموافقة يعيده إلى الموافقة من جديد. راجع الموافقات والسياسات.

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

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

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

شغّل فحوص النطاق والأدلة والموافقة على كل طلب. وشغّل البقية كاملة على التغييرات التي تمس المال أو المصادقة أو البيانات الشخصية أو الصلاحيات أو البيانات المخزنة، وبسرعة على التغييرات الآلية الرتيبة.

هل هذه القائمة مقصورة على الكود الذي يكتبه وكلاء الذكاء الاصطناعي؟

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

هل يمكنني نسخ هذه القائمة إلى الويكي أو قالب طلب السحب لدينا؟

نعم. فهي مرخصة بموجب CC BY 4.0، فيمكنك نسخها وتعديلها. وضع رابطا إلى هذه الصفحة حين تنشر نسختك.

استشهد بهذه الصفحة

AI CodeOps (2026). قائمة تحقق لمراجعة الكود بالذكاء الاصطناعي: 25 فحصا لطلبات السحب. https://aicodeops.dev/learn/ai-code-review/checklist

هذه الصفحة وملفاتها القابلة للتنزيل مرخصة بموجب ترخيص CC BY 4.0، فيمكنك نسخها وتعديلها لفريقك، مع وضع رابط إلى هذه الصفحة حين تنشر نسختك.