AI خزنة
أضواء على الأصول

مهارات تجعل الذكاء الاصطناعي أفضل في تطبيقات Next.js وسوبابيز

ما مهارة الوكيل، وسبع مهارات حقيقية لقواعد البيانات والتصميم والاختبار والمراجعة وتتبع الأخطاء، وكيف تثبتها

ATAI Khazna Team7 دقيقة قراءة

تطلب من أداة برمجة بالذكاء الاصطناعي أن تضيف جدولا إلى مشروعك في سوبابيز، فتنجح، لكنها تنسى أمان مستوى الصفوف. وتطلب صفحة جديدة فتأتي شبيهة بكل صفحة صنعها ذكاء اصطناعي. وتبلغ عن خطأ فتعالج العرض بدل السبب. لا يعني هذا أن النموذج ضعيف، بل يعني أنه لا يعرف معاييرك، وأنك تكرر التصحيحات نفسها في كل جلسة.

المهارات (Skills) تعالج ذلك. يشرح هذا المقال ما المهارة، ثم يسلط الضوء على سبع مهارات حقيقية من كتالوج AI خزنة تجعل وكيل الذكاء الاصطناعي أفضل بوضوح في بناء تطبيقات Next.js وسوبابيز.

ما المهارة

تصف أنثروبيك مهارات الوكلاء (Agent Skills) بأنها قدرات مستقلة تجمع التعليمات والبيانات الوصفية وموارد اختيارية مثل السكربتات والقوالب، يستخدمها كلود تلقائيا حين تكون ذات صلة. وعمليا، المهارة مجلد فيه ملف SKILL.md. في أعلى الملف اسم ووصف يقولان ماذا تفعل المهارة ومتى تستخدم، وتحتهما التعليمات.

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

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

سبع مهارات لتطبيقات Next.js وسوبابيز

كل مهارة هنا مدرجة في كتالوج AI خزنة، والأوصاف أدناه مأخوذة من صفحاتها.

1. سوبابيز (Supabase)

تنشرها سوبابيز نفسها، ومهارة سوبابيز مخصصة لأي مهمة تتضمن سوبابيز: قاعدة البيانات، والمصادقة، والدوال الطرفية، والتحديث اللحظي، والتخزين، والمتجهات، والمهام المجدولة، والطوابير، إضافة إلى مكتبات مثل supabase-js و@supabase/ssr، وسطر الأوامر، والترحيلات، والتدقيق الأمني. وإرشاداتها عملية: راجع الوثائق الحالية لأن سوبابيز تتغير كثيرا، وشغل استعلام اختبار بعد كل تغيير، وفعل أمان مستوى الصفوف على كل جدول في المخططات المكشوفة، ولا تستخدم البيانات الوصفية للمستخدم في منح الصلاحيات، وأبق مفاتيح service-role بعيدا عن العملاء العامين.

استخدمها حين: تضيف تسجيل الدخول، أو تربط سوبابيز بمكونات الخادم في Next.js، أو تنشئ جداول.

2. أفضل ممارسات Postgres من سوبابيز

توصف مهارة Supabase Postgres Best Practices بأنها أفضل ممارسات Postgres تحافظ عليها سوبابيز، لأي قاعدة Postgres أينما كانت. تغطي تصميم الجداول والأعمدة، والترحيلات، وسياسات RLS والاختبارات التي تتحقق منها، والفهارس، والمشغلات، والدوال، والطوابير، والمهام المجدولة، والبحث المتجهي. وقواعدها موزعة على ثماني فئات مرتبة حسب الأولوية، يتصدرها أداء الاستعلامات وإدارة الاتصالات والأمان وRLS، وكل قاعدة تعرض مثالا خاطئا وآخر صحيحا بلغة SQL.

استخدمها حين: يكتب الوكيل أي شيء يعيش في قاعدة البيانات، خصوصا الترحيلات والسياسات.

3. تصميم الواجهات (Frontend Design)

من أنثروبيك، تقدم مهارة Frontend Design إرشادات لتصميم بصري مميز ومقصود عند بناء واجهة جديدة أو إعادة تشكيل واجهة قائمة. تطلب من الوكيل أن يفهم المنتج والجمهور أولا، وأن يختار الخطوط عن قصد، وأن يتجنب العلامات الشائعة للتصميم القالبي الذي يصنعه الذكاء الاصطناعي، مثل البطاقات المستديرة المتطابقة والعناوين الزخرفية التي لا تحمل معلومة.

استخدمها حين: تبني صفحات الهبوط أو لوحات التحكم أو أي شاشة سيحكم المستخدمون على منتجك من خلالها.

4. التطوير الموجه بالاختبارات (Test Driven Development)

مهارة Test Driven Development من obra، وتستخدم عند تنفيذ أي ميزة أو إصلاح قبل كتابة كود التنفيذ. تفرض دورة الأحمر والأخضر وإعادة الهيكلة: اكتب اختبارا واحدا فاشلا، وتأكد أنه يفشل للسبب الصحيح، واكتب أقل كود يجعله ينجح، ثم شغل مجموعة الاختبارات كاملة. وفكرتها الأساسية بسيطة: إن لم تر الاختبار يفشل، فلا تعرف إن كان يختبر الشيء الصحيح.

استخدمها حين: تلمس المدفوعات أو الصلاحيات أو أي منطق لا تحتمل أن ينكسر بصمت.

5. اختبار تطبيقات الويب (Webapp Testing)

