Oil UI
كتيّب السيناريوهات · تجديد المشاريع القائمة

تجديد واجهات المشاريع القائمة: حدّث تطبيقات React والويب بأمان

بناء عرض توضيحي جديد من الصفر أمر سهل؛ أما تجديد تطبيق إنتاج حي دون كسر عقود API أو التحقق من النماذج أو حالة URL فهو الموضع الذي تنهار فيه الـ prompts الأحادية. المسار الآمن هو قفل منطق العمل غير القابل للتفاوض أولاً، واتباع نطاق تجديد متدرّج، وتتبع المهمة الفعلية بعدّ النقرات، واستخلاص ملف DESIGN.md مشترك من أول شاشة مكتملة.

النقاط الأساسية

اقفل ثوابت العمل أولاً

اذكر استجابات API ومعاملات المسار ومعالجات النماذج التي يُمنع على الوكيل المساس بها.

جدّد عبر ثلاث خطوات واضحة

الخطوة 1 تزيل ضوضاء الحدود والألوان، والخطوة 2 ترقّي التخطيط والحالات الناقصة، والخطوة 3 تختصر سلاسل النوافذ متعددة الصفحات.

نقطة رئيسية 3

تحقّق من سهولة الاستخدام بعدّ النقرات — تقليص حلقة صفحة تفاصيل من 8 نقرات إلى إجراءين مجمّعين داخل الصفحة يتفوق على مجرد تغيير شكلي.

نقطة رئيسية 4

بمجرد اجتياز شاشتك الرئيسية للمراجعة، احفظ الـ tokens وسلم الخطوط والتباعد في DESIGN.md حتى تتطابق كل المسارات الشقيقة.

النقرات للإتمام
2خطوات
انتقالات الصفحات
0صفحات
احتمال التراجع للخلف
بلا انتقالات · معاينة مقسمة + إجراء جماعي وتراجع بنقرة
غصن · سجل المراسلات
قائمة دون رد (3)
06 أكتوبر
08 أكتوبر
09 أكتوبر
2 محدد
سياق الرسالة

Zhou Yu · مكتبة شياومان

معرض كتاب الخريف وبطاقات العضوية

آخر إرسال
06 أكتوبر · تم تسليم مسودة المقترح
الحالة
بانتظار رد العميل
«مسودة معرض كتاب الخريف وبطاقات العضوية جاهزة للمراجعة. بتأكيدكم هذا الأسبوع نتابع المرحلة التالية في موعدها.»
ثبّت Oil UI Pro لمسار التشخيص والتجديد الكامل من 3 خطوات
npx github:oil-oil/oil-cli install oil-ui-pro

لتجربة لوحات التوجهات الأساسية وإزالة النمطية على شاشة واحدة أولاً، نفّذ npx skills add oil-oil/oil-ui للـ Skill المجاني.

ثلاث خطوات لتجديد الواجهة: اختر نطاق التأثير المناسب

غالباً ما تتردد الفرق في السماح لوكيل برمجة بلمس شاشات الإنتاج لأن prompt مبهماً مثل «اجعل هذه الصفحة أجمل» قد يبعثر خصائص المكوّنات أو يحذف فلاتر عاملة. في Oil UI (وتحديداً في مسار المشاريع القائمة داخل Oil UI Pro)، تتبع عمليات التجديد ثلاث خطوات صريحة:

الخطوات الثلاث لتجديد المشاريع القائمة في Oil UI
الخطوةمتى تستخدمهاما الذي يتغيرما الذي يبقى دون مساس
الخطوة 1: ترتيب الضوضاء البصريةالمسار يعمل، لكن الحدود وأحجام الخطوط والتباعد والألوان تبدو مزدحمة أو قديمةسلم الخطوط، وتقليل الحدود، والمحاذاة، وانضباط الألوان، وتنظيف البطاقاتبنية DOM، والمسارات، وخطافات الحالة (state hooks)، وكل مسار تفاعل
الخطوة 2: ترقية التخطيط والحالاتالتسلسل البصري مسطّح، أو الإجراءات الرئيسية مدفونة، أو حالات التحميل/الفراغ/الخطأ مفقودةتسلسل الأقسام، ونسب الأعمدة المتعددة، ونقاط التجاوب، وحالات الواجهة الكاملةعقود API الخلفية، ومنطق العمل، والتنقل بين الصفحات
الخطوة 3: إعادة تصميم المسارات المرهقة واستخلاص DESIGN.mdينقر المستخدمون عبر نوافذ متراكمة أو شاشات متفرقة لإنجاز مهام أساسيةدمج الخطوات، والتحرير المباشر داخل السطر، وإعادة تصميم الشاشة الرئيسية، وملف DESIGN.md على مستوى المستودعنموذج المجال الأساسي وقواعد سلامة البيانات

أربع خطوات لتجديد تطبيق حي بأمان

سواء كنت تحدّث تطبيق مراجعة عقود (مثل MOQI في المعرض)، أو متعقّب سباقات عمل (Relay)، أو عميل بريد (Post)، أو مسار دفع (Pinch Checkout)، اتبع تسلسلاً مضبوطاً:

  1. التقط الشاشة الحالية وشغّل تشخيصاً مشروحاً

    اطلب من الوكيل تصوير الصفحة المشغّلة أولاً وسرد العيوب البصرية والتفاعلية مرقّمة (مثلاً: ثلاثة أزرار بلون أساسي تتنافس في الترويسة، أو جدول من 12 عموداً ينقطع عند 1280px، أو نوافذ تنبيه خام عند الخطأ).

  2. جدّد شاشة رئيسية واحدة أولاً

    لا تلمس عشرين مساراً دفعة واحدة. اختر الشاشة الواحدة التي يقضي فيها المستخدمون أطول وقت، وقارن 2 إلى 3 توجهات تجديد ببيانات حقيقية، وثبّت الفائز.

  3. تتبّع مهمة المستخدم كاملة واحصِ النقرات

    انقر واكتب عبر المسار الحقيقي في المتصفح — الترشيح، والإرسال، وإطلاق خطأ تحقق، والتعافي منه. تأكّد أن المهام عالية التكرار تستغرق خطوات أقل من ذي قبل.

  4. استخلص DESIGN.md وعمّمه على الصفحات الشقيقة

    بمجرد أن تجتاز الشاشة الرئيسية المراجعة البصرية، اطلب من الوكيل كتابة لوحة الأسطح، وسلم الخطوط، وكثافة الجداول، وقواعد إزالة النمطية في DESIGN.md، ثم طبّق تلك المواصفة على بقية التطبيق.

قالب prompt لتجديد شاشة قائمة

استخدم هذه البنية في Claude Code أو Codex أو Cursor لترقية عرض حي مع حماية منطق تطبيقك:

قالب prompt لتجديد واجهة مشروع قائم
استخدم Oil UI لتجديد [المسار أو ملف المكوّن، مثلاً: app/billing/page.tsx] في هذا المشروع.
- السلوك الواجب الحفاظ عليه بصرامة: أبقِ جميع [استعلامات البيانات ومعاملات فلاتر URL وقواعد التحقق من النماذج ومعالجات الإرسال/التصدير] الحالية سليمة. لا تحذف أي حقل من حقول المجال.
- المشكلات الحالية المطلوب إصلاحها: [مثلاً: كل قسم يبدو كبطاقة متطابقة بحدود؛ أعمدة الجدول تلتف بشكل مشوه؛ حالات التصفية الفارغة والدفع المتعثر مفقودة].
- خطوة التجديد: [اختر: الخطوة 1 ترتيب الضوضاء / الخطوة 2 ترقية التخطيط والحالات / الخطوة 3 إعادة تصميم المسار واستخلاص DESIGN.md].
ابدأ بالتقاط الشاشة الحية الحالية وتشخيصها، ثم اقترح توجهات، وتحقّق من الصفحة النهائية بدقة 1440×900 و390×844.

ذكر السلوكيات المحفوظة في النقطة الأولى يمنع التراجعات العرضية.

أمثلة حية و prompts من المعرض

تصفح المجموعة →
Oil UI Pro

جدّد تطبيقات الإنتاج الحية بأمان مع Oil UI Pro

غالباً ما تكسر prompts إعادة التصميم المبهمة الفلاتر العاملة ومعالجات النماذج. يشخّص Oil UI Pro شاشتك الحية من اللقطات أولاً، ويجدّد في ثلاث خطوات مضبوطة، ويحصي النقرات عبر المهمة الحقيقية، ويستخلص ملف DESIGN.md على مستوى المستودع ($19.99 دفعة واحدة).

استكشف Oil UI Pro →
نسخ أمر تثبيت Pro
npx github:oil-oil/oil-cli install oil-ui-pro

الأسئلة الشائعة

هل أحدّد tokens الـ CSS العامة أولاً أم أجدّد شاشة حقيقية واحدة أولاً؟

جدّد شاشة تمثيلية واحدة أولاً. نادراً ما تصمد ملفات الـ tokens المجردة المكتوبة في فراغ عند الاحتكاك بكثافة الجداول وحالات النماذج الحقيقية. إتقان شاشة رئيسية واحدة ببيانات حقيقية يجعل استخلاص tokens دقيقة إلى DESIGN.md أمراً مباشراً.

هل يمكنني تجديد تطبيق قديم تدريجياً دون إعادة كتابة ودجات الطرف الثالث؟

نعم. يمكن لتمريرة من الخطوة 1 أو الخطوة 2 إعادة تنظيم شبكة الصفحة والطباعة والتباعد والحالات المحيطة مع ترك الودجات المدمجة المعقدة دون مساس حتى تكون مستعداً لاستبدالها.

كيف أتحقّق أن إعادة التصميم حسّنت سهولة الاستخدام فعلاً؟

تحقّق من أمرين: أولاً، شوّش النص بصرياً للتأكّد من بروز الإجراء الأساسي وحالات الاستثناء بنيوياً؛ ثانياً، أكمل مهمة المستخدم الرئيسية في المتصفح وتحقّق أن عدد النقرات والبحث بالتمرير والتعافي من الأخطاء أسرع مما كان.

أين يُحفظ DESIGN.md بعد استخلاصه؟

احتفظ بـ DESIGN.md في جذر المستودع أو مجلد docs/. ومتى بنيت أنت أو أحد زملائك ميزة جديدة في Claude Code أو Codex أو Cursor، وجّه الوكيل إلى DESIGN.md حتى تتطابق الشاشات الجديدة مع النظام المعتمد.

أدلة ذات صلة

دليل واجهات Cursor و Windsurf ↗معالجة نمطية واجهات الذكاء الاصطناعي ↗المراجعة العمياء للشاشات الحقيقية ↗