MCP

ArchLang لغة خاصة بالمخططات (DSL) وأداة تجميع: لمن تصلح، أول تجربة في 3 دقائق، وحدود الاستخدام

يناسب ArchLang في المقام الأول من يكتب المخططات في ملف مصدر .arch (يمكن إسناد كتابته إلى وكيل ذكاء اصطناعي) ثم يجمعه إلى SVG/DXF/PDF مع فحص lint والتحقق الهندسي؛ والشرط أن يشغل جهازك حزمة @chanmeng666/archlang عبر npx، وفي التجربة الأولى تمنح الأوامر الفرعية context وصف اللغة كاملا في استدعاء واحد، بينما يكتب compile ملف المخرجات في جهازك.

Official source · ArchLang

Install

npx -y skills add ChanMeng666/archlang --yes

لمن تصلح

  • الأنسب لفئتين: من يريد أن يكتب وكيل ذكاء اصطناعي ملف مصدر المخطط نيابة عنه ثم يجمعه بعد ذلك — والتموضع الرسمي هو «اكتب مصدر .arch، أو دع وكيل ذكاء اصطناعي يكتبه» — ومن يحتاج بسرعة إلى مخططات بصيغ SVG أو DXF أو PDF مع ضبط المصدر بفحص lint والتحقق الهندسي.
  • تصلح كذلك لمن يضع فحص المخططات داخل السكربتات: يدعم كل من describe وvalidate إخراج --json، ما يسهل الحكم على حالة المصدر من داخل البرامج.
  • تتعامل الأداة مع المخططات بوصفها شيفرة: ملف المصدر نص خالص، ووصف التخطيط قابل لإعادة الإنتاج والمقارنة وسهل التسليم إلى وكيل لتعديله؛ أما ناتج التجميع فهو ملف رسم بصيغة متجهية أو مستندية.
  • شرط الاستخدام: الأوامر الرسمية كلها تشغل حزمة npm عبر npx، فلا بد أن يعمل npx على جهازك؛ ومسار التثبيت الرئيسي يستهدف skills لوكيل برمجة (coding agent)، وتعمل الأوامر الفرعية للواجهة النصية في الطرفية دون ربط بأي عميل MCP.
  • غير مناسب ومجهول: لا تظهر في الأدلة أي قدرة على التحرير المرئي أو الرسم بالسحب والإفلات، فهي لا تناسب من يريد أن يرى ما يرسمه وهو يرسمه؛ ولم ترد في الأدلة نماذج لصياغة .arch، فأول ملف مصدر إما أن تكتبه بنفسك أو توكله إلى وكيل؛ ودقة الرسوم الهندسية الرسمية ومطابقتها للمواصفات، وأنظمة التشغيل المدعومة، والترخيص — كلها أمور لم تذكرها الأدلة.

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

المسار الرئيسي واحد فقط: تثبيت skills، في أربع خطوات.

  1. الشرط: أن يعمل npx في الطرفية؛ ولا تتضمن الأوامر الرسمية مفاتيح أو معاملات حساب، فلا حاجة إلى تجهيز بيانات الدخول قبل البدء. أما إن كانت هناك إعدادات بيئة أخرى لازمة فالأدلة لا تذكر ذلك.
  2. التثبيت: قم بتنفيذ npx -y skills add ChanMeng666/archlang --yes لتثبيت skills هذا المستودع لوكيل البرمجة عندك.
  3. تجربة أولى منخفضة التكلفة: قم بتشغيل npx -y @chanmeng666/archlang context. تموضعه الرسمي هو «استدعاء واحد يعطي لغة ArchLang كاملة»، فلا يحتاج الوكيل إلى تحميل معرفة اللغة من قبل. إشارة النجاح: تطبع الطرفية وصف اللغة. أما إن كان الأمر يتصل بالشبكة فذلك وبقية تفاصيل القراءة والكتابة لم تذكرها الأدلة.
  4. الحصول على أول ناتج: بعد تجهيز plan.arch قم بتنفيذ npx -y @chanmeng666/archlang compile plan.arch -o plan.svg --json؛ إشارة النجاح توليد plan.svg في جهازك مع إخراج حالة بصيغة JSON. ولاحظ أن compile يقوم بكتابة محلية وليست عملية قراءة فقط، فالأفضل تشغيله بعد التأكد من محتوى الملف المصدر.