مهارة Webapp Testing من أنثروبيك مجموعة أدوات للتفاعل مع تطبيقات الويب المحلية واختبارها باستخدام Playwright. تساعد الوكيل على التحقق من سلوك الواجهة، والتقاط لقطات الشاشة، وقراءة سجلات المتصفح، وتتضمن أداة مساعدة تشغل الخوادم قبل الاختبار وتوقفها بعده. وفي التطبيقات الديناميكية توصي بالانتظار حتى تستقر الصفحة قبل فحصها.

استخدمها حين: تريد أن يجرب الوكيل التسجيل والنماذج والدفع في متصفح حقيقي بدل افتراض أنها تعمل.

6. مراجعة الكود (Code Review)

مهارة Code Review من أنثروبيك تراجع تغييرات الكود من حيث الأمان والأداء والصحة. وتشمل فحوصها الأمنية حقن SQL وXSS وCSRF، وثغرات المصادقة والصلاحيات، والأسرار المكتوبة في الكود، واجتياز المسارات، وSSRF. كما تنبه إلى مشكلات الأداء مثل استعلامات N+1 والفهارس الناقصة، وتنتهي بحكم: موافقة، أو طلب تغييرات، أو حاجة إلى نقاش.

استخدمها حين: تقترب من دمج ميزة أو من الإطلاق. واجمعها مع قائمتنا عن أخطاء الأمان الشائعة في كود الذكاء الاصطناعي.

7. التتبع المنهجي للأخطاء (Systematic Debugging)

مهارة Systematic Debugging من obra أيضا، وتستخدم مع أي خطأ أو اختبار فاشل أو سلوك غير متوقع، قبل اقتراح أي إصلاح. وقاعدتها: لا إصلاح قبل التحقيق في السبب الجذري. وتمر بالوكيل عبر أربع مراحل: التحقيق وإعادة إنتاج المشكلة، ثم المقارنة بكود يعمل، ثم اختبار فرضية واحدة في كل مرة، ثم إصلاح السبب بدءا باختبار فاشل.

استخدمها حين: يجرب الوكيل إصلاحين سريعين ويبقى الخطأ قائما.

كيف تثبت مهارة

تختلف الخطوات الدقيقة باختلاف الأداة، لكن الفكرة واحدة في كل مكان: ضع مجلد المهارة حيث يبحث الوكيل عن المهارات.

  1. افتح صفحة المهارة في الكتالوج. تعرض كل صفحة المستودع المصدر وأمر التثبيت، وكثيرا ما يكون بصيغة npx skills add owner/repo.
  2. أو انسخ المجلد يدويا. في كلود كود، تقول وثائق أنثروبيك إن المهارات الشخصية توضع في ~/.claude/skills/ ومهارات المشروع في .claude/skills/ داخل مستودعك. وكل مهارة مجلد يحتوي ملف SKILL.md الخاص بها.
  3. فضل مهارات المشروع في العمل الجماعي. حفظها في المستودع يعني أن الجميع، وكل جلسة للوكيل، يحصلون على المعايير نفسها.
  4. اقرأ قبل أن تثبت. المهارة تعليمات، وأحيانا سكربتات، سيتبعها وكيلك. افتح ملف SKILL.md، وتحقق مما تفعله أي سكربتات، ولا تثبت إلا من مصادر تثق بها.
  5. اختبرها. أعط الوكيل مهمة صغيرة يفترض أن تفعل المهارة، مثل إضافة جدول، وتحقق من أنه يتبع القواعد الجديدة.

وتشير صفحات كثيرة إلى توافق المهارة مع أدوات أخرى غير كلود كود، منها كيرسر ووكلاء آخرون، فراجع الصفحة الخاصة بأداتك.

مجموعة بداية معقولة

إن كنت تبدأ مشروع Next.js وسوبابيز اليوم، فابدأ بثلاث: سوبابيز وأفضل ممارسات Postgres لطبقة البيانات، والتتبع المنهجي للأخطاء للحظات التي تسوء فيها الأمور. وأضف تصميم الواجهات حين تصل إلى الواجهة، والتطوير الموجه بالاختبارات واختبار تطبيقات الويب حين يعتمد مستخدمون حقيقيون على التطبيق، ومراجعة الكود قبل كل إطلاق. فالمهارات القليلة المختارة جيدا أفضل من قائمة طويلة نادرا ما يحتاجها الوكيل.

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

الأسئلة الشائعة

ما الفرق بين المهارة وملف CLAUDE.md؟
ملف CLAUDE.md أو ملف القواعد يصف مشروعك وينطبق على كل جلسة. أما المهارة فتجمع خبرة نوع واحد من المهام، ولا تحمل إلا حين تطابق مهمة ما وصفها.
هل تعمل هذه المهارات في كيرسر كما تعمل في كلود كود؟
تظهر صفحات هذه المهارات في الكتالوج توافقها مع عدة أدوات، منها كلود كود وكيرسر. راجع صفحة كل مهارة للتأكد من أداتك قبل التثبيت.
هل يبطئ تثبيت مهارات كثيرة عمل الوكيل؟
تحمل المهارات على مراحل، فلا يبقي الوكيل أمامه إلا الاسم والوصف القصير لكل مهارة حتى تحتاجها مهمة، لذلك تكلفة المهارات الإضافية قليلة. ومع ذلك تبقى المجموعة المركزة أسهل في الإدارة.
هل تثبيت المهارات آمن؟
المهارة تعليمات، وأحيانا سكربتات، يتبعها وكيلك. اقرأ ملف SKILL.md وأي سكربتات أولا، ولا تثبت إلا من مصادر تثق بها.
skillssupabasenextjspostgrestesting