كيف أبني تطبيقات أوراكل بفريق من وكلاء الذكاء الاصطناعي

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

هذا الدليل هو النمط العام. يعمل مع Claude Code أو أي وكيل يمكن تشغيله في جلسات متوازية، على APEX أو PL/SQL أو ORDS أو تحديث Forms.

البنية

القائد

يملك القائد الخطة والعقود: تعريفات الجداول ومواصفات الحزم وأشكال REST وقوائم الصفحات — كل ما يعتمد عليه باقي العمل. يقسّم العمل إلى مسارات، ويدمج ما يعود، ويقرّر ما انتهى. لا يقوم بالتحرير الجماعي بنفسه؛ فالقائد الغارق في الكود يتوقف عن رؤية اللوحة كاملة.

مسارات العمل

كل مسار جلسة وكيل منفصلة بمجموعة ملفاتها الخاصة. لا يكتب وكيلان في الملف نفسه أبدًا، وهذا يزيل معظم آلام الدمج قبل أن تبدأ. يحصل المسار على موجز قصير: الملفات، والعقد الذي يجب احترامه، والاختبار الذي يثبت أنه انتهى.

• قسّم المسارات بالملفات لا بأسماء الميزات: db/packages/billing_* مسار؛ «الفوترة» ليست مسارًا.
• المسارات الآلية (إعادة التسمية، بيانات البذر، الترجمات) تعمل على نموذج أصغر وأرخص.
• ضع حدًا لعدد المسارات. بعد ثلاثة أو أربعة يقضي القائد وقته في الدمج بدل التفكير.

المراجع الخصم — ثلاث لحظات

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

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

مراقب الحركة

مع المسارات المتوازية لا بد من ضابط للنظام: يرتّب الدمج ليصل واحدًا تلو الآخر، ويفرض حد المسارات، ويلاحظ عندما يتجه مساران نحو الملفات نفسها، ويُوقف مسارًا ينتظر عقدًا. قد يكون وكيلًا صغيرًا أو سكربتًا؛ المهم ألا يكون القائد يفعله بانتباهه المتبقي.

اختبار المطابقة

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

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

ضبط الميزانية

فريق من الوكلاء قد ينفق ميزانية أسبوع في بعد ظهر واحد. اضبطها كالمال:

• النموذج المناسب لكل مهمة. النموذج الكبير يخطط ويراجع ويحل التعارضات؛ والأصغر يبحث ويعيد التسمية ويكتب القوالب.
• حدود إعادة المحاولة في الكود لا في الموجّه. سكربت فيه MAX_RETRIES = 2 يتوقف؛ وموجّه يقول «استمر في المحاولة» لا يتوقف.
• خط ميزانية. حدّد مسبقًا مستوى الاستهلاك الذي يتوقف عنده العمل الجديد ويستمر الإنهاء فقط — ولا تتوقف أبدًا في منتصف دمج.
• سياق صغير. وجّه الوكلاء إلى الملفات وأرقام الأسطر بدل لصق تصديرات كاملة.

الأسوار الأمنية

الوكلاء يتحركون بسرعة، لذا يجب أن تكون الأسوار في الإعدادات لا في النوايا الحسنة:

• قواعد منع للأوامر المدمّرة (الدفع القسري، الحذف المتكرر، حذف المستخدمين) ولقراءة الأسرار مثل ملفات .env والمحافظ.
• مستخدم قاعدة بأقل صلاحيات للوكيل. لا SYS ولا حساب DBA ولا محفظة إنتاج على الجهاز.
• سكربتات تطبيق مُتحقَّق من بصمتها. السكربت الذي يلمس القاعدة يُراجَع وتُسجَّل بصمته SHA-256، ولا يعمل إلا إذا طابقت البصمة — فلا يعدّله شيء بين المراجعة والتطبيق.
• إعدادات محمية. لا يستطيع الوكيل تعديل ملف صلاحياته. السور الذي يحرّكه الوكيل ليس سورًا.

قائمة للبدء

1. اكتب العقود أولًا ودع المراجع يهاجمها قبل بدء أي مسار.
2. قسّم المسارات بمجموعات الملفات؛ وأعطِ كل مسار ملفاته وعقده واختبار إنهائه.
3. ضع قواعد المنع ومستخدم القاعدة وحماية الإعدادات قبل أول تشغيل.
4. اجعل اختبار التثبيت النظيف (أو المطابقة) تعريفًا لـ«انتهى».
5. حدّد حد إعادة المحاولة وخط الميزانية، ثم ابدأ.

الأوامر والإعدادات لهذا النمط مجمّعة في بطاقة Claude Code المرجعية، والمهارات الكاملة في حزمة المهارات الاحترافية.

اختبر فهمك