عمل نظام Claude Code المحيط لدى شخص واحد، لكنه تعطّل لدى زملائه: 5 خطوات نحو قابلية النقل
النظام المحيط (harness) هو المهارات (skills) واتصالات MCP والوكلاء الفرعيون وعمليات التحقق التي تحيط بوكيل ذكاء اصطناعي مثل Claude Code. عمل هذا النظام لدى كاتب من Directum سنة كاملة دون أعطال، لكنه تعطّل لدى زملائه: فقد بقيت في السكربتات مسارات من جهازه، ولم يكن على الجهاز الافتراضي النظيف Python ولا Node.js. وصف الكاتب خمس خطوات لإخراج نفسه من المعادلة: أصبحت المسارات تُحسب انطلاقًا من جذر المستودع، وصار المثبّت نفسه يفحص البيئة. الخلاصة: اختبروا التثبيت على جهاز نظيف قبل أن يجرّبه أول زميل.
معالج بواسطة الذكاء الاصطناعي من Habr AI؛ بتحرير Hamidun News
بنى كثيرون حول وكيل الذكاء الاصطناعي نظامًا محيطًا شخصيًا: شاهدوا مقاطع فيديو قصيرة، وجمعوا مهارات (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 للمهارات الأساسية. وتنبيه: هذه تجربة مهندس واحد في شركة واحدة، وسيتعين انتقاء الحلول من جديد للمنصات الأخرى.
- 21 نوفمبر 2026خادم MCP في 360 سطرًا بلا SDK: خمسة قرارات جعلت الوكيل يتوقف عن إفساد الروابط
- 21 نوفمبر 2026Text-to-cad: وكيل ذكاء اصطناعي يرسم أجزاء الروبوت من وصف نصي، والمشروع يحصد 26 ألف نجمة
- 21 نوفمبر 2026فيديو Claude في GTA 6 يبدو مفبركًا: نصف ساعة من التحكم استنزفت حد الساعات الخمس في اشتراك Pro
- 21 نوفمبر 2026Claude Code يسرّع فك تجميع لعبة Snowboard Kids 2: من 20% إلى 45% من الدوال خلال ثلاثة أشهر
أسئلة وأجوبة حول الخبر
ما أبرز التفاصيل حول ما الذي جرى نقله بالضبط؟
تصل إلى الكاتب متطلبات العملاء، وعليه أن يُري بسرعة على نموذج أولي كيف يمكن تنفيذها على المنصة. لدى بيئة تطوير Directum RX (Development Studio) واجهة JSON-RPC API، وقد وُصلت بـ Claude Code عبر MCP. ينشئ الوكيل الكيانات والخصائص وهياكل الدوال بالآلية نفسها التي يستخدمها المطوّر في نافذة البيئة، ثم يكتب منطق التطبيق بلغة C#. أما نشر الحزم على الخادم التجريبي فتتولاه الأداة المعيارية Deployment Tool، ويُفحص الناتج عبر API وواجهة الويب.
ما أبرز التفاصيل حول خادم مشترك أم تثبيت محلي؟
نظر الكاتب في خيارين. الأول خدمة مشتركة ببيئات معزولة (sandboxes) مثل GoClaw أو OpenHands: يحصل المستخدم على بيئة مُهيّأة مسبقًا بالإصدار المطلوب من المنتج. وهذا مريح لفريق واحد ببيئة واحدة. لكن النظام المحيط كان سيستخدمه عدة فرق بمنتجات مختلفة وإصدارات منصة مختلفة ومجموعات حلول مختلفة. ولا يمكن بناء بيئة واحدة للجميع، ودعم عدة صيغ يتطلب فريقًا مستقلًا. لذلك وقع الاختيار على التثبيت المحلي: ينسخ كل مستخدم النظام المحيط من مستودع منفصل في GitLab الداخلي، ويعمل باشتراكه الخاص.
ما أبرز التفاصيل حول التشغيل الأول على جهاز نظيف؟
لم يكن الخطّاف أول ما ظهر. فقد أعدّ الكاتب في البداية جهازًا افتراضيًا نظيفًا، ونسخ المستودع، وشغّل الوكيل. بدأت الأخطاء قبل أول مهمة مفيدة: كانت تنقص اعتماديات ثبّتها منذ زمن على جهازه ونسيها. فإحدى الأدوات تحتاج Python، وأخرى Node.js، وثالثة تنقصها مكتبات. ساعد الوكيل نفسه في الإعداد في البداية، لكنّ التحضير كان يستهلك أحيانًا حدّ نافذة Claude كاملةً البالغة خمس ساعات. الآن يشغّل المشارك الجديد المثبّت، فيفحص البيئة، ويثبّت الاعتماديات، ويضبط خوادم MCP. يمكن إعادة التثبيت المقطوع، وتُتخطى الخطوات المنجَزة.
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.
أهم ما في عالم الذكاء الاصطناعي — مرة كل أسبوع
سبع قصص مهمة فعلاً هذا الأسبوع، مختارة بعناية. بلا ضجيج ولا بيانات صحفية.
تم! تحقق من بريدك للتأكيد.