skill

بدء تشغيل Convex السريع

احصل على قالب Convex + ويب أساسي يعمل من فكرة في جملة واحدة.

get-convex120,195+ تثبيتموثوق

نبذة

<!-- تم الإنشاء من 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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 السريع مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في الإنتاجية والمكتب.

كل بدائل بدء تشغيل Convex السريع ←
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/skills
البحث عن المهارات
يساعد المستخدمين على اكتشاف وتثبيت مهارات الوكلاء عندما يطرحون أسئلة مثل "كيف أفعل X؟"، "ابحث عن مهارة ل X"، "هل توجد مهارة يمكنها..."، أو يعبرون عن ا…3,611,572+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
استخدام الوسائط
احصل على أو أنشئ أي وسائط لفيديو HyperFrames - موسيقى، مؤثرات صوتية، صور، أيقونات، شعارات، تعليق صوتي، صورة رمزية وفيديو مولد، نصوص، قصاصات، درجات ألو…1,085,267+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تحسين هيكلية قاعدة الكود
افحص قاعدة بيانات برمجية بحثا عن فرص للتحسين والتعميق، وقدمها كتقرير HTML مرئي، ثم تعمق في أي فرصة تختارها.1,040,100+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تسليم المهام
لخص المحادثة الحالية في وثيقة تسليم ليتابعها وكيل آخر.946,569+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
فرز أولي
نقل المشكلات وطلبات السحب الخارجية عبر آلة حالة لأدوار الفرز، وتصنيفها، والتحقق منها، والتدقيق فيها عند الحاجة، وكتابة ملخصات جاهزة للوكلاء.881,979+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تعليم
علم المستخدم مهارة أو مفهوما جديدا ضمن مساحة العمل هذه.778,928+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في الإنتاجية والمكتب