AI CodeOps

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

يراجع AI CodeOps الفروقات الفعلية لكل جلسة ذكاء اصطناعي، ويسجل الملاحظات مع درجة خطورتها، ويحتجز طلب السحب ما دامت ملاحظة بخطورة high أو critical مفتوحة.

في AI CodeOps، المراجعة خطوة تمر بها كل جلسة فيها تغيير في الكود: تقرأ مراجعة بالذكاء الاصطناعي الفروقات الفعلية وتسجل كل مشكلة ملاحظة لها درجة خطورة وتصنيف وتوصية. والملاحظات المفتوحة بخطورة high (عالية) أو critical (حرجة) تحتجز التغيير، فلا يصبح طلب سحب ولا يدمج من لوحة التحكم إلى أن يصلحها أحد أو يفرزها.

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

الوكلاء الذين يعملون

ثلاثة وكلاء مضمّنين ينجزون معظم عمل المراجعة:

  • وكيل Reviewer: الصحة والوضوح والحالات الحدية وسهولة الصيانة.
  • وكيل Security Auditor: التفويض والحقن والأسرار وانكشاف البيانات ومخاطر سلسلة التوريد، مرتبة حسب الخطورة مع الإصلاحات.
  • وكيل Tester: خطة الاختبار وتغطية الاختبارات للتغيير.

وكيل Architect يجمع المراجعات الأخرى في رؤية واحدة في Parallel Review و Swarm Inspection، ويعطي قرار المضي أو التوقف (go/no-go) في Release Readiness. ووكيل Dependency Auditor يراجع مخاطر التبعيات. راجع فهرس الوكلاء للبقية.

سير العملخطوات المراجعة
Plan, Build, Review & TestReviewer ثم Tester، بعد خطة Architect وبعد Builder
Quality-Gated ChangeBuilder، Tester، ثم Reviewer
Parallel ReviewReviewer (الصحة)، Security Auditor، Tester (التغطية)، Architect (الجمع)
Security-Sensitive ChangeSecurity Auditor قبل Builder وبعده، ثم Tester
Release ReadinessReviewer، Security Auditor، E2E Tester، Dependency Auditor، Architect (go/no-go)

مع فئة النماذج Auto، يعد Reviewer و Security Auditor خطوتي توجيه ويحصلان على أفضل فئة لديك حصة فيها. وكذلك مراجعة الملاحظات. راجع النماذج.

جلسة في AI CodeOps متوقفة عند بوابة الموافقة البشرية، تعرض أربعة ملفات متغيرة وملاحظتي مراجعة بخطورة medium و low

عرض توضيحي تفاعلي، ببيانات نموذجية.

ملاحظات من الفروقات الفعلية

الخطوات حتى الخطوة المنفذة للتغيير تعمل قبل وجود الكود. والخطوات التي بعدها، مثل Review و Audit diff و Test، تعمل بعد كتابة الكود واختباره، وتقرأ الفروقات مع نتيجة الاختبار المسجلة. أما مسارات سير العمل التي لا خطوة تنفيذ فيها، مثل Parallel Review و Release Readiness، فتشغل كل خطواتها قبل جولة كتابة الكود. وفي كل الأحوال تعمل مراجعة الملاحظات أخيرا وتقرأ الفروقات نفسها. ويجب أن تجيب بمصفوفة JSON، وكل عنصر فيها يصبح ملاحظة:

[
  {
    "title": "Coupon code is passed to the pricing query without validation",
    "severity": "high",
    "category": "security",
    "description": "applyCoupon() forwards the raw request value to the discount lookup.",
    "recommendation": "Validate length and characters before the lookup and return 400 on a bad code.",
    "filePath": "src/api/checkout.ts"
  }
]

درجة الخطورة هي critical أو high أو medium أو low أو info. والتصنيف واحد من security أو quality أو performance أو accessibility أو compliance أو dependency أو documentation أو test_coverage أو reliability أو cost أو ux أو other. تسجل المراجعة 12 ملاحظة على الأكثر. والمصفوفة الفارغة تعني أن المراجع لم يجد خطأ.

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

يحفظ محتوى الملاحظة كما كتبته المراجعة. ولا يتغير بعد ذلك إلا حالة فرزها.

الفرز

تظهر الملاحظات في صفحة الجلسة. وتظهر الملاحظات الأمنية أيضا في صفحة Security. ولكل منها حالة:

  • الحالات Open أو acknowledged أو in progress: ما زالت تنتظر المعالجة. وهذه تمنع حين تكون الخطورة high أو critical.
  • الحالات Fixed أو won't fix أو false positive أو duplicate: عولجت. وهذه لا تمنع أبدا.

تغيير الحالة يسجل من قام بالفرز. وكل ملاحظة وحالتها النهائية تدخل في حزمة الأدلة الموقّعة للتغيير.

بوابات الجودة المعنية

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

  • لم تكتمل مراجعة الملاحظات؛
  • توجد أي ملاحظة بخطورة high أو critical بحالة open أو acknowledged أو in progress.

يستطيع CI لديك أن يسأل البوابة نفسها عن طلب سحب عبر /api/release/check، وأن يضبط blockingSeverity على medium ليمنع عند الملاحظات بخطورة medium أيضا. وكل ملاحظة مانعة في ذلك الرد تذكر خطورتها وتصنيفها وعنوانها وملفها والوكيل المنسوبة إليه. والطلب والرد كاملان في صفحة بوابات الجودة.

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

ما ليست عليه

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

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

هل يراجع AI CodeOps كل طلب سحب في مستودعي؟

لا. يراجع التغييرات التي تجري عبر جلسات AI CodeOps. أما طلبات السحب التي يفتحها الأشخاص مباشرة على GitHub أو خدمة استضافة أخرى فلا تراجع، وإن كان بوسع CI لديك أن يسأل بوابة الإصدار عنها.

هل يعمل وكلاء المراجعة بالتوازي؟

لا. تعمل خطوات سير العمل واحدة تلو الأخرى، ويرى كل وكيل ما كتبه من سبقوه. وسير العمل Parallel Review أخذ اسمه من تغطية عدة زوايا مراجعة للتغيير نفسه، لا من تشغيلها في الوقت نفسه.

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

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

أي الملاحظات تمنع التغيير؟

الملاحظات بخطورة high أو critical التي ما زالت بحالة open أو acknowledged أو in progress. ومتى وسمتها بحالة fixed أو won't fix أو false positive أو duplicate توقفت عن المنع. ويمكن لاستدعاء من CI إلى البوابة أن يخفض العتبة إلى medium.

هل يستطيع الذكاء الاصطناعي إصلاح ملاحظة عني؟

نعم. لكل ملاحظة زر Fix يبدأ تشغيلا جديدا للذكاء الاصطناعي موجها إلى تلك الملاحظة. ويمر تغييره بالمراجعة والبوابة نفسيهما.