ملاحظة ثانوية (مسار رسمي آخر لا يوضع في مصاف المسار الرئيسي): يمكن لعميل MCP تنفيذ claude mcp add archlang -- npx -y @chanmeng666/archlang-mcp، فيشغل عبر npx حزمة npm منفصلة هي @chanmeng666/archlang-mcp ويسجل خادم باسم archlang؛ وأي أدوات MCP يكشفها ذلك الخادم بعد التسجيل أمر لم تذكره الأدلة.

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

الحالة الأولى: الفحص قبل التجميع. السيناريو: لديك من قبل ملف plan.arch وتريد التأكد من موثوقية المحتوى قبل إخراج الرسم. الطريقة: ابدأ بتنفيذ describe plan.arch --json للاطلاع على وصف البنية، ثم validate plan.arch --strict --json للتحقق الصارم؛ وكلا الأمرين يستخدم بادئة الأمر نفسها التي يستخدمها compile؛ وبعد تصحيح المصدر وفق نتائج التحقق يعاد التجميع، وهذا هو سير العمل الرسمي بعينه: الإصلاح ثم إعادة التجميع. النتيجة المنتظرة: وصف ونتائج تحقق بصيغة JSON، وظهور المشكلات الهندسية قبل تحويل المخطط إلى رسم. وكلا الأمرين يحمل --json فيصلح للربط بالسكربتات قبل التجميع بوصفه خطوة فحص سابقة؛ أما البنية الدقيقة لحقول إخراج التحقق فلم تقدمها الأدلة.

الحالة الثانية: ترك كتابة الرسم للوكيل. السيناريو: لست معتادا على صياغة .arch وتريد إسناد المصدر إلى وكيل. الطريقة: ابدأ بتشغيل npx -y @chanmeng666/archlang context لتسليم اللغة كاملة إلى الوكيل دفعة واحدة، وقد نص الجانب الرسمي صراحة على عدم الحاجة إلى تحميل معرفة اللغة من قبل؛ ثم ليكتب الوكيل ملف مصدر .arch؛ وفي الختام اجمعه بالأمر compile. المصدر يأتي من الوكيل، أما التجميع والتحقق فيبقيان بأوامر محلية. النتيجة المنتظرة: ملف المصدر وأول plan.svg لك. يتموضع المشروع لدعم إخراج SVG وDXF وPDF، لكن الأمر الوحيد في الأدلة القابل للنسخ كلمة بكلمة هو مثال SVG وحده، ومعاملات الإخراج الدقيقة لكل من DXF وPDF غير مؤكدة، فلا تقسها من عندك.

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

  • طبيعة القراءة والكتابة: compile يقرأ plan.arch ويكتب plan.svg في جهازك وفق -o، وهي كتابة محلية واضحة؛ أما describe وvalidate وcontext فلم تسمها الجهة الرسمية أدوات للقراءة فقط، وcontext موصوف فحسب بأنه يطبع وصف اللغة، وبقية تفاصيل القراءة والكتابة لم تذكرها الأدلة.
  • بيانات الدخول والإعداد: لا يتضمن أي من الأوامر الرسمية السابقة معاملات مفاتيح أو رموز دخول، ولم يظهر فيها أي إدخال إلزامي مثل الاسم أو البريد الإلكتروني؛ ووجود متطلبات إعداد إضافية للبيئة أمر لم تذكره الأدلة.
  • تمييز المسارين: التجربة الأولى في هذا المقال مبنية على الأوامر الفرعية للواجهة النصية وتثبيت skills؛ وإذا كان الهدف أن يستدعي الوكلاء عميل MCP، فلا بد من تنفيذ أمر التسجيل على حدة، فالمساران يثبتان محتوى مختلفا بشروط مختلفة.
  • الآثار الجانبية ونقاط التحقق: compile يكتب ملفا في جهازك، فتأكد من مسار الإخراج قبل التشغيل؛ ولا يوجد شرح رسمي لمسار للتراجع، فلا يصح وصفه بأنه «قابل للتراجع»؛ وأي مواضع يكتب فيها تثبيت skills بالتحديد لم تذكرها الأدلة.
  • الناتجان مستقلان: تثبيت skills يستهدف حزمة المهارات للوكلاء؛ وclaude mcp add يسجل حزمة npm أخرى. العلاقة بينهما، وهل يمكن الاكتفاء بأحدهما، أمران لم تذكرهما الأدلة.
  • الترخيص والمنصات المدعومة وسلوك الشبكة وحدود البيانات لم ترد في الأدلة؛ و«عدم وجود شرح» لا يعني عدم وجود خطر، وهذا المقال لا يصدر استنتاجات أمنية مستقلة.