SKU.md v0.10 × UCP: معرفة منتج قابلة للتحقق للتجارة الآنية

قد يجد الوكيل سترة تبدو مناسبة، لكن تبقى أسئلة الشراء: هل القماش مقاوم للماء أم طارد له، وعلى أي قياسات للجسم يستند المقاس، وهل للطلاء قيود خاصة بالعناية، وهل تدعم نتيجة اختبار ادعاء المتانة؟ يجب أن تكون الإجابة دقيقة من دون اعتبار نص تسويقي قديم مصدرًا لمخزون اليوم أو سعره أو مجموع Checkout.

هنا يقع الحد. يوفر UCP مسارًا آنيًا من اكتشاف المنتج واختيار Variant إلى Cart وCheckout وOrder. ويستطيع SKU.md توفير معرفة يستضيفها التاجر وقابلة للاستشهاد، تشرح ماهية المنتج وأساس الادعاء ومصدر القيد. ولا يكمل أحدهما الآخر إلا عندما تظل سلطة كل منهما منفصلة بوضوح.

ابدأ بسؤال الشراء لا بتنسيق الملف

يتضمن سؤال «هل يناسبني؟» قرارات عدة: هل يباع المنتج في السوق المطلوبة، وأي Variant يطابق اللون والمقاس، وما السعر الحالي، وهل تلبي الخامة المتطلبات، وهل الادعاء حقيقة يقررها التاجر أم نتيجة اختبار من طرف ثالث أم استنتاجًا بالذكاء الاصطناعي، وهل يمكن الشراء فعلًا بالمبلغ المعروض؟

يتولى UCP الجزء المتغير. تعرّف مواصفة UCP Catalog عمليتي Catalog Search وCatalog Lookup ونوعي Product وVariant بمعلومات التجارة الحالية. وتضع نظرة UCP العامة عناصر Catalog وCart وCheckout وOrder في مسار آني واحد. يساعد Catalog على الاكتشاف والتأكيد، بينما يعيد Checkout فحص الشروط الملزمة وينفذ المعاملة.

يُستخدم ملف Profile للوكيل لإعلان القدرات والتفاوض عليها. وهو ليس محتوى منتج ولا بيانات اعتماد ولا إجراء مصادقة كاملًا. قد يستخدم UCP مفاتيح التوقيع المنشورة في Profile لإثبات الهوية، لكن مستند Profile وحده لا يصادق على طلب ولا يفوض عملية شراء. تعتمد المصادقة والتفويض والموافقة والتنفيذ على البروتوكول ووسيلة النقل وبيانات الاعتماد وسياق المستخدم التي جرى التفاوض عليها.

طبقتان وخريطة سلطة واحدة

يمكن تلخيص الأدوار هكذا:

القرار	UCP والتجارة الآنية	SKU.md v0.10
الاكتشاف والهوية	تعيد عمليتا البحث والاستعلام عناصر Product وVariant والسعر والتوافر والمعرفات الحالية.	يربط Product وVariant المطابقين بدقة بمستند المعرفة.
فهم المنتج	يعيد Catalog الوصف والصور والخيارات والإفصاحات الحالية.	ينشر الحقائق والادعاءات والأدلة والإرشادات والقيود والتوافق ووقت التحقق.
الحالة المتغيرة	يعاد استعلام Catalog للحصول على السعر والتوافر الحاليين.	لا يقدم المستند الثابت حالة قديمة باعتبارها حالية.
المعاملة	تجمع Cart المنتجات وتقدم تقديرًا، ويؤكد Checkout الحالة الملزمة والمبلغ النهائي وتفويض الشراء.	يشير إلى مسار التجارة صاحب السلطة ولا يستبدله.

يوضح هذا التقسيم قيمة SKU.md: يحافظ التاجر على شرح طويل الأجل قابل للتدقيق والاستشهاد، بينما يجيب UCP عن الأسئلة التي تتغير حسب السوق والجلسة والمخزون والأهلية وشروط Checkout.

قدرة Cart في UCP مخصصة للجمع والتقدير قبل الشراء، أما المعاملة النهائية فهي من اختصاص Checkout. ويصف دليل Shopify لـ Checkout MCP Checkout بأنه جلسة شراء تبدأ بعد استعداد المستخدم. يشير SKU.md إلى المسار النهائي ولا يسجل تقدير Cart بوصفه التزامًا.

