استخدام Oil UI في Cursor و Windsurf ووكلاء البرمجة داخل بيئات التطوير
يبني كثير من المطورين الواجهات ويصقلونها مباشرة داخل Cursor أو Windsurf أو Antigravity أو Gemini CLI جنباً إلى جنب مع كود التطبيق. وبما أن Oil UI يستخدم صيغة الـ Skill المفتوحة، يزوّد أمر واحد هو npx skills add oil-oil/oil-ui وكلاء بيئات التطوير هذه بالمسار نفسه القائم على المهمة: استكشاف التوجهات، وتنفيذ الحالات الفعلية ضمن بنيتك، والتحقق من اللقطات المصيّرة.
النقاط الأساسية
مثبّت واحد يغطي أبرز وكلاء البرمجة
نفّذ npx skills add oil-oil/oil-ui واختر Cursor أو Windsurf أو Claude Code أو Codex.
نقطة رئيسية 2
عند تحديث شاشات داخل قاعدة برمجية قائمة، حصر كل prompt في صفحة واحدة أو مسار مستخدم واحد، واذكر الـ props والـ hooks والمسارات التي يجب أن تبقى دون مساس.
نقطة رئيسية 3
لوحدات الواجهة المستقلة (أدوات الرفع، والدفع، ومخصصات المنتجات)، اطلب من الوكيل تنفيذ حالات الخمول والنشاط والإتمام والخطأ منذ البداية.
نقطة رئيسية 4
اطلب من وكيل بيئة التطوير فتح خادم التطوير المحلي وفحص لقطات متصفح حقيقية بدقة 1440px و390px بدلاً من الاكتفاء بمراجعة فروقات الكود.
تثبيت Oil UI عبر وكلاء بيئات التطوير والطرفية
سواء كنت تعمل في الشريط الجانبي لوكيل Cursor أو Windsurf Cascade أو Antigravity أو وكيل في الطرفية، يوفر Oil UI مسار عمل التصميم نفسه وقوائم المراجعة البصرية نفسها.
شغّل مثبّت الـ Skill التفاعلي
نفّذ الأمر في جذر مشروعك أو الطرفية واختر وكلاء البرمجة الذين تستخدمهم يومياً.
npx skills add oil-oil/oil-uiاستخدم التثبيت على نطاق المشروع لاتساق الفريق
يضع اختيار نطاق المشروع الـ Skill داخل مستودعك حتى يتبع وكيل بيئة التطوير لدى كل زميل معايير التخطيط والمراجعة نفسها.
استدعِ Oil UI صراحة في الـ prompt
ابدأ prompts الواجهات بعبارة "Use Oil UI to design..." أو "Use Oil UI to refresh this screen..." حتى يشغّل الوكيل مسار عمل التصميم بدلاً من ترقيع الأنماط ارتجالياً.
أربع عادات للتصميم داخل قاعدة برمجية قائمة
أكثر أنماط الفشل شيوعاً في وكلاء بيئات التطوير هو خلط توصيلات الخلفية مع إعادة تصميم بصري كاملة في prompt واحد متشعب. فصل الاهتمامات يحافظ على نظافة الكود والتخطيط معاً:
- احصر النطاق في وحدة مستقلة واحدة أو مسار مهمة واحد في كل مرة
- اصقل وحدة واحدة من البداية إلى النهاية — مثل وحدة رفع الملفات Chute أو مخصص لوحة المفاتيح الميكانيكية KEEB في المعرض — قبل الانتقال إلى الشاشات المجاورة.
- حدّد أي hooks للبيانات ومعالجات أحداث يُمنع المساس بها
- عند تحديث عرض React أو Vue قيد الإنتاج، أخبر الوكيل: "أبقِ حالة النموذج الحالية، وطلبات تعديل API، ومعاملات المسار سليمة؛ أعد العمل فقط على التخطيط والتسلسل الهرمي وتغذية الحالة الراجعة".
- قارن التوجهات الجديدة في مسار تجريبي قبل الدمج
- إذا احتاجت صفحة إلى توجه بصري جديد، دع الوكيل يصيّر 3 خيارات متمايزة جنباً إلى جنب أولاً، ثم انقل التوجه المختار إلى مكوّناتك الرئيسية.
- تحقّق دائماً على localhost عند عروض سطح المكتب والهاتف
- قبل قبول التعديلات، اطلب من الوكيل فتح خادم التطوير المشغّل والتقاط لقطات بدقة 1440px و390px لاكتشاف الفيض أو التباعد الضيق أو التباين المكسور.
prompt قابل لإعادة الاستخدام لصقل الوحدات في Cursor و Windsurf
أشر إلى ملف المكوّن المستهدف في محادثة بيئة التطوير واستخدم هذه البنية للحصول على تنفيذ متكامل متعدد الحالات:
استخدم Oil UI لتصميم وتنفيذ [اسم الوحدة، مثلاً: وحدة رفع ومشاركة الملفات / مخصّص المنتج] في هذا المستودع.
- قيود قاعدة الكود: أبقِ [الـ hooks والـ props وأنواع API] الحالية دون تغيير.
- الحالات المطلوبة: نفّذ 1) حالة الخمول الافتراضية، 2) تغذية السحب/الإدخال النشط، 3) حالة التقدّم والإتمام (مع تأكيد النسخ/المشاركة)، و4) حالة التحقق أو خطأ تجاوز الحد.
- الانضباط البصري: تجنّب أغلفة البطاقات المتداخلة والشارات الكبسولية الزخرفية فوق العناوين. ابنِ التسلسل الهرمي عبر سلم الخطوط والتباعد وحالات التركيز الواضحة، ثم تحقّق في المتصفح المحلي.يعمل جيداً عند الإشارة إلى ملف المكوّن القائم لديك داخل Cursor أو Windsurf.
أمثلة حية و prompts من المعرض
تصفح المجموعة →افتح تجديد المشاريع القائمة وحِرفية المكوّنات مع Oil UI Pro
يضيف Oil UI Pro مسارات عمل مخصصة لقواعد الكود القائمة — تشمل التشخيص المشروح لصفحة واحدة، ونظام تجديد من 3 مستويات (ترتيب / ترقية / إعادة تصميم المسار + DESIGN.md)، والصقل الفائق لمكوّن واحد.
استكشف Oil UI Pro →npx github:oil-oil/oil-cli install oil-ui-proالأسئلة الشائعة
أي نموذج أختاره داخل Cursor أو Windsurf عند استخدام Oil UI؟
استخدم Claude Opus أو نماذج GPT/Codex الرائدة عند استكشاف توجهات بصرية جديدة أو إعادة هيكلة الصفحات المعقدة. وبمجرد تحديد التوجه أو ملف DESIGN.md، يعمل Claude Sonnet والنماذج الأسرع بكفاءة لتعميم الحالات عبر الشاشات الشقيقة.
هل يعمل Oil UI جنباً إلى جنب مع shadcn/ui أو Radix أو Tailwind؟
نعم. توفّر مكتبات المكوّنات الأساسية عناصر تحكم ميسّرة الوصول، بينما يحكم Oil UI تكوين الصفحة، والتسلسل البصري، واستكشاف التوجهات، وإزالة النمطية. وهما يتكاملان بسلاسة.
كيف أتأكّد أن الوكيل لن يكسر معالجات النقر الحالية أو التحقق من النماذج؟
اذكر المعالجات المطلوب الحفاظ عليها في الـ prompt، واتبع خطوة تتبّع المهام في Oil UI: انقر فعلياً عبر المسار الأساسي واختبر إرسال نموذج غير صالح في المتصفح قبل الإنهاء.
هل يمكن لفريقي استخدام Cursor و Claude Code / Codex على المستودع نفسه؟
نعم. حدّد جميع الوكلاء المعنيين أثناء تشغيل npx skills add oil-oil/oil-ui أو اعتمد ملف DESIGN.md مشتركاً في المستودع حتى تقرأ كل أداة قواعد التصميم نفسها.



