AI CodeOps

بوابات جودة لكود الذكاء الاصطناعي تغلق عند الخطأ

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

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

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

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

البوابة لا تثق برأي الوكيل في عمله. بل تقرأ سجلات أنتجها الوكلاء والمنصة:

  • الملاحظات من مراجعة الفروقات الفعلية، منسوبة إلى Security Auditor حين يكون في سير العمل، وإلا إلى Reviewer.
  • تشغيلات الاختبار من مجموعة اختباراتك أنت. يسمي Tester حالات الاختبار ويقرأ التشغيل المسجل، لكن النتيجة المعتد بها تأتي من تشغيل المجموعة.
  • تشغيلات سير العمل للجلسة نفسها، مثل تشغيل مكتمل لسير العمل Release Readiness، حين يشترط CI لديك ذلك.

سير العمل Quality-Gated Change (Builder، Tester، Reviewer) هو أقصر طريق عبر البوابة. وأي سير عمل آخر يغير الكود يمر بالفحوص نفسها.

صفحة Pipelines في AI CodeOps وفيها أعداد المراحل Develop و Review and Gate مع موافقات بشرية معلقة، و Deliver و Operate ومقاييس DORA

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

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

حين تنتهي الجلسة، يحدد AI CodeOps هل تغييرها جاهز للإطلاق. ويحتجز التغيير إذا أخفق أي مما يلي:

  • مراجعة الذكاء الاصطناعي جرت. بعد كتابة الكود، تقرأ خطوة مراجعة الفروقات وتسجل ملاحظات منظمة. وإذا تعذر إكمالها يحتجز التغيير إلى أن يراجع. والمراجعة الغائبة لا تحتسب نجاحا أبدا.
  • لا ملاحظات مانعة. الملاحظة بخطورة high (عالية) أو critical (حرجة) التي ما زالت بحالة open أو acknowledged أو in progress تمنع التغيير. راجع مراجعة الكود بالذكاء الاصطناعي.
  • الاختبارات لا تفشل. تعمل مجموعة اختبارات المشروع نفسه على التغيير في بيئة معزولة غير متصلة بالشبكة. والاختبار الفاشل أو رمز الخروج غير الصفري يمنعه. وكذلك تغيير الكود الذي ليست له نتيجة اختبار فيها أعداد، ما لم يكن خيار Don't run tests for this project مفعلا في المشروع. راجع الاختبار.
  • النسخة المختبرة هي الحالية. إذا عدّل أحد التغيير بعد تشغيل الاختبارات، لم تعد النتيجة القديمة محتسبة.
  • شخص يوافق. كل جلسة تنتج تغييرا تفتح طلب موافقة. وتكفي موافقة واحدة. ومن بدأ الجلسة لا يستطيع منحها ما دام في مساحة العمل شخص آخر يملك صلاحية الموافقة. تعمل وحدك؟ مساحة العمل التي فيها صاحب صلاحية موافقة واحد توافق على تغييراتها بنفسها، ويسمها مسار التدقيق بأنها موافقة ذاتية. ورفض واحد ينهي الطلب. وتعديل الكود بعد الموافقة يعيده إلى حالة الانتظار. والطلب الذي لم يبت فيه تنتهي صلاحيته بعد سبعة أيام ويمكن طلبه من جديد.
  • سياسة مساحة العمل. قبل فتح طلب السحب، يفحص المستودع وكل ملف متغير وفق سياساتك. قرار الرفض (deny) يوقفه؛ وقرار طلب الموافقة (ask) يحتاج إلى موافقة.

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

ما تمنعه

تنطبق البوابة على الإجراءات التي تجري عبر AI CodeOps، وهي:

  1. فتح طلب سحب من جلسة.
  2. دمج طلب سحب فتحته جلسة، من لوحة التحكم.
  3. عمليات النشر التلقائية بعد دمج إصلاح حادثة.

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

استخدام البوابة من CI

صفحة Release gate (ضمن Review & Gate) تفحص عنوان طلب سحب أو قيمة SHA لإيداع عند الطلب. والفحص نفسه متاح واجهة API لخط CI لديك، بمصادقة عبر مفتاح API لمساحة العمل:

curl -s -X POST "https://<your-console>/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pullRequestURL":"https://github.com/acme/checkout/pull/42","blockingSeverity":"medium","requireDeployedTo":"staging"}'

