BLOG / introducing-sku-md-v0-8.mdx
مقدمة إلى مسودة SKU.md v0.8
نظرة عملية على طبقة سياق المنتج التي يتحكم فيها التاجر، وعائلة مستنداتها، وحدود الثقة.
تاريخ النشر
إصدار المواصفة الأصلي: v0.8
طبقة سياق يتحكم فيها التاجر
تتوزع معلومات التجارة بين صفحات المتجر والبيانات المنظمة وموجزات المنتجات وخرائط الموقع والسياسات وواجهات API الآنية. يوفر SKU.md للناشر نقطة دخول واحدة بصيغة Markdown توضّح مواضع تلك المصادر وما يُعد كل منها مرجعًا معتمدًا له.
لا يحل محل Product JSON-LD أو موجزات التاجر أو MCP أو UCP أو واجهات API الخاصة بـ Checkout، بل يربط تلك الواجهات كي يكتشفها المستهلك الآلي بلا تخمين.
ما تنظمه مسودة v0.8
تفصل المسودة ملف catalog_manifest الجذري عن فهارس التقسيم ووثائق المنتج الاختيارية. يتيح الحد الأدنى من ملف Profile، وهو manifest-basic، نشر الهوية واللغة والمعرفة ونقاط دخول Catalog من دون ادعاء توفير قدرات تجارية آنية.
يمكن لوثائق المنتج إضافة حقائق موثقة المصدر ولقطة لحالة العرض. وتظل الحقائق التي قد تتغير وقت اتخاذ القرار بحاجة إلى تحقق آني.
يصرح التاجر بالحقائق ويقرر المستهلك
يستطيع الناشر ذكر ما يعرفه ومصدر الحقيقة ووقت التحقق منها. ويقرر المستهلك ما إذا كانت الأدلة كافية لمهمته. لا يمنح SKU.md إذنًا، ولا يضمن حداثة البيانات، ولا يرفع ترتيب التاجر، ولا يجعل Checkout آمنًا بمفرده.
ابدأ بأصغر وثيقة صادقة
ابدأ بـ manifest-basic، واربط واجهات Catalog القائمة، وأبقِ الادعاءات المتغيرة خارج النص الثابت. لا تضف مستندات أغنى إلا عند وجود مواد مصدرية حقيقية وحاجة واضحة لدى المستهلك.
قراءة إضافية
راجع التعريف الحالي وحدوده في ما هو SKU.md؟