ورشة مجانية 21–22.11ورشة مجانية لمدة يومين في Vibecoding يومي 21–22 نوفمبر الساعة 16:00 بتوقيت موسكو · الدفعة 3 تبدأ 23.11سجّل مجاناً ←الدفعة 3 (23.11)
إصدارAPI / منتج · جاهز للعملHabr AI→ المصدر

عمل نظام Claude Code المحيط لدى شخص واحد، لكنه تعطّل لدى زملائه: 5 خطوات نحو قابلية النقل

النظام المحيط (harness) هو المهارات (skills) واتصالات MCP والوكلاء الفرعيون وعمليات التحقق التي تحيط بوكيل ذكاء اصطناعي مثل Claude Code. عمل هذا النظام لدى كاتب من Directum سنة كاملة دون أعطال، لكنه تعطّل لدى زملائه: فقد بقيت في السكربتات مسارات من جهازه، ولم يكن على الجهاز الافتراضي النظيف Python ولا Node.js. وصف الكاتب خمس خطوات لإخراج نفسه من المعادلة: أصبحت المسارات تُحسب انطلاقًا من جذر المستودع، وصار المثبّت نفسه يفحص البيئة. الخلاصة: اختبروا التثبيت على جهاز نظيف قبل أن يجرّبه أول زميل.

معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
عمل نظام Claude Code المحيط لدى شخص واحد، لكنه تعطّل لدى زملائه: 5 خطوات نحو قابلية النقل
المصدر: Habr AI. كولاج: Hamidun News.
استمع للمقال
بطاقة الحقائق والأرقام
المعيارالتفاصيل
المصدر الأصليHabr AI ↗
رئيس التحرير
حقيقة رئيسية #1حلقة «المراجعة — التصحيح» محدودة بثلاث محاولات، ثم يُستدعى الإنسان
حقيقة رئيسية #2الاشتراك أوفر بوضوح لمهام الكاتب من دفع ثمن رموز API (tokens)، ولا حاجة إلى خادم
حقيقة رئيسية #3تلتقط evals — سيناريوهات التحقق — أي عطل يصيب المهارات بعد التعديلات

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

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

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

ما الذي جرى نقله بالضبط

تصل إلى الكاتب متطلبات العملاء، وعليه أن يُري بسرعة على نموذج أولي كيف يمكن تنفيذها على المنصة. لدى بيئة تطوير Directum RX (Development Studio) واجهة JSON-RPC API، وقد وُصلت بـ Claude Code عبر MCP. ينشئ الوكيل الكيانات والخصائص وهياكل الدوال بالآلية نفسها التي يستخدمها المطوّر في نافذة البيئة، ثم يكتب منطق التطبيق بلغة C#. أما نشر الحزم على الخادم التجريبي فتتولاه الأداة المعيارية Deployment Tool، ويُفحص الناتج عبر API وواجهة الويب.

يتوزّع العمل على وكلاء فرعيين: مالك المنتج (product owner) يُعدّ المتطلبات ومعايير القبول، والمعماري يصمّم الحل، والمطوّر يكتب الشيفرة والاختبارات، والمختبِر يفحص السيناريوهات، وثلاثة مراجعين يفحصون بالتوازي الشيفرة والأمان والتوافق مع المعمارية. تُحفظ مخرجات كل مرحلة في المجلد .pipeline، ويدير الانتقالات بينها سكربت يتحقق من النتائج الإلزامية ويحفظ الحالة، ولذلك يواصل المنسّق بعد أي انقطاع من النقطة نفسها.

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

خادم مشترك أم تثبيت محلي

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

لذلك وقع الاختيار على التثبيت المحلي: ينسخ كل مستخدم النظام المحيط من مستودع منفصل في GitLab الداخلي، ويعمل باشتراكه الخاص. وبالنسبة إلى مهام الكاتب، فإن الاشتراك أوفر بوضوح من دفع ثمن الرموز (tokens) عبر API، كما أن الخدمة المشتركة لا يلزم نشرها من اليوم الأول. تُضمّ الفرق تدريجيًا ويُنظر هل يفيدها النظام المحيط. وثمن هذا الاختيار أن الاعتماديات والمسارات والصلاحيات وإصدارات الأدوات تختلف من جهاز إلى آخر.

تُحفظ الأجزاء العامة والخاصة بالمشروع والشخصية بشكل منفصل. تدخل القواعد العامة إلى مستودع النظام المحيط، وتُحفظ متطلبات المشروع بجوار شيفرته، أما الإعدادات الشخصية وبيانات الوصول فتبقى محليًا ولا تصل إلى Git. وما دام الكاتب وحده يستخدم النظام المحيط، كانت في السكربتات مسارات من جهازه مكتوبة يدويًا (hardcoded). أما الآن فيبحث النظام عن ملفاته نسبةً إلى جذر المستودع، ويأخذ المثبّت مسارات Development Studio وDeployment Tool من ملف الإعدادات.

