AI CodeOps

المراجعات متعددة الوكلاء

آخر تحديث

كيف يراجع AI CodeOps التغيير بعدة وكلاء: خطوات المراجعة، وجولة ملاحظات على الفروقات الفعلية، ودرجة الخطورة والفرز، والموافقة البشرية التي تلي ذلك.

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

خطوات المراجعة في سير العمل

تتضمن معظم مسارات سير العمل خطوة مراجعة أو أكثر، يشغل كلا منها وكيلها الخاص:

  • في Plan, Build, Review & Test خطوة Review ينفذها Reviewer.
  • في Security-Sensitive Change خطوة Risk analysis قبل التغيير وخطوة Audit diff بعده، وينفذ الاثنتين Security Auditor.
  • في Parallel Review ثلاث مراجعات (الصحة ينفذها Reviewer، والأمان ينفذه Security Auditor، وتغطية الاختبارات ينفذها Tester)، ثم خطوة Merge findings التي تجمعها.
  • يضيف Release Readiness فحصا شاملا سريعا (E2E sanity) وتدقيق تبعيات، ثم خطوة Go / no-go.
  • في Architecture Debate يقترح كل من معماريين نهجا، وتراجعهما خطوة نقد، ثم يأتي توليف نهائي.

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

متى تعمل خطوة المراجعة

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

  1. الخطوات حتى الخطوة المنفذة للتغيير تعمل أولا. وهي في Plan, Build, Review & Test الخطوتان Plan و Build؛ وفي Security-Sensitive Change هي Scope change و Risk analysis و Implement.
  2. يكتب التغيير، وتعمل اختبارات مشروعك عليه.
  3. تعمل الخطوات التي بعد خطوة التنفيذ: Review و Test، أو Audit diff و Validate. ويعرض على كل منها التغيير كما كتب (الفروقات، مقتطعة لتناسب الحجم مع وضع علامة على موضع القطع حين تكون طويلة) ونتيجة الاختبار المسجلة، ويطلب منها أن تذكر الملفات التي قرأتها.

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

سير العمل الذي لا خطوة تنفيذ فيه، مثل Parallel Review أو Swarm Inspection أو Release Readiness، يشغل كل خطواته قبل كتابة أي كود. ومراجعاته تتناول الكود الموجود أصلا في مستودعك. أما Architecture Debate فيكتب وثائق ولا يكتب كودا.

جولة الملاحظات

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

  • الفروقات، بوصفها الشيء المطلوب مراجعته؛
  • ملاحظات كل خطوة يذكر اسمها review أو security أو audit أو risk أو test، بوصفها سياقا؛
  • وفي جلسة المتابعة، ما أثارته الجولات السابقة وما قرره شخص في كل منها.

وتخبر المراجعة بأن الملاحظة بخطورة high أو critical يجب أن تذكر المدخل المحدد الذي يسببها وما الذي يسوء، وبأن الملاحظة التي لا تستطيع إسنادها بهذه الطريقة تكون medium على الأكثر.

وتسجل حتى 12 مشكلة محددة بوصفها ملاحظات. وتنسب إلى Security Auditor إذا عمل ذلك الوكيل في الجلسة، وإلا إلى Reviewer، وإلا إلى آخر وكيل عمل.

ولكل ملاحظة عنوان ووصف وتوصية، وملف في العادة.

درجة الخطورة

درجة الخطورةهل تمنع التغيير ما دامت غير محلولة؟
criticalنعم
highنعم
mediumلا
lowلا
infoلا

التصنيف

واحد من: Security أو quality أو performance أو accessibility أو compliance أو dependency أو documentation أو test coverage أو reliability أو cost أو UX أو other.

حين يتعذر إتمام المراجعة

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

فرز الملاحظات

افتح صفحة الجلسة وابحث عن قائمة Findings. واضبط حالة كل ملاحظة من قائمتها المنسدلة:

الحالةهل تبقى مانعة (إذا كانت high أو critical)؟
open, acknowledged, in progressنعم
fixed, won't fix, false positive, duplicateلا

اختر Fix على ملاحظة لبدء جلسة تصلحها. ويطلب من تلك الجلسة أن تتضمن اختبارا يعيد إنتاج الملاحظة. والملاحظات على مستوى مساحة العمل موجودة في Build & Test → Quality. وتغيير الحالة يحتاج إلى دور له صلاحية الفرز؛ وليست لدى المشاهدين. راجع بوابات الجودة.

المراجعة البشرية

حين تنتهي جولة الملاحظات وتكون الجلسة قد أنتجت فروقات، يفتح AI CodeOps طلب مراجعة في Review & Gate → Approvals. يقرأ شخص الفروقات والملاحظات، ثم يوافق أو يرفض.

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

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

الخطوات التالية

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

هل تنظر المراجعة إلى الكود أم إلى الخطة؟

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

هل يصوت الوكلاء المراجعون؟

لا. تكتب كل خطوة مراجعة تحليلها بدورها، ثم تقرؤها كلها خطوة أخيرة أو جولة الملاحظات. ولا يوجد تصويت ولا عد للإجماع.

ماذا يحدث إذا فشلت مراجعة الذكاء الاصطناعي؟

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

هل كانت هذه الصفحة مفيدة؟