ويعمل الحد في الاتجاه الآخر أيضًا: لا يجوز وضع إفصاح أمني أو قانوني يؤثر في الشراء داخل SKU.md وحده. إذا غيّر التحذير القرار فيجب أن يظهر في Catalog أو Checkout بحسب السياق. يضيف SKU.md الخلفية والأدلة، لكنه ليس المكان الوحيد لعرض شرط جوهري.

لماذا تضع v0.10 المعرفة أولًا

تسمح v0.10 بنشر مستند Product للمعرفة فقط. فإذا استقرت هوية Product وVariant ولم تكن المعرفة فارغة، أمكن نشر مستند صالح من دون عرض. وهكذا يقدم تاجر متصل بـ UCP معرفة قابلة للاستشهاد من دون تكرار Catalog الآني.

يبقى العرض الاحتياطي الذي يستضيفه التاجر متاحًا لمن لا يملك Catalog آنيًا. قد يحتوي Variant على offer_snapshot أو live_offer، وهما اختياريان ومتعارضان ولا يكتسبان سلطة Catalog أو Checkout. الأول ملاحظة سابقة والثاني استعلام آني معلن. وعند توفر استجابة حالية من UCP لا يمثل أي منهما سعر اليوم أو المجموع النهائي.

تُطابق الهوية بدقة لا بالتشابه. يجب أن تتطابق معرفات Product وVariant وSKU وGTIN المعلنة مع ما أعاده UCP. وعند أي اختلاف يتوقف الاستخدام بدل إسناد شرح مقنع إلى Variant آخر. تحدد المواصفة الإنجليزية وJSON Schema الحد المعياري.

جسر ضيق إلى UCP Catalog

يعمل SKU.md مستقلًا على الويب المفتوح، لكن لا ينبغي للوكيل تخمين الربط بين Product ومستند المعرفة. يعرّف الاقتراح الامتداد المستقل md.sku.shopping.product_knowledge للقدرتين dev.ucp.shopping.catalog.search وdev.ucp.shopping.catalog.lookup، ويعيد رابطًا محدد النوع بدل تضمين مستند Markdown كامل.

{
  "sku_md": {
    "documents": [
      {
        "url": "https://merchant.example/products/trail-jacket.sku.md",
        "schema_version": "sku.md/0.10-draft",
        "content_language": "en-US",
        "market": { "country": "US", "currency": "USD" },
        "revision": "2026-08-02"
      }
    ]
  }
}

يتضمن المؤشر عنوان HTTPS وإصدار Schema ولغة المحتوى والبلد والعملة ومراجعة اختيارية. ويعلن ملف Profile التجاري أصول HTTPS المسموحة. لا يقرأ المستهلك المؤشر إلا إذا تفاوض ملف Profile للمنصة وملف Profile التجاري على الامتداد نفسه وكانت قدرة Catalog الأصلية متوافقة.

يقيد الأصل المسموح وجهة الرابط، لكنه لا يثبت أصالة المحتوى أو حداثته أو سلامته أو التفويض باستخدامه. يعامل Reference Consumer المستند بوصفه بيانات خارجية غير موثوق بها، ويفحص HTTPS والأصل ونوع الوسائط وحد البايتات وعدد المستندات وهوية المنتج. Markdown وHTML وبيانات YAML الأمامية والروابط والتعليمات المكتوبة بلغة طبيعية كلها بيانات؛ ولا يجوز تنفيذ أي برنامج نصي أو أداة أو أمر في سطر الأوامر أو قالب أو تعليمات شبيهة بالأوامر الموجهة للنموذج منها.

يمنع الرابط المحدود تكرار المحتوى. يعيد UCP Catalog عناصر Product وVariant والوسائط والخيارات والسعر والتوافر الحاليين؛ ولو نسخ الامتداد المعرفة كاملة لنشأت نسختان يصعب إبقاؤهما متزامنتين. يحافظ المؤشر على فصل الأدوار ويجلب الأدلة عند الحاجة.

يمكن أن يحمل الرابط اللغة والسوق والمراجعة، فيدعم الإفصاحات الخاصة بكل سوق وسجلًا قابلًا للتتبع. يستطيع وكيل لم يتفاوض على الامتداد تجاهل sku_md.documents، ويستطيع مستهلك SKU.md من دون UCP اكتشاف المستند من صفحة المنتج أو /sku.md.

لذلك فالامتداد جسر اختياري لا نقطة دخول إلزامية. لا يضيف دلالات للمعاملات إلى UCP، ولا يحول Catalog الآني إلى Markdown، بل يتيح اكتشاف معرفة محدودة؛ ويبقى الاستشهاد والعرض وإعادة التحقق من مسؤولية المستهلك وقواعد UCP.

