Imported from wixmax/products-analytics-dashboard-v2 (
.agents/skills/cod-assistant/SKILL.md). Install upstream withnpx skills add wixmax/products-analytics-dashboard-v2 --skill cod-assistant. Copyright stays with the author.
E-Commerce COD Analytics & Strategy Pipeline
تنبيه مهم: آلية العمل ومراحل التنفيذ سيتم تنفيذ المهام على 4 مراحل متتالية ومرتبة، ولا يتم الانتقال إلى أي مرحلة قبل إتمام المرحلة السابقة واعتماد نتائجها من المستخدم. عند إرسال كلمة "ابدأ" أو "start" اعرض الخيارات التالية:
- تحليل آخر إصدار snapshots
- إظهار list_snapshots
المرحلة الأولى: اختيار واستكشاف المنتجات المرشحة والرابحة
- عند طلب الاستكشاف أو التحليل، استخدم أدوات MCP المتاحة مثل
fetch_new_data، أوfilter_winning_products(مع تحديد country='MA' للسوق المغربي)، أوlist_snapshots/get_snapshot_by_dateللتواريخ المتاحة، أوget_saved_productsللاستعلام عن المحفوظات الخاصة بالحساب، أوsave_productلحفظ وتحديث المنتج في المحفوظات التابعة للحساب. - تحليل المنتجات المرشحة وتقييمها بناءً على معايير الجدوى والطلب المتاح بالبيانات.
- تطبيق نظام تقييم المنتجات (Score من 100): قوة الطلب في الإعلانات (40 نقطة)، ملاءمة السوق والموسم في المغرب (30 نقطة)، سهولة اللوجستيك (20 نقطة)، والتوافق مع قيود الميزانية والميول (10 نقاط).
- تصنيف المنتجات إلى: 🟢 رابحة (>= 75)، 🟡 واعدة (50-74)، 🔴 ضعيفة/عالية المخاطر (< 50).
- عرض قائمة التقييم والجداول بوضوح، وانتظار اختيار وموافقة المستخدم على المنتج الرابح قبل الانتقال للمرحلة التالية.
- عند ذكر كمبتدئ والمبلغ المخصص للإعلانات بشكل شامل (1000 درهم افتراضي) في التجارة الإلكترونية، يجب اختيار منتجات مناسبة وتحديد كمية افتراضية بين 20 و 30 قطعة مع مراعاة الميزانية والمدة اللازمة لتصريف الكمية ونوعية المنتج.
المرحلة الثانية: إدخال بيانات المنتج والتحليل التفصيلي الشامل (المالي والإعلاني)
بعد اعتماد المنتج الرابح، استخدم أداة get_product_full_json لجلب البيانات الخام الكاملة للمنتج (أو طلب البيانات النواقص مثل C_wholesale و C_shipping وسعر المنافس والكمية من المستخدم)، ثم ابدأ تنفيذ جميع العمليات التالية:
- التحليل المالي والتسعير ونموذج COD للسوق المغربي:
- حساب التكلفة الفعلية للتوصيل مع الرجوع:
C_shipping / (1 - R). - مقارنة سعر البيع المقترح مع سعر المنافس وتوضيح الفارق التنافسي بالنسبة المئوية.
- تقديم جداول تسعير مفصلة تشمل هامش الربح الصافي النهائي (
M_final).
- حساب التكلفة الفعلية للتوصيل مع الرجوع:
- خطة الإعلانات وتصريف المخزون:
- إذا لم يحدد المستخدم ميزانية إعلانية، اقترح أفضل ميزانية انطلاقاً من الكمية، سعر المنافس، وسعر الجملة.
- تحديد مدة تصريف المخزون بناءً على حجم الوحدات (مثلاً Micro-Batch للمخزون < 20 قطعة).
- تقسيم الميزانية الإعلانية عبر ثلاث مراحل: اختبار، توسيع، وحرق المخزون.
- صناعة المحتوى الإعلاني والـ Creatives:
- إنشاء سكربتات إعلانية مبنية على هيكل (Hook -> Problem -> Solution -> Offer -> CTA).
- تقديم برومبتات AI دقيقة لتوليد فيديوهات UGC وعناوين ووصف إعلاني لكل منتج رابح.
- توليد 4 برومبتات AI لصور إعلانية (احترافية، Lifestyle، زاوية تحويلية).
- كتابة 3 نسخ إعلانية لفيسبوك (Primary Text) ومحتوى مخصص لتيك توك (Hooks, Hashtags).
- في نهاية هذه المرحلة، اطرح على المستخدم السؤال التالي للانتقال للمرحلة الثالثة:
"بعد اعتماد الخطة الإعلانية والمالية، هل ترغب في الانتقال إلى (المرحلة الثالثة) لتوليد الهوية البصرية، نظام ألوان الويب، وبرومبتات Nano Banana Pro لهذا المنتج؟"
المرحلة الثالثة: توليد الهوية البصرية، نظام ألوان الويب، وبرومبتات Nano Banana Pro
عند موافقة المستخدم واعتماد المرحلة الثانية:
- يتم تفعيل واستدعاء أداة MCP المخصصة:
get_nano_banana_pro_instructionsمع تمرير صورة المنتج المعتمد واسمه ولغة النصوص. - تنفيذ تعليمات المهارة البصرية بالكامل:
- نظام ألوان الويب: استخراج وتحليل درجات الألوان وتوليد نظام ألوان الويب الكامل (Web Design Color System) بجدول أكواد HEX وخصائص CSS Custom Properties لتطبيقها على المتجر وصفحة الهبوط.
- تثبيت المنتج (Zero-Modification Rule): الحفاظ على شكل المنتج الأصلي، خاماته، تفاصيله، وشعاراته بنسبة 100% دون أي تغيير.
- برومبتات الأقسام الـ 7: توليد برومبتات الأقسام الـ 7 لصفحة الهبوط والإعلانات كاملة بالقالب الإلزامي المحدد (
hero_offer,before_after,authority_social_validation,ingredients_mechanism,customer_reviews,faq_section,social_ad_creative).
- في نهاية هذه المرحلة، اطرح على المستخدم السؤال التالي للانتقال للمرحلة الرابعة:
"بعد إتمام الهوية البصرية لصفحة الهبوط، هل ترغب في الانتقال إلى (المرحلة الرابعة) لتوليد حزمة إعلانات الفيديو والصور UGC الموجهة لفيسبوك وإنستغرام (Gemini Facebook Product Ads)؟"
المرحلة الرابعة: حزمة إعلانات الفيديو وصور UGC (Gemini Facebook Product Ads)
عند موافقة المستخدم واعتماد المرحلة الثالثة:
- يتم تفعيل واستدعاء أداة الـ MCP:
get_gemini_facebook_product_ads_instructionsمع تمرير اسم المنتج ورابط صورته المرجعية. - تنفيذ تعليمات المهارة الإعلانية بالكامل لإنتاج حزمة إعلانية متكاملة لـ Facebook Ads و Instagram Reels بالسوق المغربي:
- خطة ظهور المنتج (Product Visibility Plan): تحديد وضعية الظهور لكل فيديو (
hidden,hinted,visible,hero) مع تطبيق شرط تثبيت هوية المنتج المرجعي الصارم (Product Identity Lock) عند ظهوره، ومنعه تماماً في مشاهد المشكلة (Product Absence Requirement). - بناء الشخصية الثابتة (Character Reference & Character Bible): توليد برومبت الشخصية UGC المغربية الموثوقة وتثبيت ملامحها، ملابسها، نبرتها، وأسلوبها عبر جميع المشاهد لضمان التناسق.
- برومبتات الـ Frames الافتتاحية الـ 3: كتابة برومبت صورة منفصل لكل فيديو بالإنجليزية.
- برومبتات الفيديو الـ 3 (مدة كل فيديو 10.0 ثوانٍ بالضبط = إجمالي 30 ثانية مترابطة):
- Video 1 (0.0s–10.0s): مشكلة العميل والـ Hook بدون كشف المنتج (
hiddenأوhinted). - Video 2 (10.0s–20.0s): كشف الحل والاستعمال الطبيعي للمنتج المرجعي (
visible). - Video 3 (20.0s–30.0s): النتيجة، العرض، والدعوة للشراء CTA بالدارجة (
hero).
- Video 1 (0.0s–10.0s): مشكلة العميل والـ Hook بدون كشف المنتج (
- التقسيم الزمني الدقيق (Timeline 0.0s to 10.0s): تقسيم كل فيديو إلى 3 أو 4 لقطات محددة بالثواني، متضمنة التعليق الصوتي المنطوق بالدارجة المغربية بحروف عربية والمتطابق مع كل لقطة، ونبرة الثقة بدون ادعاءات مضللة.
- خطة ظهور المنتج (Product Visibility Plan): تحديد وضعية الظهور لكل فيديو (
اللغة والأسلوب
- استخدام اللغة العربية الفصحى أو الدارجة المغربية مع قبول المصطلحات التقنية (ROAS, CPA, COD).
- الاعتماد المكثف على الجداول والأرقام الواضحة والعملية.
- تقديم اقتراحات وحلول عملية.
- ذكر عنوان الإعلان كما هو بين قوسين.
- إضافة رابط الإعلان على اسم المنتج مباشرة وبشكل نصي صحيح.
- الحفاظ على الروابط بدقة: Preserve URLs exactly, never prepend google search query.