إجابة بالرفض، مختصرة إلى الحقول الرئيسية:

{
  "allowed": false,
  "evidenceComplete": true,
  "summary": "HIGH security: Coupon code is passed to the pricing query without validation",
  "reasons": [
    "HIGH security: Coupon code is passed to the pricing query without validation",
    "Not yet deployed to \"staging\" — promote there before releasing"
  ],
  "blockingFindings": [
    {
      "id": "fnd_01JA8ZC1P3R5T7V9X1Z3B5D7F9",
      "severity": "high",
      "category": "security",
      "title": "Coupon code is passed to the pricing query without validation",
      "workflowRunID": "wfr_01JA8YQ4M2C7H5K9P3S6V8X1ZD",
      "agentID": "security-auditor",
      "filePath": "src/api/checkout.ts"
    }
  ],
  "testFailures": [],
  "coverageShortfall": null,
  "priorEnvironmentMissing": { "required": "staging" },
  "requiredGatesPassed": true,
  "missingRequiredWorkflows": []
}

تعيد API الحالة HTTP 200 في النتيجتين كلتيهما، فاقرأ الحقل allowed لا رمز الحالة. ويمكن لكل استدعاء أن يضبط فحوصا أشد:

  • الحقل blockingSeverity، للمنع عند الملاحظات بخطورة medium إضافة إلى high و critical.
  • الحقل minCoveragePct، حد أدنى للتغطية يطبق على أحدث تشغيل ذكر التغطية. وإذا لم يذكر أي تشغيل التغطية فلا يمكن فحص الحد الأدنى ويرفض التغيير.
  • الحقل requiredWorkflows، مسارات سير عمل يجب أن تكون قد اكتملت على هذا التغيير.
  • الحقل requireDeployedTo، بيئة يجب أن يكون التغيير قد نشر إليها من قبل.
  • الحقل blockOnInFlight، للرفض ما دامت جلسة للتغيير لا تزال تعمل.

تنظر البوابة افتراضيا إلى تشغيلات آخر 14 يوما. والتغيير الذي لا تجد له جلسة يرفض ولا يمرر: فليس لدى البوابة ما تحكم عليه. وكذلك أدلة الاختبار. فالجلسة التي غيّرت كودا تحتاج إلى نتيجة اختبار فيها أعداد. وإذا لم يعمل أي اختبار، أو لم يذكر أمر الاختبار أعدادا، ترفض بوابة الإصدار التغيير، ما لم يكن خيار Don't run tests for this project مفعلا في المشروع.

كيف تضبط

الفحوص المضمّنة مفعلة لكل مساحة عمل وواحدة لكل جلسة. وصفحة Policies (ضمن Secure) تضيف قواعدك أنت فوقها. كل قاعدة تسمح بإجراء أو تطلب موافقة عليه أو ترفضه، مثل بدء سير عمل أو تغيير ملفات تحت مسار أو فتح طلب سحب. وإعداد الثقة يقرر ما يحدث حين لا تنطبق أي قاعدة. ويسجل كل قرار رفض أو طلب موافقة.

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

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

هل تستطيع بوابة فاشلة منع الدمج؟

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

ماذا يحدث إذا لم تكن للمشروع اختبارات؟

فعّل خيار "Don't run tests for this project" في إعدادات المشروع. ومن دونه ترفض بوابة الإصدار تغيير كود ليست له نتيجة اختبار فيها أعداد، لأن غياب الدليل ليس نجاحا. ويبقى التغيير محتاجا إلى مراجعة ملاحظات سليمة وإلى موافقة.

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

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

كيف أزيل ملاحظة مانعة؟

أصلحها، أو افرزها. الملاحظة الموسومة بحالة fixed أو won't fix أو false positive أو duplicate لا تمنع بعد ذلك. أما الملاحظات بحالة open أو acknowledged أو in progress وبخطورة high أو critical فتمنع.

هل يستطيع خط CI لدي أن يطلب من البوابة حكما؟

نعم. استدع /api/release/check بمفتاح API لمساحة العمل وعنوان طلب السحب أو قيمة SHA للإيداع. فيعيد حكما فيه allowed بقيمة true أو false مع الأسباب.

ماذا لو وقع خطأ في البوابة نفسها؟

يرفض التغيير. كل بوابة في AI CodeOps تغلق عند الخطأ، فالخطأ أثناء الفحص لا يسمح أبدا بمرور تغيير.