تثبيت Supabase Skills للـ Agent بالأمر الرسمي

لمن هذا الدليل

هذا الدليل لمن يستخدم أصلًا، أو يستعد لاستخدام، AI Agent في تطوير Supabase. رسميًا هو مكتوب كـ Agent Skills تساعد المطوّرين على استخدام Supabase في AI agents.

قبل البدء، أكّد أن هذا الجهاز يستطيع تشغيل npx، وأن الدليل الحالي هو المشروع الذي تريد كتابة ملفات المهارات فيه. الصفحة تنص على التوافق مع 18+ AI agents، ومنها Claude Code وGitHub Copilot وCursor وCline وكثير غيرها؛ هذه ملاحظة توافق وليست قائمة حصرية، ولا يجوز استنتاج نطاق لغات من قائمة المنتجات.

بعد التثبيت تصبح المهارات متاحة تلقائيًا، ويستخدمها الـ Agent عند اكتشاف مهام ذات صلة. في المحاولة الأولى لا تُطلق عمدًا مهامًا تغيّر قاعدة البيانات أو تنشر دوال أو تغيّر التخزين.

إكمال أول محاولة في 3 دقائق

استخدم فقط أمر التثبيت الموصى به الوارد في الصفحة:

npx skills add supabase/agent-skills

الشرط المسبق: هذا الجهاز فيه npx، ودليل العمل الحالي هو جذر المشروع المستهدف. موضع التثبيت هو المشروع الحالي؛ لا تعِد كتابة ذلك كأمر سوق أو مسار نسخ يدوي غير ظاهر في الصفحة.

نقطة تأكيد الأثر الجانبي: هذا الأمر يكتب ملفات المهارات في المشروع الحالي. إذا كان الدليل خاطئًا فتوقف أولًا. التثبيت نفسه لن يغيّر مشروع Supabase تلقائيًا؛ لكن بعد ذلك قد يستخدم الـ Agent هذه المهارات فور اكتشاف مهمة ذات صلة. أكّد صحة الدليل ثم نفّذ.

إشارة النجاح: ينتهي الأمر بشكل طبيعي وتظهر ملفات المهارات في المشروع. بعد ذلك تحقق مرة واحدة فقط: في Agent متوافق اطرح سؤالًا للقراءة فقط، مثل كيفية فهم اتصال Database أو Auth الحالي، وانظر هل يجيب وفق المهارات المثبّتة. لا تنشئ جداول، ولا تنشر Edge Functions، ولا تغيّر Storage، ولا تلمس Cron/Queues. إذا كان الـ Agent على وشك تنفيذ كتابة، فتوقف عند نقطة التأكيد.

حالات الاستخدام

الحالة 1: تثبيت المهارات الرسمية في المشروع الحالي. في جذر المشروع المؤكد نفّذ npx skills add supabase/agent-skills. الدليل يغطي هذا الأمر، وأنه يساعد المطوّرين على استخدام Supabase مع AI agents. معيار الإنجاز يتوقف عند نجاح التثبيت وظهور ملفات المهارات. لا تضف أوامر تحديث أو إلغاء تثبيت غير ظاهرة.

الحالة 2: بعد التثبيت، إجراء تحقق منتج للقراءة فقط. الصفحة تنص على أن المهارات تغطي أي منتج Supabase: Database، Auth، Edge Functions، Realtime، Storage، Vectors، Cron، Queues؛ وأنها تصبح متاحة تلقائيًا بعد التثبيت، ويستخدمها الـ Agent عند اكتشاف مهام ذات صلة. المقتطف لا يعطي أمر شرطة مائل محددًا، لذلك في المرة الأولى اسأل الـ Agent فقط عن شرح للقراءة فقط لمنتج واحد، مثل كيفية فهم إعداد Database أو Auth الحالي. إشارة النجاح القابلة للملاحظة هي أن الـ Agent يجيب بوضوح وفق المهارات المثبّتة، لا أنه غيّر موارد سحابية فعلًا. أوجه الكتابة مثل Cron وQueues وStorage موجودة في قائمة المنتجات، لكن ذلك لا يعني أن المحاولة الأولى يجب أن تشغّلها.

حدود الاستخدام

مسار التثبيت الأساسي هو فقط npx skills add supabase/agent-skills. الـ Agents المذكورة ليست النطاق الحصري المدعوم. تُفعَّل المهارات تلقائيًا عند اكتشاف مهمة ذات صلة، لذا أبعد الأسئلة عن مهام تغيّر بيانات مباشرة. قائمة المنتجات ليست قائمة تفويض. إلغاء التثبيت وأسماء ملفات المهارات المحددة وأوامر كل منتج غير واردة في المقتطف؛ وما لم يُكتب لا يُتخذ خلاصة أمان.