مطوّر في Domclick يعلّم OpenCode ضبط نفسه: MCP والمهارات والصلاحيات في أمسيتين

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

أين ينهار الإعداد

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

الأولى: كثرة الكيانات. فالمهارات (skills) وMCP والصلاحيات (permissions) ومستويات الإعدادات المختلفة يجب أن تبقى كلها حاضرة في الذهن في آن واحد. وفي مرحلة ما لم يعد يتذكر أيَّ مهارة تخدم أيَّ غرض.

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

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

النهج الكسول: الوكيل يضبط نفسه

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

وهذا سياق لمن لم يتابع الموضوع. MCP (Model Context Protocol) بروتوكول مفتوح قدّمته Anthropic في نوفمبر 2024 لربط النماذج بأدوات خارجية ومصادر بيانات. أما OpenCode فهو وكيل برمجة مفتوح المصدر يعمل في الطرفية وفي عميل سطح المكتب. وتُحدَّد فيه صلاحيات الإجراءات عبر الإعدادات وفق مخطط «السماح، أو السؤال، أو المنع». وحين يتعدد خوادم MCP ويحتوي كل منها على عشرات الأدوات، تتحول الإدارة اليدوية سريعًا إلى عمل روتيني مرهق.

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

ما هو معروف من الإعلان

• الأداة: OpenCode Desktop.
• الكاتب: فلاديمير باندوف، مطوّر Backend في Domclick.
• الوقت: نحو 30 دقيقة حتى اللحظة التي صار فيها الإعداد اليدوي مرهقًا، ثم أمسيتان تقريبًا للوصول إلى مخطط يعمل.
• المكوّنات: المهارات (skills) وMCP والصلاحيات (permissions) وعدة إعدادات.
• المشكلة الرئيسية: الوكيل ينفّذ عملًا لم يُطلب منه.
• ثمن الحل: قد يزداد استهلاك التوكنات.
• لا يتضمن الإعلان أي قياسات لتوفير الوقت أو التكلفة.

كيف تطبّق ذلك في عملك

يمكن أن تستخلص من المادة عدة قواعد عملية لا ترتبط بعميل بعينه.

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

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

اربط MCP خادمًا تلو الآخر، وراقب الأدوات التي يضيفها إلى السياق. فكل خادم يستهلك توكنات في الأوصاف، ويوسّع مساحة احتمالات الخطأ.

احتفظ بالإعدادات التي يعدّلها الوكيل في git، وراجعها عبر diff. فإذا كان الوكيل يغيّر صلاحياته بنفسه، فيجب أن ترى ذلك قبل الالتزام (commit).

وأخيرًا، قِس. إذا كان المخطط «الكسول» يكلّف فعلًا توكنات أكثر، فقيّم ذلك على مهام حقيقية خلال أسبوع، وقارنه بالوقت الذي وفّرته بعدم الإعداد اليدوي.