/ الدليل / الملعب / craftcms-claude-skills
← كل الخوادم ↗ GitHub
● مجتمع 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

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

craftcms-claude-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add craftcms-claude-skill -- git clone https://github.com/michtio/craftcms-claude-skills ~/.claude/skills/craftcms-claude-skills

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

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

استخدامات عملية: craftcms-claude-skills

بناء وحدة Craft CMS مخصصة دون مغادرة Claude Code

👤 مطورو Craft CMS الذين ينشئون وحدات خاصة بالموقع ⏱ ~30 min intermediate

متى تستخدمه: تحتاج إلى وحدة جديدة ولا تريد نسخ يدوي لوحدة أخرى كقالب

المتطلبات الأساسية
  • مشروع Craft CMS 5 معد محلياً — composer create-project craftcms/craft my-project
  • تم نسخ المهارة — git clone https://github.com/michtio/craftcms-claude-skills ~/.claude/skills/craftcms-claude-skills
الخطوات
  1. صف وظيفة الوحدة
    استخدم craftcms-claude-skills. أنشئ وحدة جديدة تسمى 'Inventory' تسجل نوع عنصر مخصص لعناصر المستودع✓ تم النسخ
    → يقوم Claude بإنشاء هيكلية modules/inventory/ مع src/Inventory.php و elements/WarehouseItem.php وإدخال إعدادات
  2. قم بتوصيلها
    سجل الوحدة في config/app.php وأضف إدخال التمهيد✓ تم النسخ
    → يتم عرض الفروقات في الإعدادات؛ تحميل الوحدة بدون أخطاء عند craft setup/check
  3. أضف استعلام عنصر
    أضف فئة WarehouseItemQuery مع معامل 'sku' مخصص يقوم بتصفية على جدول المحتوى✓ تم النسخ
    → فئة الاستعلام مع بنود WHERE صحيحة، وليس SQL خام

النتيجة: وحدة Craft عاملة تتبع اتفاقيات Pixel & Tonic — جاهزة لترحيلتك الأولى

المزالق
  • يكتب Claude رمز بأسلوب Craft 3/4 — اذكر صراحةً Craft CMS 5 في كل موجز — تغيرت واجهة API
اجمعها مع: filesystem · mysql

إعادة هيكلة فوضى قوالب Twig إلى أنماط Craft الفصحى

👤 مطورو الواجهة الأمامية الذين يرثون موقع Craft بقوالب مريبة ⏱ ~45 min intermediate

متى تستخدمه: تولليت مشروع Craft والقوالب مليئة بـ SQL خام وPHP مضمن وعلامات ذاكرة تخزين مؤقت لا تعمل

الخطوات
  1. وجه Claude إلى أسوأ قالب
    باستخدام craftcms-claude-skills، استعرض templates/_entries/blog.twig وأعد كتابته باستخدام استعلامات عناصر صحيحة وعلامات {% cache %}✓ تم النسخ
    → قالب معاد هيكلة مع craft.entries ومقبض القسم والنطاق الصحيح للذاكرة المؤقتة
  2. استخرج وحدات ماكرو قابلة لإعادة الاستخدام
    اسحب ترميز البطاقة إلى وحدة ماكرو في _macros/cards.twig وأضمنها بشكل صحيح✓ تم النسخ
    → تم إنشاء ملف الماكرو؛ يتضمن بنية {% from %}

النتيجة: قوالب تحميل أسرع ويمكن لمطوري المستقبل قراءتها بالفعل

المزالق
  • تلف علامات الذاكرة المؤقتة بيانات المستخدم الديناميكية وتعرض محتوى خاطئ — استخدم {% cache %} مع متغيرات مفتاحة عالمياً، ليس أبداً حول بيانات المستخدم المصرح لها
اجمعها مع: filesystem

اكتب ترحيل Craft آمن لتغييرات نموذج المحتوى

👤 مطورو Craft الذين يشحنون تغييرات المخطط إلى الإنتاج ⏱ ~30 min advanced

متى تستخدمه: تضيف حقل جديد أو تعيد هيكلة حقل موجود وتحتاج ترحيل لن يستهلك البيانات

الخطوات
  1. صف التغيير
    استخدم craftcms-claude-skills. اكتب ترحيل Craft يضيف حقل 'featuredAt' datetime لقسم الأخبار، مع ملء آمن من postDate✓ تم النسخ
    → ملف ترحيل مع safeUp / safeDown؛ يستخدم خدمة Fields من Craft، وليس حيل المخطط الخام
  2. جرية تجريبية في بيئة التطوير
    دليلني خلال اختبار هذا باستخدام ./craft migrate/up --interactive=0 على نسخة المرحلة أولاً✓ تم النسخ
    → قائمة تحقق خطوة بخطوة تتضمن نسخة احتياطية من قاعدة البيانات

النتيجة: ترحيل يمكنك شحنه في يوم جمعة بدون ذعر

المزالق
  • نسيان تسجيل نوع الحقل في إعدادات المشروع — قم دائماً بتشغيل craft project-config/write بعد الترحيل والتزام ملف YAML
اجمعها مع: mysql · git

التركيبات

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

craftcms-claude-skill + filesystem

توفر المهارة أنماط Craft؛ نظام الملفات يسمح لـ Claude بتطبيقها فعلياً في مشروعك

طبق هيكلية وحدة craftcms-claude-skills على دليل مشروعك الحالي✓ تم النسخ
craftcms-claude-skill + mysql

افحص جداول محتوى Craft أثناء كتابة الترحيلات

أريني المخطط الحالي لجدول elements_sites قبل أن أكتب هذا الترحيل✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
module_scaffold module name, element types عند بدء وحدة جديدة 0
field_generator field name, type, handle عند إضافة نوع حقل مخصص 0
twig_refactor template path عند تنظيف القوالب القديمة 0

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

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

حصة API
لا توجد حصة
الرموز لكل استدعاء
معتدلة — يتم تحميل ملفات المراجعة عند الطلب
التكلفة المالية
مجاني
نصيحة
اشر إلى المهارة بالاسم فقط عند العمل على رمز Craft؛ إنها تضيف حملاً سياقياً للمهام غير ذات الصلة

الأمان

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

تخزين بيانات الاعتماد: لا توجد بيانات اعتماد
نقل البيانات الخارجي: لا يوجد — موجزات وملفات محلية فقط

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

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

يولد 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
المهارة لم تُشغل على موجزات Craft

استدعاء بالاسم: 'use craftcms-claude-skills'. تحقق من وجود SKILL.md

تحقق: ls ~/.claude/skills/craftcms-claude-skills/SKILL.md

البدائل

craftcms-claude-skills مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Claude Code الخامتعديلات Twig فقط بسيطة لا تحتاج أنماط خاصة بـ Craftاقتراحات PHP عامة، غالباً خاطئة لـ Craft
symfony-hexagonal-skillأنت على Symfony، وليس Craftاتفاقيات إطار عمل مختلفة

المزيد

الموارد

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

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

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