● مجتمع
jezweb
⚡ فوري
claude-skills
بواسطة jezweb · jezweb/claude-skills
مهارات Claude Code شاملة لـ Cloudflare و React و Tailwind v4 والتكاملات مع الذكاء الاصطناعي — مدروسة وحديثة.
claude-skills من Jezweb مجموعة عملية من المهارات الشاملة تركز على Cloudflare (Workers و D1 و R2 و KV) و React الحديث وترقيات Tailwind v4 والتكاملات الشائعة مع الذكاء الاصطناعي (OpenAI و Anthropic والتضمينات). تناسب المطورين المستقلين والفرق الصغيرة التي تنشر على Cloudflare stack.
لماذا تستخدمه
الميزات الأساسية
- Cloudflare: أنماط Workers و D1 و R2 و KV و Pages و Durable Objects
- React (RSC و Server Actions وأساليب suspense)
- ترحيل Tailwind v4 + شكل الإعداد الجديد
- تكاملات الذكاء الاصطناعي: أنماط OpenAI/Anthropic SDK والتضمينات والبحث الموجه
- إعدادات صريحة — منحازة نحو الخيارات الأبسط
عرض مباشر
كيف يبدو في الممارسة
claude-skill-3.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: claude-skills
متى تستخدمه: تريد API JSON صغير مع المصادقة والاستمرارية، مُنشَّر على Cloudflare.
الخطوات
-
الهيكل الأساسي
استخدم مهارة Cloudflare. New Worker مع D1 binding و Hono router والمسارات: GET /todos و POST /todos و DELETE /todos/:id.✓ تم النسخ
→ Worker code + wrangler.toml + schema.sql
-
المصادقة
أضف bearer token auth باستخدام secret في env.✓ تم النسخ
→ Middleware + تعليمات wrangler secret put
-
النشر
خطوات wrangler d1 execute + wrangler deploy.✓ تم النسخ
→ URL مباشر بعد النشر
النتيجة: Worker API مُنشَّر مع استمرارية D1.
المزالق
- انجراف هجرات D1 بين البيئات — استخدم wrangler d1 migrations create + apply؛ لا تنفذ بطريقة عشوائية
متى تستخدمه: أنت على tailwind@3 وتريد تبني محرك Oxide في v4 + إعداد CSS-first.
الخطوات
-
تدقيق الإعداد الحالي
دقق tailwind.config.{js,ts} بحثاً عن أي شيء لا ينقل 1:1 إلى v4.✓ تم النسخ
→ ملاحظات الهجرة لكل config-key
-
توليد إعداد v4
أنتج معادل v4: @theme في CSS entry + تحديثات package.✓ تم النسخ
→ CSS entry + فرق package.json
-
إصلاح الأدوات المكسورة
ابحث في codebase عن فئات utility المحذوفة/المعاد تسميتها وأنتج خريطة استبدال.✓ تم النسخ
→ اقتراحات Codemod
النتيجة: PR ترحيل v4 جاهز للمراجعة.
المزالق
- تضارب خط أنابيب PostCSS مع محرك v4 الأصلي — أزل مكونات PostCSS التي يستبدلها محرك v4
متى تستخدمه: تريد RAG بدون إعداد خدمة vector DB.
الخطوات
-
إعداد Vectorize
قدّم فهرس Vectorize للتضمينات. استخدم OpenAI text-embedding-3-small.✓ تم النسخ
→ wrangler vectorize create + binding
-
سكريبت الاستقبال
اكتب مسار Worker /ingest يقسّم + يضمّن + يحدّث.✓ تم النسخ
→ Worker code مع heuristic للتقسيم
-
مسار الاستعلام
اكتب /query الذي يضمّن السؤال ويسترجع top-k ويستدعي Claude/OpenAI مع السياق.✓ تم النسخ
→ مسار من البداية إلى النهاية
النتيجة: نقطة نهاية RAG صغيرة لكن حقيقية مُنشَّرة على Cloudflare.
المزالق
- التقسيمات الكبيرة جداً تفقد الاستدعاء؛ الصغيرة جداً تضر بالسياق — ابدأ بـ 512 token مع تداخل 64؛ ضبّط بناءً على corpus الخاصة بك
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
مراجعة الأمان لمصادقة Worker ونقاط نهاية RAG
بعد بناء الهيكل الأساسي للـ Worker مع المصادقة، قم بتشغيل مراجعة OWASP على وسيط المصادقة.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا يوجد على مستوى المهارة
- الرموز لكل استدعاء
- 5-20k لكل مهمة
- التكلفة المالية
- مهارة مجانية؛ Cloudflare + OpenAI/Anthropic لديهما تسعيرهما الخاص
- نصيحة
- الطبقة المجانية من Cloudflare تغطي Worker APIs الصغيرة؛ راقب تكلفة Vectorize عند التوسع.
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا توجد بيانات اعتماد على مستوى المهارة. Wrangler يتعامل مع CF secrets.
نقل البيانات الخارجي: عمليات النشر تذهب إلى Cloudflare؛ أي استدعاءات AI تذهب إلى المزود المُعدَّل
- مصادقة Wrangler لها وصول كامل للحساب. استخدم رموز API محدودة النطاق للـ CI وليس wrangler login.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
wrangler deploy fails on route
أنماط المسار تتطلب أن تكون المنطقة في حساب CF الخاص بك؛ تحقق من المسارات مقابل workers.dev fallback
تحقق: wrangler deployments list
D1 migrations apply locally but not remote
قم بتشغيل wrangler d1 migrations apply <DB> --remote بشكل صريح
البدائل
claude-skills مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| قالب Vercel + Next.js | تفضل DX في Vercel | تسعير وإمكانيات منصة مختلفة |