مهارات Claude Code لـ Unreal Engine

مهارة Claude Code هي مجلد فيه ملف SKILL.md: ترويسة YAML (يُنصح بحقل description، مع حقول اختيارية مثل allowed-tools) تليها تعليمات بصيغة Markdown. يحمّل Claude Code المهارة عندما يطابق طلبك وصفها، أو عندما تكتب /skill-name.

• مهارات المشروع توجد في .claude/skills/<name>/SKILL.md. ارفعها في commit فيحصل عليها فريقك أيضًا.
• المهارات الشخصية توجد في ~/.claude/skills/<name>/SKILL.md.
• مهارات الإضافات تأتي مع إضافة تثبّتها عبر /plugin، وتستدعيها بصيغة /plugin-name:skill-name.

تقترح وثائق Anthropic إبقاء ملف SKILL.md أقل من 500 سطر. يُقصّ وصف المهارة عند 1,536 حرفًا في قائمة المهارات، وبعد ضغط المحادثة تحتفظ كل مهارة بأول 5,000 رمز فقط. يلتقط Claude Code تعديلات المهارة أثناء عمله.

تنشر Epic إضافة unreal-engine-skills-for-claude-code-plugin على GitHub بترخيص MIT. يصفها ملف README بأنها طريقة للتحكم في Unreal Editor من Claude Code عبر MCP، وخلفها أكثر من 30 مجموعة أدوات، منها الممثلون وBlueprints والمواد وNiagara وSequencer والاختبارات الآلية.

• مهارة unreal-mcp: كيفية استخدام Unreal MCP من Claude Code، مع صفحات مرجعية للإعداد والتشغيل اليومي.
• خطاف SessionStart (unreal-context.sh) يخبر Claude Code أن المستودع مشروع Unreal.
• مهارتان مرافقتان: create-toolset، وunreal-skill لإنشاء المهارات ومراجعتها.

يذكر ملف README هذه الأوامر. شغّلها داخل Claude Code:

/plugin install unreal-engine-skills-for-claude-code@claude-plugins-official

# إذا لم يكن متجر الإضافات موجودًا:
/plugin marketplace add anthropics/claude-plugins-official

لتفعيلها لفريق كامل، يضيف README السطر "unreal-engine-skills-for-claude-code@claude-plugins-official": true تحت enabledPlugins في ملف .claude/settings.json الخاص بالمشروع.

قبل أن تفعل شيئًا مفيدًا تحتاج إلى:

• Unreal Editor مع تفعيل الإضافتين Unreal MCP (ModelContextProtocol) وAll Toolsets.
• محرر مفتوح وخادم MCP يعمل (يبدأ تلقائيًا افتراضيًا، وإلا شغّل ModelContextProtocol.StartServer).
• bash في PATH من أجل خطاف SessionStart. على Windows استخدم Git Bash أو WSL.

شرح ربط Claude Code بالمحرر خطوة بخطوة موجود في إعداد Unreal Engine 5.8 MCP مع Claude Code أو Cursor.

تنشط مهارة unreal-mcp عندما تطلب إجراءً في مشروع مفتوح (إنشاء ممثلين، تعديل Blueprints، الترجمة عبر Live Coding) وتبتعد عن الأسئلة النظرية. مع تفعيل البحث عن الأدوات، يكتشف Claude Code الأدوات عبر list_toolsets وdescribe_toolset ثم ينفّذها عبر call_tool.

• احفظ قبل التغييرات الجماعية وبعدها: تعديلات MCP لا يمكن التراجع عنها دائمًا.
• انتظر انتهاء الترجمة، وترجم C++ عبر Live Coding.
• شغّل الاستدعاءات المترابطة واحدًا تلو الآخر، لا بالتوازي.
• توقّف عند أي نتيجة ليست نجاحًا صريحًا.
• تحقّق مما إذا كان Play in Editor يعمل عندما تبدو النتائج غريبة.

مهارات المحرك شيء مختلف

لدى Unreal مفهومه الخاص للمهارة. في إصدار الشيفرة المصدرية 5.8.0، المهارة كائن في المحرك له وصف وتعليمات، ويُقدَّم عبر أداتين في Unreal MCP هما ListSkills وGetSkills. تطلب مهارة unreal-mcp من Epic أن يستدعي Claude Code الأداة ListSkills في بداية أي عمل غير مألوف وأن يتبع مهارات المشروع بدل الإعدادات العامة.

يتضمن إصدار الشيفرة المصدرية مهارات محرك لأساسيات Blueprints وأساسيات المواد والإضاءة الخارجية الافتراضية وNiagara (الأساسيات والعارضات والتحسين وغيرها) وتوليد رسوم PCG. ولدى Unreal MCP أيضًا إعداد Instructions (Editor Preferences > Agentic Workflows > Model Context Protocol؛ وتُشارك نسخة المشروع عبر DefaultGame.ini) يرسل تلميحًا إلى كل عميل.

• يحذّر README: "Localhost is not a trust boundary." لا توجد في Unreal MCP مصادقة خاصة به.
• execute_tool_script يشغّل أي شيفرة Python بصلاحية كاملة على المحرر. وينصح README بعدم استخدام --dangerously-skip-permissions.
• احفظ عملك في commit أو shelve قبل جلسة طويلة؛ بعض التعديلات لا يمكن التراجع عنها في المحرر.
• إضافة Unreal MCP تجريبية، ولا يذكر README إصدارًا مدعومًا للمحرك.
• تخبر المهارة Claude Code كيف يتصرف بحذر، لكن التحقق من أن النتيجة تعمل أثناء اللعب يبقى عليك.

Claude Code من دون الإضافة

من دون Unreal MCP يبقى Claude Code قادرًا على C++ وملفات الإعداد والبناء من الطرفية، لكنه لا يرى داخل أصول Blueprint ولا المحرر أثناء عمله. المزيد عن هذا التقسيم: Claude Code لـ Unreal Engine مقابل الذكاء الاصطناعي المدمج في UE.

Dola ليس جزءًا من هذه المجموعة. إنه تطبيق سطح مكتب مع إضافة خاصة به لـ Unreal Editor، مصمّمة لـ Unreal Engine 5.7 على Windows وLinux. يشغّل وكلاؤه Claude عبر الخادم الخلفي لـ Dola، فلا تثبّت Claude Code ولا مدخل متجر إضافات ولا إعداد MCP.

• راجع قبل أن تحتفظ: كل تعديل ينتظر في لوحة Changes. افتح الفرق في Unreal ثم اقبله، أو ارفضه لاستعادة الأصل القديم.
• الفحص باللعب: يقرأ وكيل QA الرسم البياني ويجرّب التغيير في Play in Editor قبل اعتبار التشغيل منتهيًا.
• اختر حسب إعدادك: في مشروع 5.8 تستخدم فيه Claude Code أصلًا، إضافة Epic هي الطريق المباشر. على 5.7، يأتي Dola جاهزًا ويفحص عمله بنفسه.

تشغيل حقيقي لـ Dola في 9 نوفمبر 2026: طلب واحد، "make BP_Lamp blink"، فُحص في PIE ثم احتُجز للمراجعة.

التشغيل كاملًا خطوة بخطوة: شاهد Dola وهو يعمل.