agent-config: توحيد skills وقواعد الحوكمة عبر أدوات الذكاء الاصطناعي المتعددة، مع نقطة نهاية MCP للقراءة فقط تستضيفها بنفسك

يوزّع agent-config مجموعة من skills وrules وcommands وguidelines وpersonas عبر npm ويسقطها في الإعداد الأصلي لكل أداة ذكاء اصطناعي مدعومة، باتباع معيار Agent Skills المفتوح؛ ويمكن أيضًا تقديم محتوى الحوكمة نفسه من Cloudflare Worker الخاص بك كنقطة نهاية MCP. إنه ليس agent runtime: فحلقة الوكيل وتوزيع مهام LLM وتنسيق الأدوات تبقى في الأداة المضيفة. المشكلة التي يحلّها محدَّدة جدًا — مجموعة واحدة من skills وقواعد الحوكمة دون الحاجة إلى إعادة تهيئتها في كل أداة.

لمن هذا مناسب

• يناسب المطوّرين والفرق التي تتنقل بين عدة أدوات ذكاء اصطناعي وتريد إبقاء skills وقواعد الحوكمة متسقة: تُسقَط طبقة المحتوى في الإعداد الأصلي لأدوات مضيفة مثل Claude Code وAugment وCursor وCline وWindsurf وGemini CLI وCopilot — صيانة مرة واحدة واستخدام في كل الأدوات.
• يناسب الأفراد والفرق المحتاجين إلى نقطة نهاية MCP مستضافة ذاتيًا: يُقدَّم محتوى الحوكمة من Cloudflare Worker الخاص بك، ويصل إليه أي عميل MCP — مثل Claude Desktop وClaude Code وCursor وZed وContinue والوكلاء المستضافين — عبر HTTP، دون تكرار المحتوى في كل عميل.
• لا يناسب من يريد اعتباره agent runtime: فهو لا يشغّل حلقة الوكيل ولا يتولى توزيع مهام LLM أو تنسيق الأدوات؛ إن كنت تبحث عن خدمة تنفّذ المهام وتوزّع النماذج عنك، فهذه القدرات موجودة في الأداة المضيفة.
• لا يناسب من يتوقع خدمة محلية جاهزة فور التثبيت: فالخادم المحلي المدمج (local stdio server) يتطلب checkout محليًا وليس جاهزًا فور التثبيت.
• المتطلب التشغيلي: Node ≥ 18؛ أما بقية متطلبات النظام فلم تذكرها الأدلة وتبقى غير مؤكدة.

أول تجربة خلال 3 دقائق

المسار الرئيسي واحد فقط: أمر التثبيت الرسمي المعياري (canonical) مع فحص واحد للمجلدات العامة.

1. المتطلب: تثبيت Node ≥ 18 على الجهاز.
2. نفّذ الأمر الرسمي المعياري في سطر الأوامر: npx @event4u/agent-config init.
3. قبل التنفيذ، كن واضحًا بشأن الآثار الجانبية: يكتب init في المجلدات العامة فقط — مثل ~/.event4u/agent-config/ و~/.claude/ و~/.cursor/؛ ولا يكتب ملفات المشروع، وproject scope حصري للمشرفين (maintainers). هذا كتابة حالة محلية وليس إرسالًا بعيدًا؛ الأدلة لا توضح طريقة التراجع أو الاستعادة، فإن لم تكن متأكدًا من التأثير فخذ نسخة احتياطية من هذه المجلدات قبل التنفيذ.
4. إشارات النجاح: بعد انتهاء الأمر تظهر محتويات مكتوبة في المجلدات العامة المذكورة، وترى skills وrules وcommands وguidelines وpersonas المُسقَطة في الإعداد الأصلي للأدوات المدعومة. ولتتأكد من النطاق أولًا، اطّلع مباشرة على الملفات في هذه المجلدات العامة.

طريق الخادم ذكرٌ ثانوي فقط: بعد نشر Cloudflare Worker الخاص بك، يمكن للعملاء الوصول إلى محتوى الحوكمة كنقطة نهاية MCP. تؤكد الأدلة هذه القدرة لكنها لا تعطي أوامر النشر ولا مقاطع الإعداد، فتبقى الخطوات المحددة غير مؤكدة؛ هذا إجراء إعداد بعيد، فلا تعدّه خطوة إلزامية في البدء السريع. عند أول تعامل، يُستحسن البدء بالأدوات الصغيرة للقراءة فقط (مثل memory_lookup وlist_*): فـ«القراءة فقط» تعني فقط عدم تنفيذ عمليات كتابة، ولا تعني غياب مخاطر أخرى، ولا يجوز الاستنتاج منها أنه لا يتصل بالشبكة أو يقرأ بياناتك المحلية.

