skill
بدء تشغيل Convex السريع
احصل على قالب Convex + ويب أساسي يعمل من فكرة في جملة واحدة.
نبذة
<!-- تم الإنشاء من convex-agents content/capabilities/quickstart.json — لا تقم بالتعديل يدويا. -->
# دليل البدء السريع: قالب Convex أساسي قيد التشغيل
قم بإعداد قالب Next.js + Convex أساسي من الفكرة، محليا، مع نشر تطوير مجهول. مصمم ليكون بسيطا: خوادم تطوير محلية، لا توجد خطوة نشر، ولا مصادقة مسبقة التجهيز.
## سير العمل
1. قم بتشغيل الوصفة `quickstart-recipe@^2` باستخدام {idea, template} (تقوم الحزمة بجلبها وتخزينها مؤقتا؛ مع توفير نسخة احتياطية غير متصلة بالإنترنت). تقوم بإنشاء المشروع، وتثبيت التبعيات، وبدء الواجهة الخلفية (مجهولة)، وخادم تطوير الويب. 2. عندما تطبع عنوان URL الخاص بالتطوير، افتحه للمستخدم. 3. قدم خطة قصيرة وقم بالتأكيد قبل بناء ميزات تتجاوز القالب.
## القواعد
- لا تقم أبدا بإعادة تشغيل الوصفة إذا كانت قد أبلغت عن نجاحها بالفعل. - قم بتفويض أي كود تحت `convex/` إلى قدرة `convex-expert`. - لا تقم بإضافة Postgres/Redis/Express — استخدم بدائيات Convex. - لا تقم بإضافة استضافة/نشر أو مصادقة مسبقة التجهيز هنا — حافظ على القالب بسيطا ما لم يطلب المستخدم المزيد. - قاعدة التدهور — إذا تعذر تشغيل الهيكل (جلسة غير تفاعلية، لا توجد شبكة، دليل مؤقت معزول، أو يريد المستخدم الكود فقط، وليس تطبيقا): تخطى الوصفة واكتب مشروع Convex قياسيا مباشرة. يذهب كل كود الواجهة الخلفية تحت `convex/` (schema.ts، functions) — لا تضعه أبدا في جذر المشروع؛ تعمل وظائف Convex فقط من دليل `convex/`. لا تكتب أي ملفات هيكل/توثيق (لا START_HERE.md، ARCHITECTURE.md، MANIFEST.txt، جدران README) ما لم يطلب منك ذلك صراحة. "ابن لي واجهة خلفية" تعني الكود، وليس المراسم. - الوصول إلى البيانات + الاستيراد — قبل كتابة أي convex/*.ts: لا تقم أبدا ب `.collect()` غير المحدود على جدول يمكن أن ينمو — استخدم `.withIndex(...)` و `.paginate(...)`/`.take(n)`. استخدم فهرسا، وليس `.filter()`، لأي شيء سيكون SQL WHERE. تحتوي استدعاءات `.withIndex(...)` على `eq`/`gt`/`gte`/`lt`/`lte` فقط — لا توجد طريقة `.range(...)`. الاستيراد: `query`/`mutation`/`action`/`internalQuery`/`internalMutation`/`internalAction` تأتي من `./_generated/server`؛ `api`/`internal` تأتي من `./_generated/api`؛ لا تقم أبدا بالاستيراد من `convex/server` في كود التطبيق. `v.literal("exact value")` لأعضاء السلسلة/التعداد الثابتة، وليس سلسلة عارية. `"use node"` فقط في الجزء العلوي من الوحدات النمطية التي تعمل كإجراءات فقط — لا تضعه أبدا في ملف يقوم أيضا بتصدير `query` أو `mutation`. لا تقم أبدا باستيراد Node builtin (`crypto`/`fs`/`path`/`http`/`child_process`/`os`، مع أو بدون البادئة `node:`) إلى ملف يفتقر إلى `"use node"` — بما في ذلك معالجات مسار `http.ts`؛ استخدم Web Crypto (`crypto.subtle`) بدلا من استيراد `crypto` حيثما أمكن. - الأسماء المحجوزة — لا تقم أبدا ب `export const <jsReservedWord> = ...` (مثل `delete`, `new`, `class`, `function`, `return`) كاسم تصدير استعلام/تعديل/إجراء؛ يفشل esbuild في تحليله. لا تقم أبدا بتسمية جدول أو فهرس يبدأ ب `_` (مثل `_migrations: defineTable(...)`) — `_` محجوز ويسبب أخطاء عند الدفع ك `TableNameReserved`/`IndexNameReserved`. - مسارات HTTP — لا يحتوي `httpRouter` على مقاطع `:param` على غرار Express (`path: "/users/:id"` يطابق تلك السلسلة الحرفية فقط وهو كود ميت)؛ استخدم `pathPrefix` وقم بتحليل المقطع اللاحق بنفسك. يجب أن يكون كل `http.route({...})` `handler:` ملفوفا في `httpAction(...)` من `./_generated/server` — `async (ctx, request) => {...}` العاري يقوم بفحص النوع ولكنه ليس إجراء HTTP صالحا. - تحتاج `ctx.runQuery`/`ctx.runMutation`/`ctx.runAction` إلى مرجع دالة تم إنشاؤها بواسطة الكود (`api.foo.bar`/`internal.foo.bar`)، وليس أبدا عضو وحدة نمطية مستوردة خام (`import * as queries from "./queries"; ctx.runQuery(queries.getX, ...)` يتم تجميعه ولكنه يفشل في وقت التشغيل). - قاعدة التحقق الذاتي — قبل إعلان انتهاء عمل الواجهة الخلفية، تحقق من تجميعه ودفعه: قم بتشغيل `npx tsc --noEmit` وادفعه إلى نشر. فضل النشر الحالي للمشروع؛ وإلا `npx convex dev --once` عندما ينجح `npx convex whoami`، و `CONVEX_AGENT_MODE=anonymous npx convex dev --once` فقط عندما لا ينجح. يؤدي فرض المجهول على مستخدم مسجل الدخول إلى إعادة ربط `.env.local` ويكلفهم النشر السحابي الدائم والقابل للنشر الذي يتوقعونه. قم بإصلاح كل خطأ يبلغه قبل الانتهاء — جولة تحقق واحدة تلتقط فئة الاستيراد النسبي الخاطئ / الرمز المكرر / القوس غير المتوازن التي قد تؤدي إلى تعطيل النشر.
التثبيت
شغل هذا الأمر
npx skills add get-convex/agent-skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add get-convex/agent-skills`، أو استنسخ المستودع وانسخ مجلد `skills/convex-quickstart` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة بدء تشغيل Convex السريع؟
احصل على قالب Convex + ويب أساسي يعمل من فكرة في جملة واحدة.
كيف أثبت بدء تشغيل Convex السريع؟
شغل هذا الأمر في الطرفية:
npx skills add get-convex/agent-skillsمع أي أدوات ذكاء اصطناعي تعمل بدء تشغيل Convex السريع؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور بدء تشغيل Convex السريع؟
طورها get-convex.
هل بدء تشغيل Convex السريع مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى