أمثلة على المهام متعددة الخطوات
التعامل مع المهام المعقدة متعددة الخطوات باستخدام Verdent
يتميز Verdent for VS Code بتفكيك المهام المعقدة متعددة الخطوات بشكل مستقل. يقدم هذا الدليل سير عمل خطوة بخطوة للسيناريوهات الشائعة متعددة الخطوات، ويوضح بدقة كيف يتعامل Verdent مع تفكيك المهام، وإدارة التبعيات، والتنفيذ التدريجي.
استخدام Plan Mode للتنفيذات المعقدة
لنفترض أنك تريد مراجعة خطة تفصيلية قبل أن يجري Verdent أي تغييرات على قاعدة الكود الخاصة بك.
التبديل إلى Plan Mode
حدد زر "Switch Mode" في الواجهة، ثم اختر "Plan Mode".
وضع Plan Mode للقراءة فقط: يمكن لـ Verdent تحليل الكود وإجراء البحث وإنشاء الخطط دون تعديل الملفات أو تنفيذ الأوامر.
أرسل طلبك المعقد
Refactor this codebase to replace our custom authentication with OAuth 2.0يقوم Verdent بتحليل تنفيذك الحالي بشكل شامل.
أجب عن الأسئلة التوضيحية
قد يطرح Verdent أسئلة لإزالة الغموض:
- أي مزود OAuth ينبغي أن نستخدمه؟
- هل يجب تخزين الرموز (tokens) في localStorage أم في ملفات تعريف الارتباط (cookies)؟
- هل نحتاج إلى دعم عدة مزودي OAuth؟
أجب عن هذه الأسئلة لتحسين الخطة.
راجع الخطة التفصيلية
يعرض Verdent خطة شاملة تُظهر:
- الملفات المطلوب إنشاؤها
- الملفات الحالية المطلوب تعديلها
- خطوات التنفيذ بترتيب منطقي
- التبعيات بين الخطوات
راجع هذه الخطة بعناية قبل المتابعة.
اختر إجراءك التالي
بعد مراجعة الخطة، يعرض Verdent خيارين:
- اختر Edit لطلب تعديلات أو لطرح أسئلة توضيحية
- اختر Start Building للتبديل إلى Agent Mode وبدء التنفيذ
يمكنك إعادة صياغة الخطة عدة مرات بحسب الحاجة قبل البناء.
نصائح:
- استخدم Plan Mode للميزات التي تؤثر في ملفات متعددة
- أجرِ عدة جولات من مراجعة الخطة لتحسين الأسلوب المتبع
- احفظ الخطة في ملف لمناقشتها مع الفريق قبل التنفيذ
- يساعد Plan Mode على ضمان التوافق بين توقعاتك والحل المقترح من Verdent
- تخصيص تنسيق الخطة: انتقل إلى Settings → Rules → Plan Rules للتحكم في بنية الخطة ومستوى التفاصيل وتفضيلات التنسيق
تفكيك طلبات الميزات الكبيرة
لنفترض أنك تبني نظام دفع (checkout) معقدًا للتجارة الإلكترونية يتضمن عدة مكونات متكاملة.
قدّم الهدف العام
Build a complete checkout system with cart management, payment processing, order confirmation, and inventory updatesيحلل Verdent ما يجب القيام به.
ينشئ Verdent مهامًا فرعية منطقية
يفكك النظام هذا بشكل مستقل إلى:
- إنشاء نموذج بيانات عربة التسوق وAPI
- بناء واجهة عربة التسوق مع إمكانية إضافة/إزالة/تحديث العناصر
- تنفيذ صفحة الدفع مع نموذج عنوان الشحن
- دمج بوابة الدفع (Stripe أو المزود المُهيأ)
- إنشاء صفحة تأكيد الطلب
- إضافة منطق تحديث المخزون
- تنفيذ نظام تأكيد البريد الإلكتروني
- كتابة اختبارات التكامل
تُعرض كل مهمة فرعية في قائمة المهام مع وصف واضح.
يتعامل Verdent مع التبعيات تلقائيًا
ينفذ Verdent المهام الفرعية بالترتيب الصحيح:
- ينشئ نماذج البيانات قبل نقاط النهاية (endpoints) في API التي تستخدمها
- يبني نقاط النهاية الخلفية قبل مكونات الواجهة الأمامية التي تستدعيها
- ينفذ الميزات الأساسية قبل إضافة الاختبارات
تُدار التبعيات تلقائيًا دون تدخل يدوي.
راقب التقدم في الوقت الفعلي
تابع تحديث قائمة المهام في الوقت الفعلي بينما يعمل Verdent على كل مهمة فرعية. تتحول عناصر المهام من قيد الانتظار → قيد التنفيذ → مكتملة.
نصائح:
- اترك Verdent يتعامل مع التفكيك بشكل مستقل في معظم المهام
- استخدم Plan Mode إذا كنت تريد مراجعة التفكيك قبل التنفيذ
- يعدّل Verdent أسلوبه عند مواجهة حالات خاصة أو متطلبات جديدة
- توفر قائمة المهام المرئية شفافية في التنفيذ متعدد الخطوات
مشاريع إعادة الهيكلة متعددة المراحل
لنفترض أنك تعيد هيكلة قاعدة كود كبيرة وتريد التعامل معها على مراحل يمكن التحكم بها.
حدد نهج المراحل المتعددة
In Plan Mode: Refactor this codebase to replace our custom authentication with OAuth 2.0. I want this done in phases so we can test incrementally.يقترح Verdent تفكيكًا للمراحل
يقترح Verdent خطة متعددة المراحل:
- المرحلة 1: إضافة مكتبة OAuth وتهيئة نقاط النهاية
- المرحلة 2: تحديث نموذج المستخدم ومخطط قاعدة البيانات
- المرحلة 3: ترحيل منطق المصادقة الحالي
- المرحلة 4: إزالة كود المصادقة القديم
- المرحلة 5: تحديث الاختبارات والوثائق
يمكن اختبار كل مرحلة بشكل مستقل.
نفّذ مرحلة تلو الأخرى
اعتمد المرحلة 1، واسمح لـ Verdent بتنفيذها، ثم اختبر:
npm testبعد التحقق من عمل المرحلة 1 بشكل صحيح، انتقل إلى المرحلة 2.
عدّل المراحل التالية إذا لزم الأمر
بناءً على ما تتعلمه في المرحلة 1، يمكنك تعديل النهج للمراحل المتبقية:
For Phase 2, let's also add user role migration to the database schema changesأكمل جميع المراحل بشكل تدريجي
اعمل على جميع المراحل مع الاختبار والتحقق بين كل مرحلة وأخرى، لضمان السلامة والسماح بتصحيح المسار.
نصائح:
- تقلل إعادة الهيكلة متعددة المراحل من المخاطر من خلال السماح بالاختبار التدريجي
- يجب أن تترك كل مرحلة قاعدة الكود في حالة عمل سليمة
- نفّذ الحفظ (commit) بعد كل مرحلة لتسهيل التراجع عند الحاجة
- عدّل المراحل اللاحقة بناءً على ما تعلمته من المراحل السابقة
تنسيق التغييرات بين الخلفية والواجهة الأمامية
لنفترض أنك تضيف ميزة تتطلب تحديثات متزامنة لكل من API الخلفي ومكونات الواجهة الأمامية.
صف الميزة الكاملة (full-stack)
Add a commenting system where users can add comments to blog posts. Include backend API, database schema, and frontend UIينسّق Verdent نهجًا يبدأ من الخلفية
يعمل Verdent غالبًا بدءًا من الخلفية بالنسبة للميزات الكاملة (full-stack):
- إنشاء ترحيل (migration) لقاعدة البيانات لجدول التعليقات
- إضافة نقطة نهاية API لإنشاء التعليقات
- إضافة نقطة نهاية API لاسترجاع التعليقات
- تعريف واجهات TypeScript لبيانات التعليقات
- بناء مكون نموذج التعليقات في الواجهة الأمامية
- إنشاء مكون عرض التعليقات
- ربط الواجهة الأمامية بنقاط نهاية API
يضمن Verdent الاتساق
يضمن Verdent:
- تطابق واجهات TypeScript في الواجهة الأمامية مع بنى البيانات الخلفية
- الإشارة الصحيحة إلى عناوين URL لنقاط نهاية API في كود الواجهة الأمامية
- توافق تنسيقات الطلب/الاستجابة بين الخلفية والواجهة الأمامية
- اتساق معالجة الأخطاء عبر كامل النظام
اختبار التكامل
Write integration tests for the commenting system covering the full stackيُنشئ Verdent اختبارات تتحقق من أن الخلفية والواجهة الأمامية تعملان معًا بشكل صحيح.
نصائح:
- يضمن النهج القائم على الخلفية أولًا أن تحصل الواجهة الأمامية على API جاهزة للتكامل معها
- يحافظ Verdent على الاتساق بين كود الخلفية والواجهة الأمامية تلقائيًا
- تساعد واجهات TypeScript على اكتشاف مشكلات التكامل في وقت الترجمة (compile time)
- تتحقق اختبارات التكامل من أن الميزة الكاملة تعمل من طرف إلى طرف
استخدام الوكلاء الفرعيين للتنفيذ المتوازي
لنفترض أن لديك عدة مهام مستقلة يمكن تنفيذها في الوقت نفسه.
حدد المهام القابلة للتنفيذ المتوازي
Generate unit tests for all service classes in the src/services directoryملفات الاختبار هذه مستقلة ويمكن إنشاؤها بالتوازي.
يفوّض Verdent المهمة لعدة وكلاء فرعيين
يستخدم Verdent تلقائيًا عدة وكلاء فرعيين للعمل على المهام المستقلة بشكل متزامن:
- الوكيل الفرعي 1: ينشئ اختبارات لـ UserService
- الوكيل الفرعي 2: ينشئ اختبارات لـ PaymentService
- الوكيل الفرعي 3: ينشئ اختبارات لـ NotificationService
- الوكيل الفرعي 4: ينشئ اختبارات لـ AuthService
يتم كل العمل بالتوازي، مما يوفر الوقت.
يتم دمج النتائج
يُرجع كل وكيل فرعي نتائجه. يدمج Verdent جميع ملفات الاختبار في المشروع بتسمية وبنية مناسبتين.
التحقق التسلسلي
بعد الإنشاء المتوازي، شغّل الاختبارات بشكل تسلسلي للتحقق من أنها تعمل جميعًا:
npm testنصائح:
- يقوم Verdent تلقائيًا بتنفيذ المهام المستقلة بالتوازي باستخدام الوكلاء الفرعيين
- يستفيد العمل ذو الارتباط الضعيف (ملفات اختبار منفصلة، مكونات مستقلة) من التنفيذ المتوازي
- يتم تنفيذ العمل ذو الارتباط القوي (ملفات ذات تبعيات) بشكل تسلسلي لضمان الصحة
- يسرّع التنفيذ المتوازي بشكل كبير التغييرات على نطاق واسع
الأسئلة المتكررة
هل يمكنني إيقاف Verdent في منتصف مهمة متعددة الخطوات؟
نعم. يمكنك مقاطعة التنفيذ في أي وقت. سيُكمل Verdent الخطوة الحالية التي يعمل عليها، ثم يتوقف. يُحفظ التقدم المُحقق حتى تلك اللحظة. يمكنك مراجعة ما تم إنجازه، وإجراء التعديلات، ثم الاستمرار أو اتباع نهج مختلف.
كيف أعرف ما يقوم به Verdent حاليًا في مهمة طويلة؟
تابع قائمة المهام. تعرض حالة فورية مع عنصر واحد فقط موسوم بـ "قيد التنفيذ" في أي وقت. يُظهر العنصر النشط بدقة ما يعمل عليه Verdent حاليًا. تُوسم العناصر المكتملة بذلك، وتُظهر العناصر المعلقة ما تبقى.
ماذا لو لم أوافق على الطريقة التي فكك بها Verdent مهمتي؟
استخدم Plan Mode لمراجعة التفكيك وتعديله قبل التنفيذ. في Plan Mode، يمكنك تقديم ملاحظات مثل "قسّم عمل الواجهة الأمامية إلى مكونات منفصلة" أو "اجمع تلك الخطوتين". سيُعدّل Verdent الخطة بناءً على ملاحظاتك قبل كتابة أي كود.
هل يجب أن أستخدم Plan Mode لكل مهمة متعددة الخطوات؟
ليس بالضرورة. استخدم Plan Mode للميزات المعقدة التي تؤثر في ملفات كثيرة، أو عمليات إعادة الهيكلة الكبيرة، أو عندما تريد مراجعة النهج أولًا. بالنسبة للمهام المألوفة والمباشرة، يمكن لـ Verdent التنفيذ مباشرة مع رؤية مباشرة لقائمة المهام في الوقت الفعلي. يضيف Plan Mode خطوة مراجعة للتغييرات ذات المخاطر الأعلى.
هل يمكنني تعديل خطة Verdent بعد بدء التنفيذ؟
يمكنك تقديم توجيه تصحيحي أثناء عمل Verdent. قل "في الواقع، استخدم نهجًا مختلفًا لتكامل API" وسيقوم Verdent بتعديل الخطوات المتبقية. بالنسبة للتغييرات الكبيرة في الخطة، من الأفضل التوقف، وحفظ ما تم إنجازه، وبدء جلسة جديدة بالنهج المُعدّل.