● مجتمع
michtio
⚡ فوري
craftcms-claude-skills
بواسطة michtio · michtio/craftcms-claude-skills
مجموعة مهارات Claude Code متخصصة في Craft CMS 5 — تكتب الوحدات وقوالب Twig والترحيلات واستعلامات GraphQL بالطريقة الخاصة بـ Craft
مهارات وعملاء وقوالب مشاريع جاهزة للإنتاج تعلم Claude Code كيفية عمل Craft CMS 5 بالفعل. بدلاً من اقتراحات PHP عامة، تحصل على أنماط Craft الحقيقية — استعلامات عناصر صحيحة، مقابض حقول، هيكل وحدة، اتفاقيات Pixel & Tonic
لماذا تستخدمه
الميزات الأساسية
- مجموعة مهارات متخصصة في Craft CMS 5.x (PHP 8.2+)
- قوالب للوحدات والمكونات والحقول المخصصة
- هيكلية قوالب Twig تتطابق مع أنماط Craft
- أنماط ترحيل قاعدة البيانات باستخدام MigrationHelper من Craft
- مساعدات مخطط GraphQL لمشاريع Craft بلا رأس
عرض مباشر
كيف يبدو في الممارسة
craftcms-claude-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: craftcms-claude-skills
متى تستخدمه: تحتاج إلى وحدة جديدة ولا تريد نسخ يدوي لوحدة أخرى كقالب
الخطوات
-
صف وظيفة الوحدة
استخدم craftcms-claude-skills. أنشئ وحدة جديدة تسمى 'Inventory' تسجل نوع عنصر مخصص لعناصر المستودع✓ تم النسخ
→ يقوم Claude بإنشاء هيكلية modules/inventory/ مع src/Inventory.php و elements/WarehouseItem.php وإدخال إعدادات
-
قم بتوصيلها
سجل الوحدة في config/app.php وأضف إدخال التمهيد✓ تم النسخ
→ يتم عرض الفروقات في الإعدادات؛ تحميل الوحدة بدون أخطاء عند craft setup/check
-
أضف استعلام عنصر
أضف فئة WarehouseItemQuery مع معامل 'sku' مخصص يقوم بتصفية على جدول المحتوى✓ تم النسخ
→ فئة الاستعلام مع بنود WHERE صحيحة، وليس SQL خام
النتيجة: وحدة Craft عاملة تتبع اتفاقيات Pixel & Tonic — جاهزة لترحيلتك الأولى
المزالق
- يكتب Claude رمز بأسلوب Craft 3/4 — اذكر صراحةً Craft CMS 5 في كل موجز — تغيرت واجهة API
متى تستخدمه: تولليت مشروع Craft والقوالب مليئة بـ SQL خام وPHP مضمن وعلامات ذاكرة تخزين مؤقت لا تعمل
الخطوات
-
وجه Claude إلى أسوأ قالب
باستخدام craftcms-claude-skills، استعرض templates/_entries/blog.twig وأعد كتابته باستخدام استعلامات عناصر صحيحة وعلامات {% cache %}✓ تم النسخ
→ قالب معاد هيكلة مع craft.entries ومقبض القسم والنطاق الصحيح للذاكرة المؤقتة
-
استخرج وحدات ماكرو قابلة لإعادة الاستخدام
اسحب ترميز البطاقة إلى وحدة ماكرو في _macros/cards.twig وأضمنها بشكل صحيح✓ تم النسخ
→ تم إنشاء ملف الماكرو؛ يتضمن بنية {% from %}
النتيجة: قوالب تحميل أسرع ويمكن لمطوري المستقبل قراءتها بالفعل
المزالق
- تلف علامات الذاكرة المؤقتة بيانات المستخدم الديناميكية وتعرض محتوى خاطئ — استخدم {% cache %} مع متغيرات مفتاحة عالمياً، ليس أبداً حول بيانات المستخدم المصرح لها
متى تستخدمه: تضيف حقل جديد أو تعيد هيكلة حقل موجود وتحتاج ترحيل لن يستهلك البيانات
الخطوات
-
صف التغيير
استخدم craftcms-claude-skills. اكتب ترحيل Craft يضيف حقل 'featuredAt' datetime لقسم الأخبار، مع ملء آمن من postDate✓ تم النسخ
→ ملف ترحيل مع safeUp / safeDown؛ يستخدم خدمة Fields من Craft، وليس حيل المخطط الخام
-
جرية تجريبية في بيئة التطوير
دليلني خلال اختبار هذا باستخدام ./craft migrate/up --interactive=0 على نسخة المرحلة أولاً✓ تم النسخ
→ قائمة تحقق خطوة بخطوة تتضمن نسخة احتياطية من قاعدة البيانات
النتيجة: ترحيل يمكنك شحنه في يوم جمعة بدون ذعر
المزالق
- نسيان تسجيل نوع الحقل في إعدادات المشروع — قم دائماً بتشغيل craft project-config/write بعد الترحيل والتزام ملف YAML
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
توفر المهارة أنماط Craft؛ نظام الملفات يسمح لـ Claude بتطبيقها فعلياً في مشروعك
طبق هيكلية وحدة craftcms-claude-skills على دليل مشروعك الحالي✓ تم النسخ
craftcms-claude-skill + mysql
افحص جداول محتوى Craft أثناء كتابة الترحيلات
أريني المخطط الحالي لجدول elements_sites قبل أن أكتب هذا الترحيل✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا توجد حصة
- الرموز لكل استدعاء
- معتدلة — يتم تحميل ملفات المراجعة عند الطلب
- التكلفة المالية
- مجاني
- نصيحة
- اشر إلى المهارة بالاسم فقط عند العمل على رمز Craft؛ إنها تضيف حملاً سياقياً للمهام غير ذات الصلة
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا توجد بيانات اعتماد
نقل البيانات الخارجي: لا يوجد — موجزات وملفات محلية فقط
- الرمز المولد يستهدف Craft 5؛ لا تطبق على مشاريع Craft 3/4 بدون مراجعة
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
يولد Claude رمز عصر Craft 3 (craft()->elements)
اذكر 'Craft CMS 5' صراحةً؛ مساحة اسم API هي craft\elements في 5.x
تحقق: grep -r 'craft()->' src/ يجب أن يرجع لا شيء في رمز Craft 5
يعمل الترحيل لكن الحقل لا يظهر في لوحة التحكم
قم بتشغيل ./craft project-config/write و ./craft project-config/apply — الانجراف في إعدادات المشروع هو السبب المعتاد
تحقق: ./craft project-config/diff
البدائل
craftcms-claude-skills مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| Claude Code الخام | تعديلات Twig فقط بسيطة لا تحتاج أنماط خاصة بـ Craft | اقتراحات PHP عامة، غالباً خاطئة لـ Craft |
| symfony-hexagonal-skill | أنت على Symfony، وليس Craft | اتفاقيات إطار عمل مختلفة |