ux-skill

# ux-skill — محرك الذكاء التصميمي لأدوات البرمجة بالذكاء الاصطناعي ux-skill هو **محرك ذكاء تصميمي** مصمم لجعل واجهات المستخدم المولّدة بالذكاء الاصطناعي مميزة بدلًا من أن تكون عامة. يتكامل مع 17 أداة برمجة بالذكاء الاصطناعي تشمل Claude Code وCursor وWindsurf وGitHub Copilot وGemini CLI وCodex وغيرها. المحرك مجاني، ومرخّص بMIT، ويعمل دون اتصال، ولا يستدعي LLM أبدًا. ## الميزات الرئيسية - **مُركّب حتمي بسبعة محاور**: يترجم الموجزات إلى رموز تصميم جديدة (الدفء، التباين، الكثافة، الهندسة، الرسمية، الحركة، شخصية الخط) دون الاختيار من قوالب. - **152 قاعدة فحص ضد رداءة الذكاء الاصطناعي**: قواعد حتمية قائمة على التعبيرات النمطية تعمل في CI وتخرج بقيمة غير صفرية عند وجود مشكلات حرجة أو عالية. - **160 مواصفة علامة تجارية**: مواصفات DESIGN.md حقيقية لعلامات مثل Apple وStripe وLinear وFigma وTesla وBMW وNotion وSpotify وAirbnb وVercel وSupabase وCursor وRaycast وClaude وغيرها. - **12 بيان JSON قابلًا للاستعلام**: 84 نمطًا، و176 لوحة ألوان، و70 اقتران خطوط، و148 مكوّنًا، و184 قطاعًا، و35 نوع مخطط، و57 إعدادًا مسبقًا للحركة، و112 قانون UX، و152 قاعدة ضد الأنماط السيئة، و25 حزمة تقنيات، و160 مواصفة علامة تجارية. - **25 أمرًا مائلًا**: أوامر الاكتشاف والتوليد والتدقيق والفحص والصقل وحلقة الإصلاح ودراسة الحالة وورشة العمل والنسخ والحركة وإمكانية الوصول ولوحة المعلومات والموصل. - **5 وكلاء فرعيين**: مهندس الواجهة الأمامية، ومهندس الحركة، وكاتب النصوص، ومُركّب الأبحاث، ومهندس نظام التصميم. - **18 أداة MCP**: تشمل ux_synthesize وux_decisions_query وux_decisions_stats. - **دعم 17 بيئة تطوير**: المحرك نفسه مع طبقة ربط مختلفة لكل بيئة. - **دون اتصال وحتمي**: لا استدعاءات LLM، والمدخل نفسه ينتج المخرج نفسه دائمًا. ## التثبيت تتوفر ثلاثة مسارات للتثبيت: ### المسار 1 — سوق Claude Code (المرجعي) ```bash /plugin marketplace add Laith0003/ux-skill /plugin install ux@ux-skill ``` ### المسار 2 — pip (شامل) ```bash pip install uxskill uxskill init # يكتشف بيئة التطوير تلقائيًا ويثبّت المكوّن الصحيح uxskill stats # يطبع أعداد البيانات للتحقق من التثبيت uxskill lint . # يشغّل الفاحص على الدليل الحالي ``` ### المسار 3 — npx (دون الحاجة إلى Python) ```bash npx uxskill init # ينزّل pipx + uxskill عند أول تشغيل npx uxskill recommend --industry=fintech-neobank --tone=warm --stack=nextjs-15-app-router ``` ## كيف يعمل 1. **المدخل**: قدّم موجزًا عبر `/ux-discover` (10 حقول) أو عبر أعلام إلى `ux recommend`. 2. **5 عمليات بحث متوازية**: يشغّل المحرك خمس عمليات بحث متزامنة عبر البيانات (القطاع، النمط، النبرة، الحزمة، المحظور/المنطقة). 3. **الدمج**: يدمج دامج حتمي المرشحين ويحل التعارضات. 4. **المخرج**: مستند JSON يحتوي على النمط ولوحة الألوان واقتران الخطوط وإعدادات الحركة والمكوّنات وأمثلة العلامات التجارية وضوابط ضد الأنماط السيئة. 5. **التوليد**: تستهلك الأوامر اللاحقة التوصية لتوليد الكود عبر الوكلاء الفرعيين. 6. **التحقق**: يعيد `/ux-lint` فحص الكود المولّد مقابل 152 قاعدة تعبير نمطي. ## أبرز ميزات v3.1.0 - **فرض أمانة العلامة التجارية**: يُقرأ اللون الأساسي من بكسلات الشعار، وتُرفض الخطوط الافتراضية، ويوجد حد أدنى صارم في التقييم يُفشل المخرجات التي تُسقط لون/شعار العلامة التجارية أو لا تتضمن صورًا حقيقية. - **بوابة الأولوية للجوال**: أسس حرفية جديدة بالإضافة إلى بوابة تراعي الالتفاف وتُفشل التمرير الأفقي أو التفاف شريط التنقل/العلامة النصية/نص الزر أو الرأس اللاصق الطويل جدًا. - **طبقة الإبهار**: يستخرج المحرك 2-3 لحظات توقيع متناسقة لكل صفحة. - **فاحص أكثر حدة**: 152 قاعدة تشمل إلزامية الصور، واكتشاف الأيقونات فقط، وقواعد رموز العناصر النائبة و100vw. - **310 اختبارات ناجحة**: دون اتصال، وحتمية، ولا يُستدعى LLM أبدًا. ## البنية يتكوّن المحرك من: - **data/**: بيانات JSON قابلة للاستعلام (الأنماط، لوحات الألوان، أزواج الخطوط، المكوّنات، القطاعات، أنواع المخططات، حزم التقنيات، إرشادات UX، إعدادات الحركة المسبقة، الأنماط السيئة، العلامات التجارية). - **engine/**: نواة استدلال بلغة Python (المُركّب، القرارات، الموصي، الفاحص، الاكتشاف، المولّد، المثبّت، CLI). - **commands/**: 25 أمرًا مائلًا لـClaude Code (ملفات .md). - **agents/**: 5 وكلاء فرعيين (ملفات .md). - **references/**: مصدر نثري للبيانات وصفحات العرض. - **bin/**: غلاف npx وسكربتات الفحص. - **.ux/**: دليل حالة لكل مشروع. ## المقارنة يتضمن README مقارنة صادقة مع 8 إضافات Claude UX أخرى، موضحًا أين يتفوق ux-skill (مكتبة المكوّنات، إعدادات الحركة المسبقة، فاحص الأنماط السيئة، مواصفات العلامات التجارية، دعم 17 بيئة تطوير، 25 أمرًا مائلًا) وأين يخسر (الوعي، التعرف على العلامة التجارية، الصقل التسويقي). ## الترخيص ترخيص MIT. المؤلف: Laith Aljunaidy، مصمم ومدير تقني في عمّان. الموقع: uxskill.laithjunaidy.com. GitHub: Laith0003/ux-skill. PyPI: uxskill. npm: uxskill.