احصر أول مهمة لوكيل Cursor السحابي في إصلاح واحد قابل للتحقق

إسناد خلل صغير قابل لإعادة الإنتاج إلى Cursor، ثم انتظار طلب سحب (PR) لمراجعته بشريًا، طريقة جديرة بالتجربة أولًا عند استخدام وكيل يعمل في الخلفية. وينبغي أن تستوفي المهمة المناسبة للتفويض ثلاثة شروط معًا: أن يكون السلوك المتوقع واضحًا، وأن يمكن التحقق منه في البيئة البعيدة، وأن يستطيع مسؤول واحد فهم نطاق التغييرات. إذا غاب أحد هذه الشروط، فاستكماله أولًا أنفع من مواصلة إطالة التعليمات.

يسمّي Cursor هذا المنتج حاليًا Cloud Agents، بعد أن كان اسمه Background Agents. وهو يعمل داخل آلة افتراضية معزولة في السحابة، بدلًا من تولّي العمل في مجلد العمل المحلي الحالي لديك. وفي مهام المستودعات، يعدّل الشيفرة ويسلّمها على فرع مستقل. يستند التحليل التالي لاختيار المهام إلى الوثائق الرسمية، ولم يُنفّذ المثال فعليًا.

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

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

يمكن صياغة متطلبات تفويض الإصلاح السابق على النحو التالي:

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

هذا مثال لمهمة بغرض التحليل، وليس برنامجًا نصيًا جاهزًا للتنفيذ يدّعي وجود هذه الملفات أو الأوامر. وعند التفويض الفعلي، يجب أيضًا تحديد المستودع والإيداع المرجعي (commit) والإدخال الفعلي الذي يعيد إنتاج المشكلة وأوامر اختبار المشروع. وعند قبول العمل، تأكد من أن الاختبار الجديد يغطي الخلل الأصلي فعلًا، ولا تكتفِ بعبارة «نجحت الاختبارات». فإذا حذف الوكيل عبارات التحقق، أو عدّل الاختبار ليجعل السلوك الخاطئ هو المتوقع، فلن تكون لعلامة النجاح الخضراء أي قيمة.

توضح وثائق بيئة Cursor أن الوكلاء السحابيين المستضافين يعملون على Ubuntu، ويمكن إعدادهم بإرشاد من الوكيل أو باستخدام Dockerfile. لذا لا يجوز افتراض أن الأدوات المثبتة محليًا، أو الملفات التي لم تُضمّن في إيداع، أو الاتصالات بخدمات خاصة، متاحة بالفعل في البيئة البعيدة. تحقق أولًا من إمكان تثبيت الاعتماديات وبدء الاختبارات والاتصال بالخدمات اللازمة، ثم أدرج الإصلاح في قائمة المهام.

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

في المهمة الأولى، يُفضّل اختيار إصلاح لا يحتاج إلى بيانات الإنتاج أو بيانات اعتماد بيئة الإنتاج، واستخدام أمثلة منزوعة المعلومات الحساسة أو بدائل اختبارية. وإذا تعذّر إنشاء بيئة تحقق موثوقة، فالمهمة ليست مناسبة بعد للمضي دون إشراف حتى تصبح جاهزة للدمج.

توضح وثائق Cursor أن Cloud Agents يملك وصولًا إلى الإنترنت افتراضيًا وينفّذ أوامر الطرفية تلقائيًا. وبذلك يمكنه مواصلة تشغيل الاختبارات، لكنه قد يتأثر أيضًا بحقن التعليمات بعد قراءة محتوى خبيث. يستطيع الفرع المستقل عزل تغييرات الشيفرة، لكنه لا يستطيع استرجاع بيانات أُرسلت بالفعل إلى الخارج. ولذلك لا يكفي اعتبار «وجود شخص يراجع طلب السحب في النهاية» حدًا أمنيًا أثناء التنفيذ.

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

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

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

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

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