حالات الاستخدام

الحالة الأولى: مشاركة المهارات والقواعد نفسها بين Claude Code وCursor. صيانة إعدادَي الأداتين منفصلين تؤدي غالبًا إلى انحراف. على جهاز يستوفي Node ≥ 18 نفّذ npx @event4u/agent-config init ودَعه يكتب طبقة المحتوى في المجلدات العامة. النتيجة المتوقعة في نطاق الأدلة: تُكتب مجلدات مثل ~/.event4u/agent-config/ و~/.claude/ و~/.cursor/، ويتبع المحتوى معيار Agent Skills المفتوح، وتبقى ملفات مشاريعك بلا تأثير؛ وبعدها تقرأ الأداتان من إعدادهما الأصلي المجموعة نفسها من skills وrules. وفق الوصف الرسمي، هدف الإسقاط كل أداة مدعومة، لا الأداتان المذكورتان هنا كمثال فقط. توقيت الاستخدام: حين تتطور المهارات والقواعد في الأداتين منفصلتين فتختلف، وتريد أن يكون محتوى واحدًا هو المرجع. الحد: يحل توزيع المحتوى فقط، ولن ينفّذ عنك أي مهارة داخل الأدوات.

الحالة الثانية: استضافة نقطة نهاية MCP للحوكمة للقراءة فقط ذاتيًا. يريد الفريق أن يقرأ عدة عملاء محتوى حوكمة موحدًا عبر HTTP دون تثبيت على كل جهاز. قدّمه من Cloudflare Worker الخاص بك كنقطة نهاية MCP: يُخرَج محتوى الحوكمة بصيغة MCP prompts وresources — skills وcommands وrules وguidelines وcontexts — مع أدوات القراءة فقط memory_lookup وchat_history_read وlist_*؛ ويمكن لعملاء MCP مثل Claude Desktop وClaude Code وCursor وZed وContinue والوكلاء المستضافين الوصول عبر HTTP. النتيجة القابلة للملاحظة: بعد اتصال العميل يظهر محتوى الحوكمة في قائمتي prompts وresources، ويمكن استدعاء أدوات القراءة فقط المذكورة. توقع أيضًا: لا ينفّذ Worker سكربتات Python البالغة نحو 112 (linters وaudits وtask ci وwork-engine hooks)؛ فتلك تتطلب تثبيتًا محليًا وفق Quickstart. خطوات نشر Worker غير واردة في الأدلة، وما يمكن تأكيده ينحصر في التصريح الرسمي بوجود القدرة.

حدود الاستخدام

• طبيعة القراءة والكتابة: جهة Worker للقراءة فقط — يقدَّم محتوى الحوكمة بصيغة prompts وresources، والأدوات محصورة في أدوات صغيرة للقراءة فقط مثل memory_lookup وchat_history_read وlist_*، ولم يُذكر رسميًا وجود أي أداة كتابة؛ وinit كتابة محلية محصورة في المجلدات العامة دون لمس مستودعات المشاريع. أدوات القراءة فقط تثبت فقط عدم تنفيذ عمليات كتابة؛ أما الاتصال بالشبكة أو قراءة البيانات المحلية فالأدلة لا توضحه.
• الآثار الجانبية ونقاط التحقق: يكتب init في ~/.event4u/agent-config/ و~/.claude/ و~/.cursor/ وغيرها؛ وproject scope حصري للمشرفين، ما يعني أن التثبيت العادي لا يغيّر أيًّا من مستودعات مشاريعك. الأدلة لا توضح وجود تراجع أو استعادة تلقائية، ولا تسرد قائمة الملفات المكتوبة.
• القيود الرسمية الصريحة: لا ينفّذ Worker سكربتات Python البالغة نحو 112 (linters وaudits وtask ci وwork-engine hooks)، وتتطلب تثبيتًا محليًا وفق Quickstart؛ والخادم المحلي المدمج (local stdio server) موجود في Glama MCP Registry لاكتشافه فقط ويتطلب checkout محليًا (انظر ADR-067).
• تدقيق المسارات: لتوزيع المحتوى إلى الأدوات اختر init؛ ولقراءة محتوى الحوكمة عبر MCP اختر Worker؛ ولتنفيذ سكربتات Python فثبّت محليًا وفق Quickstart ثم نفّذ.
• غير المؤكد بعد: أوامر نشر Worker ومقاطع الإعداد، وإعداد الاتصال المحدد لكل عميل، ومتطلبات النظام الكاملة عدا Node ≥ 18. الأدلة لم تغطِ ذلك، فاجعل المستودع الرسمي مرجعك قبل البدء.