● مجتمع
PolarCoding85
⚡ فوري
convex-agent-skillz
بواسطة PolarCoding85 · PolarCoding85/convex-agent-skillz
معرفة Convex الخلفية الجاهزة للاستخدام — الاستعلامات والطفرات والحضور الفوري والسير العملي والمصادقة (Clerk/WorkOS) وأنماط وكلاء الذكاء الاصطناعي تُحمّل تلقائياً حسب السياق.
يوفر PolarCoding85/convex-agent-skillz لـ Claude خبرة عميقة عبر Convex: الاستعلامات والطفرات والإجراءات ونقاط نهاية HTTP والمخطط والفهرسة والميزات الفورية (الحضور والبث والتحرير التعاوني) والعمليات الدائمة (السير العملي والطوابير والجدول الزمني) والمصادقة (العامة و Clerk و WorkOS) والتكامل مع الذكاء الاصطناعي (خيوط الوكيل واستدعاء الأدوات وRAG وسجل الرسائل). يدرك السياق — العمل في convex/ ينشّط وكيل convex-expert تلقائياً؛ الإشارة إلى مكونات مثل Rate Limiter أو Stripe يحمّل النمط المطابق.
لماذا تستخدمه
الميزات الأساسية
- أنماط Convex العميقة — الاستعلامات والطفرات والإجراءات ونقاط نهاية HTTP
- ميزات فورية: الحضور والبث والتحرير التعاوني
- العمليات الدائمة: السير العملي والطوابير والمهام المجدولة
- أنماط المصادقة — العامة بالإضافة إلى Clerk و WorkOS المتخصصة
- أنماط وكيل الذكاء الاصطناعي: الخيوط واستدعاء الأدوات وRAG وسجل الرسائل المستمر
عرض مباشر
كيف يبدو في الممارسة
convex-agent-skillz-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: convex-agent-skillz
متى تستخدمه: لديك تطبيق وتريد مؤشرات 'من هنا' بأسلوب Figma دون تشغيل خادم socket.
الخطوات
-
وصف الميزة
باستخدام مهارات Convex — أضف الحضور إلى صفحة المستندات. أظهر المؤشرات وأسماء المستخدمين.✓ تم النسخ
→ Claude ينفذ مع نمط الحضور في Convex (mutation + استعلام تفاعلي) وليس WebSocket مخصص
-
معالجة قطع الاتصال
ماذا عن التنظيف عندما يغلق المستخدمون التبويب؟✓ تم النسخ
→ استراتيجية تنظيف الحضور المتقادم المحددة المتوافقة مع اتفاقيات Convex
النتيجة: حضور عامل مع تنظيف صحيح.
المزالق
- نمط حضور مخصص يتعارض مع تفاعل Convex — تصوغ المهارة نحو الإصدار الاصطلاحي؛ لا تتجاوز بدون سبب
متى تستخدمه: اخترت Clerk وتريد تكامله مع Convex صحيحاً من المرة الأولى.
الخطوات
-
ربط المزود
مهارات Convex — دمج مصادقة Clerk مع Convex. أعدّ قالب JWT وإعداد مصادقة Convex.✓ تم النسخ
→ يشير Claude إلى اسم قالب Clerk JWT الصحيح وإعداد auth.config.ts
-
حماية الاستعلامات
الآن تحكم في استعلام المستندات بحيث يمكن فقط للمالك قراءته.✓ تم النسخ
→ نمط ctx.auth.getUserIdentity() مع فحص الهوية الصحيح
النتيجة: مصادقة تمر في مراجعة الكود ولا تتسرب عبر المستأجرين.
متى تستخدمه: تريد سجل رسائل الخيوط الذي يستمر عبر الجلسات.
الخطوات
-
نمذجة الخيوط
مهارات Convex — جدول خيوط الوكيل + سجل الرسائل + بيانات وصفية استدعاء الأدوات.✓ تم النسخ
→ مخطط يغطي البث والرسائل الجزئية وحالة استدعاء الأداة
-
ربط البث
بث رد المساعد مرة أخرى عبر استعلام تفاعلي.✓ تم النسخ
→ نمط الرسالة الجزئية يستفيد من تفاعل Convex
النتيجة: طبقة خيط وكيل Convex الأصلية جاهزة للتوسع.
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
convex-agent-skillz-skill +
githubفتح طلبات الدمج لإضافات الميزات مع اختلافات Convex التقليدية
نفّذ ميزة الحضور والتزم وافتح طلب دمج مع ملاحظات أنماط مهارات Convex.✓ تم النسخ
العمل عبر المخطط والدوال وواجهة المستخدم في جلسة واحدة
حدّث convex/schema.ts وأضف الطفرة واربط خطاف React.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا شيء من المهارة
- الرموز لكل استدعاء
- معتدل — الأنماط تحمّل حسب السياق
- التكلفة المالية
- مجاني — المهارات ملفات محلية. Convex نفسه له تسعيره الخاص.
- نصيحة
- ضع المهارة في مجلد .claude/ للمشروع بدلاً من العام — يعمل التنشيط التلقائي بشكل أفضل محدود بنطاق المشروع.
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا توجد بيانات اعتماد في المهارة. تعيش أسرار مزود المصادقة في بيئتك الخاصة.
نقل البيانات الخارجي: None from the skill — code stays local
- تفترض أنماط المصادقة أنك تعدّ قوالب JWT بشكل صحيح في Clerk/WorkOS — اقرأ وثائقهم أيضاً.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
لم يتم استدعاء المهارة — Claude يكتب كوداً غير متطابق مع اصطلاحات Convex
قل 'استخدم مهارات Convex' أو تأكد من أنك تعمل داخل مجلد convex/.
تحقق: ls <project>/.claude/agents/convex-expert.md
كلمات تفعيل خاطئة — نمط المصادقة لا يستخدم مزودك
اسم المزود بشكل صريح ('with Clerk' / 'with WorkOS').
البدائل
convex-agent-skillz مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| وثائق Convex الرسمية | تريد مصدراً أولياً بدلاً من مهارة منسقة | لا يوجد تنشيط تلقائي داخل الوكيل |
| الأنماط المحضرة يدويًا | أنت مطور Convex متمرس | ستعيد اختراع الأنماط؛ المهارة فقط تجعل Claude يستخدم أنماطك بشكل متسق |