/ الدليل / الملعب / convexskills
● مجتمع waynesutton ⚡ فوري

convexskills

بواسطة waynesutton · waynesutton/convexskills

12 مهارة متخصصة في Convex تغطي الدوال والمخطط الأساسي والوقت الفعلي والمهام المجدولة وإجراءات HTTP وتخزين الملفات والوكلاء والتدقيق الأمني والهجرات.

مجموعة مهارات مركزة لبناء تطبيقات على Convex. كل ملف SKILL.md (frontmatter صحيح + أمثلة + أفضل الممارسات) يعلم Claude أنماط Convex الاصطلاحية: الاستعلامات مقابل الطفرات مقابل الإجراءات، والوقت الفعلي التفاعلي، والمهام المجدولة، وخطافات HTTP، ومدققات المخطط الأساسي، والهجرات، والتدقيق الأمني. يتوقف Claude عن اختراع واجهات برمجية Convex.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

convexskills-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add convexskills-skill -- git clone https://github.com/waynesutton/convexskills ~/.claude/skills/convexskills

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

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

استخدامات عملية: convexskills

بناء تطبيق Convex جديد مع الوقت الفعلي والمصادقة وتحميل الملفات

👤 مطورو Full-stack الذين يبدأون مشروع Convex جديد ⏱ ~90 min intermediate

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

المتطلبات الأساسية
  • Convex CLI — npm create convex
الخطوات
  1. تصميم المخطط الأساسي
    استخدم مهارة convex-schema-validator. صمم جداول للمستخدمين والمشاريع والملفات بفهارس صحيحة.✓ تم النسخ
    → المخطط الأساسي يستخدم v.id() والفهارس معلنة والعلاقات صحيحة
  2. ربط الاستعلامات والطفرات
    استخدم مهارة convex-functions. نفذ CRUD للمشاريع.✓ تم النسخ
    → استعلام للقراءات وطفرة للكتابات بدون إساءة استخدام الإجراء
  3. إضافة الوقت الفعلي وتحميل الملفات
    استخدم convex-realtime و convex-file-storage لجعل المشاريع تتحدث مباشرة مع ملحقات الملفات.✓ تم النسخ
    → React يشترك عبر useQuery والملفات مخزنة عبر storage.generateUploadUrl

النتيجة: تطبيق Convex منظم بشكل صحيح يمكنك البناء عليه.

المزالق
  • استخدام الإجراءات حيث تكفي الطفرات — تفرض المهارة: طفرات لكتابات قاعدة البيانات وإجراءات لمخرجات خارجية

إضافة مهمة cron يومية تنظف الصفوف القديمة

👤 مطورو Convex الذين يضيفون صيانة في الخلفية ⏱ ~20 min beginner

متى تستخدمه: تحتاج إلى مهمة مجدولة بدون تشغيل عامل.

الخطوات
  1. استخدم مهارة cron
    استخدم convex-cron-jobs. أضف مهمة يومية تحذف الصفوف الأقدم من 30 يومًا من جدول الجلسات.✓ تم النسخ
    → crons.ts entry + طفرة داخلية للتنظيف
  2. اختبر
    أعطني طريقة لتشغيل هذا يدويًا للاختبار.✓ تم النسخ
    → إجراء HTTP أو وصفة CLI خاصة بالمطورين فقط

النتيجة: مهمة cron تعمل على جدول المهام المدار من قبل Convex.

المزالق
  • تشغل Cron استعلام بدلاً من طفرة داخلية — تفرض المهارة طفرة داخلية للحذف

تدقيق تطبيق Convex بحثًا عن ثغرات التفويض

👤 المطورون قبل إطلاق الإنتاج ⏱ ~45 min advanced

متى تستخدمه: تطبيقك جاهز لكنك لم تختبر المصادقة تحت الضغط.

الخطوات
  1. قم بتشغيل التدقيق
    استخدم convex-security-audit على هذا المستودع. تحقق من كل طفرة عامة للمصادقة الصحيحة.✓ تم النسخ
    → موضع المصادقة لكل دالة مع الشدة
  2. أصلح
    طبق الإصلاحات مع فحوصات الهوية والعودة إلى إرجاع null للقراءات غير المصرح بها.✓ تم النسخ
    → تم تحديث الدوال مع فحوصات ctx.auth

النتيجة: تم تشديد المصادقة قبل الإنتاج.

المزالق
  • الاعتماد على نموذج 'public=unauthenticated' الذهني — دوال Convex العامة قابلة للوصول عبر الإنترنت؛ تصر المهارة على فحوصات المصادقة
اجمعها مع: github

التركيبات

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

convexskills-skill + github

المهارة تصمم وتنفذ؛ GitHub MCP يفتح طلب الدمج

استخدم convexskills لبناء الميزة ثم افتح طلب دمج بالتغييرات.✓ تم النسخ
convexskills-skill + playwright-skill

بناء Convex backend ثم اختبارات Playwright للواجهة من النهاية إلى النهاية

نفذ Convex backend ثم اكتب اختبار playwright-skill يضرب الواجهة ويتحقق من التحديثات في الوقت الفعلي.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
convex-functions function need أي عمل دالة 0
convex-schema-validator data model تصميم أو تغيير الجداول 0
convex-realtime UI use case إضافة واجهة مستخدم تفاعلية 0
convex-cron-jobs scheduled task العمل الدوري في الخلفية 0
convex-migrations schema change تطور المخطط الأساسي الموجود 0
convex-security-audit repo مراجعة ما قبل الإنتاج 0

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

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

حصة API
لا شيء للمهارة؛ Convex لديها مستويات مجانية وموجودة خاصة بها
الرموز لكل استدعاء
2-6k لكل مهارة محملة
التكلفة المالية
مجاني — المهارة محلية. Convex لديها مستوى مجاني سخي.
نصيحة
سمّ المهارة المحددة (مثل convex-cron-jobs) لتجنب تحميل المجموعة الكاملة.

الأمان

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

تخزين بيانات الاعتماد: لا توجد بيانات اعتماد في المهارة. مفاتيح نشر Convex تبقى في .env الخاص بك.
نقل البيانات الخارجي: لا شيء من المهارة نفسها

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

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

Claude writes an action when a mutation suffices

القاعدة الذهبية التي تفرضها المهارة: DB-only → طفرة؛ external I/O → إجراء.

Schema change breaks existing data

استخدم مهارة convex-migrations — فهي تخطط انتقالات آمنة مع التعبئة الخلفية.

useQuery doesn't update in realtime

تحقق من التفاعلية: يجب أن يقرأ الاستعلام البيانات التي تغيرت وليس فهرسًا قديمًا.

البدائل

convexskills مقابل البدائل

البديلمتى تستخدمهاالمقايضة
مستندات Convex اليدوية + أمثلةأنت بالفعل مطور Convex ذو خبرةالإدراج الأبطأ بدون المهارة
مهارات fullstack خاصة بالإطارأنت لست على Convexمكدس مختلف

المزيد

الموارد

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

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

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