يتولى توصيل التحديثات خطّاف (hook) في Claude Code، أي سكربت يعمل عند بدء الجلسة. يلاحظ الخطّاف صدور إصدار جديد، ويقترح جلب التغييرات، ويحدّث الاعتماديات، ويتحقق من أن الأدوات تعمل. تُحفظ الإعدادات المحلية، وتُعرض التعارضات مع التعديلات، ويمكن الرجوع إلى الإصدار السابق.

التشغيل الأول على جهاز نظيف

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

الآن يشغّل المشارك الجديد المثبّت، فيفحص البيئة، ويثبّت الاعتماديات، ويضبط خوادم MCP. يمكن إعادة التثبيت المقطوع، وتُتخطى الخطوات المنجَزة. وإذا تكرر الخطأ لدى عدة أشخاص، يُضاف حله إلى المثبّت. ويراعي المثبّت نظام التشغيل ونظام إدارة قواعد البيانات وإصدار المنصة. فعلى سبيل المثال، تعمل المنصة مع PostgreSQL وMSSQL معًا، لكن أدوات الكاتب المبنية على psql غير متاحة مع MSSQL، ويحذّر المثبّت من ذلك. وتُفحص الأدوات من داخل Claude Code تحديدًا، لأن العمل في الطرفية (terminal) وكون الأداة متاحة للوكيل أمران مختلفان. ولأن Bash كان يعمل بشكل غير مستقر على Windows في ظل مضاد الفيروسات، نُقلت نقاط دخول السكربتات إلى Node.js.

ولكي لا تُفسد تعديلات الفرق سلوك الوكيل، تُشغَّل evals — سيناريوهات تحقق بمعايير نجاح محددة سلفًا. فمثلًا، إذا عدّل أحدهم مهارة أساسية لمشروعه فتوقفت عن إجراء الفحص الإلزامي قبل إنهاء المهمة، فسيُظهر هذا السيناريو التراجع (regression). لكن evals لا تغطي سوى الحالات الموصوفة فيها.

ماذا نفعل عمليًا

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

القصة

أسئلة وأجوبة حول الخبر

ما أبرز التفاصيل حول ما الذي جرى نقله بالضبط؟

تصل إلى الكاتب متطلبات العملاء، وعليه أن يُري بسرعة على نموذج أولي كيف يمكن تنفيذها على المنصة. لدى بيئة تطوير Directum RX (Development Studio) واجهة JSON-RPC API، وقد وُصلت بـ Claude Code عبر MCP. ينشئ الوكيل الكيانات والخصائص وهياكل الدوال بالآلية نفسها التي يستخدمها المطوّر في نافذة البيئة، ثم يكتب منطق التطبيق بلغة C#. أما نشر الحزم على الخادم التجريبي فتتولاه الأداة المعيارية Deployment Tool، ويُفحص الناتج عبر API وواجهة الويب.

ما أبرز التفاصيل حول خادم مشترك أم تثبيت محلي؟

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

ما أبرز التفاصيل حول التشغيل الأول على جهاز نظيف؟

لم يكن الخطّاف أول ما ظهر. فقد أعدّ الكاتب في البداية جهازًا افتراضيًا نظيفًا، ونسخ المستودع، وشغّل الوكيل. بدأت الأخطاء قبل أول مهمة مفيدة: كانت تنقص اعتماديات ثبّتها منذ زمن على جهازه ونسيها. فإحدى الأدوات تحتاج Python، وأخرى Node.js، وثالثة تنقصها مكتبات. ساعد الوكيل نفسه في الإعداد في البداية، لكنّ التحضير كان يستهلك أحيانًا حدّ نافذة Claude كاملةً البالغة خمس ساعات. الآن يشغّل المشارك الجديد المثبّت، فيفحص البيئة، ويثبّت الاعتماديات، ويضبط خوادم MCP. يمكن إعادة التثبيت المقطوع، وتُتخطى الخطوات المنجَزة.

ZK
جمال حميدون — مدير المنتجات في Alpina Digital ومدير منتج AlpinaGPT. يبني منتجات الذكاء الاصطناعي منذ 2019. بدأ Hamidun News كمشروع شخصي ثم أصبح مُجمِّعًا إنتاجيًا بأكثر من 6000 قارئ.
✦ Hands-On AI Engineering · Hamidun Academy

Build & Ship Production AI Agents Without Boilerplate Code

Start your free 72-hour trial at Hamidun Academy (academy.hamidun.com) — interactive lessons on Claude Code & Cursor, live Tech Radar, and production agent templates.

Start 72h Free Trial →Vibe-Coding Intensive
ما رأيك؟
جارٍ تحميل التعليقات…