التوصيل · فصل ٨

البناء بـ Agent Skills

mcp-server-dev · scaffolds · Remote · MCPB · MCP Apps
🎯 الهدف: تخلّي الوكيل يسألك الأسئلة الصح ويطلع هيكل سيرفر مناسب لمسارك.

Agent Skills مجموعات تعليمات متنقلة بتدي مساعد البرمجة معرفة متخصصة. في تطوير MCP بتحوي قرارات التصميم: طريقة النشر، أنماط الأدوات، والمصادقة. الوكيل يستجوب حالتك ويعمل هيكل سيرفر مناسب.

التلات مهارات

المجموعة المرجعية في إضافة mcp-server-dev من ريبو الإضافات الرسمي. التلاتة بيركبوا مع بعض:

build-mcp-server

نقطة الدخول. يسأل عن الاستخدام، يختار نموذج النشر ونمط الأدوات، ويحوّل للمهارة المتخصصة.

build-mcp-app

يضيف واجهات تفاعلية (فورم، لوحة، منتقي) بتترسم جوه الشات.

build-mcpb يعمل حزمة لسيرفر stdio لوكال مع بيئة التشغيل بتاعته، فاليوزر يثبته من غير Node أو Python.

كل مهارة فيها SKILL.md وفولدر مراجع. الوكيل يقراها لما يحتاج. الملفات على فورمات مفتوح وتشتغل مع أي وكيل بينفّذ المعيار. في Claude Code بتتضاف من سوق الإضافات الرسمي. لوكيل تاني دور في كتالوج المهارات، أو انسخ فولدر المهارة لمكان المهارات عنده.

قبل أي كود

المهارة بتشتغل من طلب طبيعي، أو تستدعيها مباشرة. قبل الكود فيه اكتشاف قصير: بيتوصل بإيه، مين هيستخدمه، حجم الأكشنز، نوع التفاعل (نص، أو إدخال منظم، أو واجهة غنية)، ونوع المصادقة (مفيش، أو مفتاح، أو OAuth، أو مصادقة الخدمة اللي فوق). لو رسالتك الأولى غطت ده، الوكيل يقفز على التوصية.

أربع مسارات

Remote HTTP

الافتراضي لأي حاجة بتغلّف واجهة سحابية. صفر تثبيت، نشر واحد يخدم الكل، و OAuth يشتغل صح لأن السيرفر يتعامل مع التحويل وتخزين التوكن. فيه هياكل لـ Cloudflare Workers و Express.

MCP Apps

لما محتاج ودجت تفاعلية في الشات والفورم المسطح بتاع elicitation ما يكفيش. المهارة تسلّم لـ build-mcp-app.

MCPB لما السيرفر لازم يلمس جهاز اليوزر: ملفات لوكال، أو تطبيق ديسكتوب، أو خدمة على localhost. أرشيف واحد فيه السيرفر وبيئة التشغيل. stdio اللوكال للنموذج الأولي، مع مسار ترقية للحزمة لما تجهز للتوزيع.

بعد الهيكل: حسّن أوصاف الأدوات ومعالجة الأخطاء، وجرّب بـ Inspector، ووصّله بكلاينت، وانشره في سجل MCP لو هيتوزع.

خلّصت الفصل لما

🧠 اختبر نفسك
١) سيرفر بيغلّف واجهة Jira لفريقك كله. أنهي مسار؟
Remote Streamable HTTP. نشر واحد، ومصادقة تشتغل على السيرفر.
٢) سيرفر بيتحكم في تطبيق ديسكتوب على جهاز اليوزر، واليوزر مش مبرمج؟
MCPB. الحزمة فيها بيئة التشغيل، من غير ما يثبّت Node أو Python.
٣) امتى المهارة تحوّل لبناء واجهة؟
لما قيود الفورم المسطح بتاعة elicitation ما تكفيش، ومحتاج ودجت في الشات.