Install
npx skills add vercel-labs/vgpuلمن يناسب
vgpu موجّه لمن يكتب WebGPU بـ TypeScript: استيراد مظلّلات بأنواع، وواجهة برمجية صغيرة مائلة إلى GPU، ونفس الشيفرة يمكن أن تعمل في المتصفح وNode بلا واجهة والاختبارات. يقول المستودع أيضًا: مساعد يدعم المهارات يمكنه تثبيت مسار توثيق رقيق جدًا يستعلم الوثائق المرفقة مع «إصدار vgpu المثبّت أصلًا في المشروع الحالي».
الاستخدام الأقرب: لديك أو ستحصل على مشروع TypeScript. ثبّت الحزمة أولًا عبر Quick Start، ثم دع المساعد يستعلم الوثائق فقط، أو استخدم CLI للتحقق للقراءة فقط. ليست دليل API مستقلًا بلا إصدار — المهارة نفسها لا تتضمن مرجع API مرقمًا.
لا تدمج المدخلين في مسار واحد. اعتماديات المشروع تمر بـ pnpm add vgpu. مهارة المساعد تمر بـ npx skills add vercel-labs/vgpu. في بيئة بلا دعم للمهارات لا تطبّق الأمر الثاني.
أول محاولة في 3 دقائق
إن كان المساعد الحالي يدعم المهارات فالأمر الرسمي هو npx skills add vercel-labs/vgpu. عنوان المستودع هو https://github.com/vercel-labs/vgpu اتبع هذه الصفحة وحدها. تثبّت المهارة في دليل مهارات المساعد؛ ولا تحل محل اعتمادية المشروع.
الشروط المسبقة: يُفضَّل أن يكون vgpu مثبتًا في المشروع لأن المهارة تستعلم الوثائق المرفقة بذلك الإصدار. إن لم توجد الحزمة بعد فنفّذ Quick Start أولًا في مشروع يمكن التخلص منه: pnpm add vgpu و pnpm add -D @webgpu/types. لا تخترع مثبّتًا غير موثّق.
مهمة أولى منخفضة المخاطر: لا تبدأ بكتابة مشهد رسمي يرسل عملًا إلى GPU. بعد تثبيت الحزمة نفّذ npx vgpu check للتحقق من المظلّلات، أو npx vgpu docs لفتح الوثائق للقراءة فقط. علامة النجاح: تنتهي CLI وتعطي نتيجة تحقق أو وثائق، لا أن شيفرة عملك أُعيدت كتابتها. npx vgpu examples يدخل معرض الأمثلة؛ في المرة الأولى انظر فقط ولا تغيّر.
إن سلكت مسار المهارة: بعد التثبيت اطرح على المساعد سؤالًا للقراءة فقط عن استخدام vgpu في هذا المشروع. علامة النجاح: الجواب يطابق الحزمة التي ثبّتها للتو، لا دليلًا عامًا بلا صلة بالمشروع. الشرح لا يكتب اسم أمر بشرطة مائلة للمهارة؛ يكفي سؤال بلغة طبيعية.
حالات الاستخدام
الحالة 1: تثبيت مسار التوثيق لمساعد يدعم المهارات. الأمر هو npx skills add vercel-labs/vgpu. المهارة رقيقة بلا مرجع API مرقم، وتستعلم الوثائق التي تأتي مع vgpu المثبّت في المشروع. يناسب عندما تعدّل إصدارًا محددًا وتخشى ألا يطابق الدليل الشيفرة. إن لم يكن vgpu في المشروع بعد فثبّت عبر Quick Start ثم اسأل. الشرح لا يكتب مرآة دون اتصال ولا عنوان موقع وثائق ثابت؛ ينشر vgpu.sh ملفّي agents.md وllms.txt لتقرأهما النماذج، دون تفصيل خطوات النشر.
الحالة 2: التطوير بنفس الواجهة عبر أزمنة تشغيل والتحقق بـ CLI. تغطي الواجهة العامة المتصفح وNode بلا واجهة (vgpu/node، خلفية Dawn) وmock حتمي للاختبارات وCI (vgpu/mock). يوميًا يمكن استخدام npx vgpu docs وnpx vgpu examples وnpx vgpu check. يناسب التحقق من المظلّلات قبل الإرسال، أو تشغيل الاختبارات في CI بالـ mock. الشرح لا يكتب تفاصيل تثبيت Dawn ولا قالب إعداد CI؛ قبل أن ترى WebGPU/Dawn جاهزين على هذا الجهاز لا تفترض أن مثال المتصفح سيمر في بيئة بلا واجهة. إن فشل أمر فارجع إلى https://github.com/vercel-labs/vgpu وقارن.
حدود الاستخدام
حد التثبيت: المشروع يستخدم pnpm add vgpu و@webgpu/types؛ المساعد يستخدم npx skills add vercel-labs/vgpu. بلا دعم للمهارات لا تطبّق الثاني. حد المهارة: توجيه وثائق فقط بلا مرجع API مرقم؛ هدف الاستعلام هو الإصدار المثبّت في المشروع. حد زمن التشغيل: المتصفح وvgpu/node وvgpu/mock يشتركون في الواجهة العامة؛ الشرح لا يضمن سلوكًا متطابقًا لكل الأمثلة في البيئات الثلاث. حد CLI: يمكن التحقق من docs وexamples وcheck. مدير الحزم المكتوب هو pnpm فقط؛ لا تستخدم مثبّتًا غير مسجّل.