/ الدليل / الملعب / convex-agent-skillz
← كل الخوادم ↗ GitHub
● مجتمع 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-agent-skillz-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "convex-agent-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PolarCoding85/convex-agent-skillz",
        "~/.claude/skills/convex-agent-skillz"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "convex-agent-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PolarCoding85/convex-agent-skillz",
        "~/.claude/skills/convex-agent-skillz"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "convex-agent-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PolarCoding85/convex-agent-skillz",
        "~/.claude/skills/convex-agent-skillz"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "convex-agent-skillz-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PolarCoding85/convex-agent-skillz",
        "~/.claude/skills/convex-agent-skillz"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "convex-agent-skillz-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/PolarCoding85/convex-agent-skillz",
        "~/.claude/skills/convex-agent-skillz"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "convex-agent-skillz-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/PolarCoding85/convex-agent-skillz",
          "~/.claude/skills/convex-agent-skillz"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add convex-agent-skillz-skill -- git clone https://github.com/PolarCoding85/convex-agent-skillz ~/.claude/skills/convex-agent-skillz

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

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

استخدامات عملية: convex-agent-skillz

إضافة الحضور الفوري إلى تطبيق Convex موجود

👤 مطورو Convex الذين يضيفون ميزات تعاونية ⏱ ~45 min intermediate

متى تستخدمه: لديك تطبيق وتريد مؤشرات 'من هنا' بأسلوب Figma دون تشغيل خادم socket.

المتطلبات الأساسية
  • تم نسخ المهارة إلى مجلد .claude في مشروعك — git clone https://github.com/PolarCoding85/convex-agent-skillz and copy .claude/ to your project root
الخطوات
  1. وصف الميزة
    باستخدام مهارات Convex — أضف الحضور إلى صفحة المستندات. أظهر المؤشرات وأسماء المستخدمين.✓ تم النسخ
    → Claude ينفذ مع نمط الحضور في Convex (mutation + استعلام تفاعلي) وليس WebSocket مخصص
  2. معالجة قطع الاتصال
    ماذا عن التنظيف عندما يغلق المستخدمون التبويب؟✓ تم النسخ
    → استراتيجية تنظيف الحضور المتقادم المحددة المتوافقة مع اتفاقيات Convex

النتيجة: حضور عامل مع تنظيف صحيح.

المزالق
  • نمط حضور مخصص يتعارض مع تفاعل Convex — تصوغ المهارة نحو الإصدار الاصطلاحي؛ لا تتجاوز بدون سبب
اجمعها مع: filesystem

دمج مصادقة Clerk مع Convex بشكل صحيح

👤 المطورون الذين يربطون Clerk بتطبيق Convex جديد أو موجود ⏱ ~30 min intermediate

متى تستخدمه: اخترت Clerk وتريد تكامله مع Convex صحيحاً من المرة الأولى.

الخطوات
  1. ربط المزود
    مهارات Convex — دمج مصادقة Clerk مع Convex. أعدّ قالب JWT وإعداد مصادقة Convex.✓ تم النسخ
    → يشير Claude إلى اسم قالب Clerk JWT الصحيح وإعداد auth.config.ts
  2. حماية الاستعلامات
    الآن تحكم في استعلام المستندات بحيث يمكن فقط للمالك قراءته.✓ تم النسخ
    → نمط ctx.auth.getUserIdentity() مع فحص الهوية الصحيح

النتيجة: مصادقة تمر في مراجعة الكود ولا تتسرب عبر المستأجرين.

بناء وكيل ذكاء اصطناعي مع خيوط دائمة على Convex

👤 المطورون الذين يبنون منتجات الدردشة أو الوكلاء ⏱ ~90 min advanced

متى تستخدمه: تريد سجل رسائل الخيوط الذي يستمر عبر الجلسات.

الخطوات
  1. نمذجة الخيوط
    مهارات Convex — جدول خيوط الوكيل + سجل الرسائل + بيانات وصفية استدعاء الأدوات.✓ تم النسخ
    → مخطط يغطي البث والرسائل الجزئية وحالة استدعاء الأداة
  2. ربط البث
    بث رد المساعد مرة أخرى عبر استعلام تفاعلي.✓ تم النسخ
    → نمط الرسالة الجزئية يستفيد من تفاعل Convex

النتيجة: طبقة خيط وكيل Convex الأصلية جاهزة للتوسع.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

convex-agent-skillz-skill + github

فتح طلبات الدمج لإضافات الميزات مع اختلافات Convex التقليدية

نفّذ ميزة الحضور والتزم وافتح طلب دمج مع ملاحظات أنماط مهارات Convex.✓ تم النسخ
convex-agent-skillz-skill + filesystem

العمل عبر المخطط والدوال وواجهة المستخدم في جلسة واحدة

حدّث convex/schema.ts وأضف الطفرة واربط خطاف React.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
queries_mutations_actions feature intent أي عمل convex/ 0
realtime_patterns feature (presence / streaming / collab) ميزات فورية 0
auth_setup provider (Clerk / WorkOS / custom) ربط المصادقة 0
durable_ops workflow intent منطق طويل الأجل أو كثيف الإعادة 0
ai_agent_threads agent feature description منتجات الوكيل على Convex 0

التكلفة والحدود

تكلفة التشغيل

حصة API
لا شيء من المهارة
الرموز لكل استدعاء
معتدل — الأنماط تحمّل حسب السياق
التكلفة المالية
مجاني — المهارات ملفات محلية. Convex نفسه له تسعيره الخاص.
نصيحة
ضع المهارة في مجلد .claude/ للمشروع بدلاً من العام — يعمل التنشيط التلقائي بشكل أفضل محدود بنطاق المشروع.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: لا توجد بيانات اعتماد في المهارة. تعيش أسرار مزود المصادقة في بيئتك الخاصة.
نقل البيانات الخارجي: None from the skill — code stays local

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

لم يتم استدعاء المهارة — Claude يكتب كوداً غير متطابق مع اصطلاحات Convex

قل 'استخدم مهارات Convex' أو تأكد من أنك تعمل داخل مجلد convex/.

تحقق: ls <project>/.claude/agents/convex-expert.md
مقدمة SKILL.md خاطئة

أعد نسخ .claude/ من الريبو.

تحقق: head <project>/.claude/skills/*/SKILL.md
كلمات تفعيل خاطئة — نمط المصادقة لا يستخدم مزودك

اسم المزود بشكل صريح ('with Clerk' / 'with WorkOS').

البدائل

convex-agent-skillz مقابل البدائل

البديلمتى تستخدمهاالمقايضة
وثائق Convex الرسميةتريد مصدراً أولياً بدلاً من مهارة منسقةلا يوجد تنشيط تلقائي داخل الوكيل
الأنماط المحضرة يدويًاأنت مطور Convex متمرسستعيد اختراع الأنماط؛ المهارة فقط تجعل Claude يستخدم أنماطك بشكل متسق

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills