AI CodeOps

وكيل Reviewer

يفحص وكيل Reviewer التغييرات المقترحة من حيث الصحة والحالات الحدية وسهولة الصيانة، ويذكر إصلاحات ملموسة. ويعمل في ثمانية من مسارات سير العمل المضمّنة.

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

أين يعمل

سير العملالخطوة
Plan, Build, Review & TestReview
Parallel ReviewCorrectness review
UI ImplementationCode review
Architecture DebateCritic review
Swarm InspectionReviewer slice
Release ReadinessCorrectness review
Data MigrationFinal review
Quality-Gated ChangeReview

في Architecture Debate يؤدي دور الناقد: يعترض على التصميمين المتنافسين اللذين يقدمهما وكيل Architect قبل التوليف النهائي.

يتوقف موعد عمل خطوته على سير العمل:

  • بعد كتابة الكود. في Plan, Build, Review & Test و UI Implementation و Data Migration و Quality-Gated Change، تلي خطوته الخطوة المنفذة للتغيير. فينتظر حتى يكتب الكود وتعمل اختبارات المشروع، ثم يراجع ذلك التغيير.
  • قبل جولة كتابة الكود. لا خطوة تنفيذ في Parallel Review و Swarm Inspection و Release Readiness. فتعمل كل خطواتها قبل كتابة أي كود، ويعمل وكيل Reviewer انطلاقا من المهمة والكود الموجود أصلا في المستودع.
  • بلا كود على الإطلاق. ينتهي Architecture Debate بوثائقه.

المدخلات

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

المخرجات

تعيد خطوة وكيل Reviewer قائمة مشكلات مع إصلاحاتها، نصا. وهي تشكل بقية الجلسة بطريقتين:

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

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

على فئة Auto تذهب خطوات وكيل Reviewer إلى فئة Premium أولا.

مثال على تشغيل

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

الحدود

  • بعد كتابة الكود يقرأ الفروقات، والفروقات الطويلة تقتطع لتتسع، مع وسم موضع الاقتطاع. وجولة الملاحظات تقرأ الفروقات أيضا: اقرأ ملاحظاتها، لا خطوة وكيل Reviewer وحدها.
  • خطوته لا تغير الكود. والإصلاح الذي يقترحه بعد كتابة الكود يحتاج إلى جلسة متابعة، أو إلى زر Fix (إصلاح) على الملاحظة.
  • لا يشغل الكود. يتحقق من السلوك اختبارات المشروع في خطوة التحقق (verify)، ويقرأ وكيل Tester النتيجة.
  • قد يخطئ في الاتجاهين: قد يفوته خطأ حقيقي، وقد ينبه إلى ما ليس مشكلة. ويمكن فرز الملاحظات في صفحة الجلسة.

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

هل يرى وكيل Reviewer الفروقات النهائية؟

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

هل تستطيع ملاحظات المراجعة منع الدمج؟

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