تُنشر المسودة المحلية في /ucp/draft/ مع مخطط الامتداد. يدل المسار على أنها مسودة، ويستخدم Profile الإصدار 2026-08-02. لا يعني التاريخ الاستقرار أو التصديق أو دعم Shopify؛ ويتطلب النضج تنفيذات مستقلة من الطرفين ومراجعة أمنية وأدلة على التشغيل البيني.

مسار التشغيل حلقة لا عملية تسليم واحدة

يستخدم الوكيل الحذر الطبقتين بهذا الترتيب:

1. يعثر UCP على Product الحالي عبر Catalog Search أو عملية استعلام.
2. يطابق Product وVariant وSKU وGTIN بدقة.
3. يقرأ الحقائق والأدلة والتوافق والقيود من مستند SKU.md المشار إليه.
4. يعود إلى UCP للحصول على السعر والتوافر الحاليين لسوق المستخدم.
5. يعيد Checkout تأكيد المنتج ويحافظ على سلطة المبلغ النهائي وتفويض الشراء.

الخطوة الرابعة حاسمة: يجيب مستند المعرفة الغني بالمراجع عن سؤال «لماذا يناسب؟»، لكنه لا يلغي التحقق الآني من الحالة التجارية. وعند غياب مصدر آني تكون الإجابة «غير معروف»، لا سعرًا مستخرجًا من نص قديم.

ممارسة تاجر Shopify

قد تأتي المسودة من Metafields وMetaobjects وأدلة المنتج ونتائج الاختبار وإرشادات العناية والضمان والأدلة العامة. التخزين وحده لا يجعلها صحيحة؛ يجب أن يراجع إنسان Product وVariant والسوق والأدلة والمراجعة قبل نشر حقيقة معيارية.

يمكن لنص يولده الذكاء الاصطناعي أن يساعد في اكتشاف الحقول الناقصة أو كتابة ملخص، لكنه يبقى مادة مرشحة حتى يقارنه إنسان بالدليل. ويحفظ الناشر المصدر ووقت التحقق وسبب قبول الادعاء. تكمن قيمة SKU.md في المسار من الادعاء إلى الدليل، لا في طول النص.

تشرح ملفات Profile للوكلاء في Shopify التفاوض على Profile، ويشرح دليل Shopify Catalog البحث والقراءة، ويشرح امتداد Catalog العام امتداد Shopify. هذه واجهات قدرات خاصة بـ Shopify، ولا تقول إن Shopify يقرأ SKU.md تلقائيًا أو يدعم الامتداد.

ما يقيسه Reference Consumer محلي

يستخدم التقييم بيانات ثابتة وقدرات متفاوضًا عليها وبيانات المورد الوصفية ونص المستند. وهو يقيس إجابة مدعومة بأدلة وحدود واضحة، لا ترتيبًا أو معدل تحويل.

السؤال	UCP فقط	UCP + SKU.md
الاستشهاد بحقيقة	0	1
اعتبار ادعاء حقيقة على نحو خاطئ	0	0
استرجاع إفصاح	0	1
إجابة عن التوافق	0	1
الفشل الآمن عند اختلاف Variant	1	1
استخدام عرض قديم للشراء	0	0

هذه نتيجة محلية مضبوطة لا تثبت تحسن الترتيب أو التحويل أو الاعتماد أو وجود تكامل حقيقي مع Shopify. توجد بيانات الاختبار والحدود في تقييم Reference Consumer.

ترقية بلا ادعاء اكتمال المسودة

تظل عناوين URL وسلوك v0.9 صالحين للاستخدام. يستطيع التاجر إعداد v0.10 مع إبقاء v0.9، وتغيير علامة Schema، والحفاظ على الهوية والمعرفة المستقرتين، وإخراج بيانات التجارة المتغيرة. يشرح دليل الترحيل من v0.9 حذف العرض أو الاحتفاظ بخيار احتياطي اختياري من دون تقمص دور Catalog أو Checkout.

الخطوة التالية ليست تسمية الامتداد معيارًا، بل اختبار تركيب Schema وسلوك الفشل في تنفيذات مستقلة، ومراجعة السلامة والخصوصية، وجمع الملاحظات. حتى ذلك الحين يظل SKU.md v0.10 طبقة معرفة تجريبية يستضيفها التاجر، ويتولى UCP الاكتشاف والحالة والقرار النهائي آنيًا.

قراءة إضافية

تابع إلى شرح تسليم السلطة من المعرفة إلى Catalog الحي وCheckout