Vercel научила AI-агентов понимать продуктовые решения, а не только копировать код

نشرت Vercel وصفًا مفصلاً لنظام product-design الخاص بها — مجموعة أدوات تساعد وكلاء الذكاء الاصطناعي ليس فقط على نسخ الأنماط والأساليب، بل على فهم لماذا أصبح مكون أو عبارة أو تفاعل معين هو المعيار في المنتج.

الوكلاء لا يفهمون "لماذا"

يتعامل وكلاء الترميز الحديثة مع المهام بسرعة: فهي تكتب واجهة مستخدم عاملة، وتنسخ الأنماط البصرية، وتكرر الأنماط من المستودع. المشكلة في مكان آخر — فهي لا تفهم الأسباب التي تقف خلف هذه القرارات. عادة ما يتم تخزين منطق مكون معين أو صيغة أو تفاعل في خيوط Slack وتعليقات review التصميم وملاحظات في العلاقات العامة وفي ذاكرة الأشخاص الذين كانوا في تلك الاجتماع. بالنسبة للوكيل، هذا السياق غير موجود: فهو يعمل فقط مع ما دخل قاعدة الكود. اقتربت Vercel من المشكلة بشكل جذري: جميع قرارات المنتج المقبولة تعيش الآن في المستودع جنبًا إلى جنب مع الكود. تخضع للمراجعة عند التغييرات وتتوفر تلقائيًا لأي وكيل يعمل على المشروع.

ما بداخل النظام

يتكون النظام من ثلاثة مكونات. تعيش المهارة في `.agents/skills/product-design/` بجانب الكود الذي تحكمه مباشرة. بداخلها قسمان رئيسيان. `references/` يحتوي على وثائق حول قرارات المنتج وجودة الواجهة والمرونة وكتابة النسخ ومسرد المصطلحات و`coverage-gaps.md` — قائمة بالمجالات التي لم تتشكل فيها المعايير بعد. `exemplars/` يوثق القرارات من علاقات عامة سابقة التي تستحق التكرار والأخطاء التي يجب تجنبها. تقوم Linters بفحص كل شيء يمكن التحقق منه آليًا تلقائيًا. يجب التحقق من كل شيء يمكن التحقق منه بدون مشاركة بشرية بدونها. دورة التحديث تجمع الإشارات من Slack و Figma و GitHub وتجميعها وتحضير تحديثات الإرشادات للموافقة النهائية من الفريق.

كيف تحول المهارة المهام

يعمل SKILL.md كموجه. أولاً يحدد وضع الطلب: shape أو implement أو review أو copy أو harden. هذا أساسي — لا يجب أن يتحول التدقيق إلى تحرير، ولا يجب أن تتسع مهمة كتابة النسخ إلى إعادة تصميم. تتخطى المهارة أيضًا المهام التي لا تؤثر بشكل مرئي على الواجهة: منطق backend فقط وقياس المسافات والملفات المُنشأة. بعد تحديد الوضع، توجه المهارة إلى المصادر المناسبة بناءً على نوع المهمة والسطح المحدد:

• التغييرات في مواد الواجهة تحمل `product-judgment.md` و`interface-quality.md`
• يؤدي العمل مع النص إلى `copy.md` والأشكال الفعلية الكنسية للمنتج
• نافذة نمطية — أنماط للإجراءات المدمرة والأفعال الكنسية
• نموذج الإعدادات — التسميات والتحقق من الصحة والكشف التدريجي وإرشادات accessible-name

لا تكرر المهارة المصادر: يبقى Component API وقواعد نظام التصميم ومعايير الوصولية مع مالكيها — تشير المهارة فقط إليها.

"يوضح الكود للوكلاء ما تم إطلاقه — لكن ليس لماذا أصبح هذا المكون أو التفاعل المعين هو المعيار،" — من توثيق

Vercel.

ما يعنيه هذا

أظهرت Vercel منهجية ملموسة لتوسيع معرفة المنتج في الفرق التي تضم وكلاء الذكاء الاصطناعي. بدلاً من الاعتماد على أن يخمن الوكيل نوايا المصممين والمديرين، قامت الشركة بترميز نواياهم وجعلها جزءًا من المستودع — مع سجل التغييرات والمراجعة والفحوصات التلقائية. وفقًا للمؤلفين، يمكن لأي فريق بناء نفس البنية حول معاييرهم الخاصة.