· درس
دليل Teardown بالعربي: ثبّت المهارة في Claude Code، وابنِ محاكياً ثلاثي الأبعاد للمكائن، مع أمثلة جاهزة وقوالب برومبت وتسجيل فيديو بصوت خطوة بخطوة.
Teardown مهارة (skill) مجانية لـ Claude Code تحوّل أي مكينة أو آلية إلى محاكي 3D تفتحه وتقصّه وتشغّله بنفسك، في صفحة HTML واحدة تعمل بدون إنترنت.
تسأل Claude Code بكلام عادي: «كيف يعمل محرك V8؟» أو «ابنِ لي محاكي لجهاز هبوط طائرة». فيبني لك صفحة واحدة فيها:
الفضل لصاحبها: المهارة من تطوير elvarofficial، مبنية على مشروع whaleyxbt/claude-motion، ومنشورة بترخيص MIT (مجانية للاستخدام والتعديل مع ذكر المصدر). أنا جرّبتها وكتبت لك هذا الدليل بالعربي.
لكل شخص يحتاج يشرح كيف تعمل مكينة من الداخل، بأرقام تتحرك معها بدل صورة ثابتة.
| من أنت | كيف تستفيد |
|---|---|
| مدرّس أو محاضر هندسة أو فيزياء | تشرح آلية (محرك، مضخة، ناقل حركة) ويفتحها الطالب ويجرّبها بنفسه |
| شركة معدات أو قسم تدريب | تدرّب الفنيين على المكينة من الداخل قبل ما يلمسوا الحقيقية |
| مصنع أو مبيعات تقنية | تري الزبون منتجك من الداخل، وترسل له فيديو أو صفحة تفتح بدون إنترنت |
| شركة ناشئة في الأجهزة | تعرض آلية منتجك للمستثمر أو في مراجعة تصميم |
| صانع محتوى تقني | تصنع فيديو «كيف تعمل» مع صوت بوصف المكينة بالكلام |
يمكن تمرير الجدول أفقياً لعرض بقية الأعمدة.
ملاحظة صريحة: التثبيت يحتاج استخدام سطر الأوامر (Terminal). لو أول مرة تفتحه، اتبع الخطوات حرفياً، كل أمر مكتوب لك جاهز للنسخ.
تحتاج اشتراك Claude مدفوعاً وجهاز كمبيوتر؛ الباقي برامج مجانية.
| المتطلب | لماذا | ضروري؟ |
|---|---|---|
| اشتراك Claude: Pro أو Max أو Team أو Enterprise أو حساب Console | Claude Code غير متاح في الخطة المجانية | نعم |
| جهاز: macOS 13 أو أحدث، أو Windows 10 (إصدار 1809) أو أحدث، أو Ubuntu 20.04 أو أحدث، وذاكرة 4 غيغابايت على الأقل | تشغيل Claude Code | نعم |
| Claude Code | المهارة تعمل داخله | نعم |
| Node.js الإصدار 20 أو أحدث | بناء صفحة المحاكي | نعم |
| متصفح Chrome أو Edge أو Safari | فتح المحاكي | نعم |
| ffmpeg | تحويل الجولة إلى فيديو MP4 | فقط للفيديو |
| Python 3 | صناعة صوت الفيديو | فقط للصوت |
| Git لويندوز | يسمح لـ Claude Code بتشغيل أوامر Bash | مُنصح به على ويندوز |
يمكن تمرير الجدول أفقياً لعرض بقية الأعمدة.
المصدر: متطلبات Claude Code الرسمية وصفحة مهارة Teardown.
أربع خطوات، حوالي 15 دقيقة لأول مرة. انسخ كل أمر كما هو والصقه في Terminal.
كيف تفتح Terminal: على الماك اضغط Cmd + مسافة واكتب Terminal. على ويندوز ابحث في قائمة ابدأ عن PowerShell. بعد كل تثبيت أغلق النافذة وافتح واحدة جديدة.
ادخل nodejs.org وحمّل نسخة LTS وثبّتها مثل أي برنامج. للتأكد:
node -v
يجب أن يظهر رقم يبدأ بـ v20 أو أعلى.
الماك ولينكس:
curl -fsSL https://claude.ai/install.sh | bash
ويندوز (PowerShell):
irm https://claude.ai/install.ps1 | iex
افتح نافذة جديدة وتأكد بـ claude --version، ثم اكتب claude وسجّل دخولك من المتصفح الذي يفتح. على ويندوز يُنصح بتثبيت Git for Windows أيضاً. (المصدر: دليل تثبيت Claude Code)
اخرج من Claude Code (اكتب /exit) ونفّذ في Terminal:
npx skills add elvarofficial/teardown -g -a claude-code
تُنسخ المهارة إلى المجلد ~/.claude/skills/teardown (على ويندوز: مجلد .claude\skills\teardown داخل مجلد المستخدم). إذا سألك المثبّت أسئلة، اضغط Enter على الخيارات الافتراضية.
الماك ولينكس:
cd ~/.claude/skills/teardown && npm install && npx playwright install chromium
ويندوز (PowerShell):
cd "$env:USERPROFILE\.claude\skills\teardown"; npm install; npx playwright install chromium
npm install ضروري لبناء المحاكي. playwright install chromium يحمّل متصفحاً تستخدمه المهارة لتسجيل الفيديو واللقطات.
الطريق الأسهل للخطوة 4: بعد الخطوة 3 افتح claude واكتب له: «جهّز مهارة teardown لأول مرة حسب تعليماتها». سينفّذ الأوامر بنفسه ويطلب موافقتك.
المهارة تأتي بثلاث مكائن كاملة. ابنِها أولاً لترى النتيجة قبل أن تطلب مكينتك.
| المثال | ماذا ترى | ما الذي يحرّكه |
|---|---|---|
| v8-live | محرك V8 بأسطوانات زجاجية: الاحتراق داخل السلندر، الصمامات والمكابس تتحرك | زاوية عمود الكرنك، وترتيب الاشتعال 1-8-4-3-6-5-7-2 |
| cessna-live | جهاز هبوط طائرة Cessna 337 ينطوي داخل الهيكل عند الإقلاع وينزل عند الهبوط | شوط السنّة المسننة (rack) من 0 إلى 1 |
| strandbeest-live | مخلوق Strandbeest الماشي لـ Theo Jansen، 20 رجلاً على عمود واحد | سرعة الريح |
يمكن تمرير الجدول أفقياً لعرض بقية الأعمدة.
افتح Terminal في مجلد العمل الذي تريده ونفّذ (الماك ولينكس):
node ~/.claude/skills/teardown/sims/build.mjs v8-live
node ~/.claude/skills/teardown/sims/build.mjs cessna-live
node ~/.claude/skills/teardown/sims/build.mjs strandbeest-live
ويندوز (PowerShell):
node "$env:USERPROFILE\.claude\skills\teardown\sims\build.mjs" v8-live
تجد النتيجة في المجلد teardown-out/dist داخل مجلد العمل: ملف HTML واحد لكل مثال، حجمه حوالي 800 كيلوبايت. افتحه بالمتصفح.
جرّبت أمر تثبيت المهارة وبناء الأمثلة الثلاثة بنفسي على جهاز لينكس بتاريخ 1 نوفمبر 2026: اشتغلوا بدون أخطاء، وكل مثال تبنّى في أقل من ثانية.
الفرق بين نتيجة عادية ومحاكي محترف هو ما تعطيه للمهارة مع الجملة: مرجع حقيقي وقياسات حقيقية. هذا أول قاعدة مكتوبة في تعليمات المهارة نفسها: المكائن المخترعة من جملة تطلع عامة ومكررة في كل مرة.
| تعطيها | النتيجة |
|---|---|
| جملة فقط: «ابنِ مضخة» | مكينة عامة تشبه اللعبة |
| جملة + صورة أو رسمة قطاع من الكتالوج | شكل أقرب للمكينة الحقيقية |
| جملة + مرجع + قياسات حقيقية (أقطار، أشواط، عدد الأسنان، أطوال الأذرع) | محاكي تتحرك فيه القطع والأرقام من نفس الحساب |
يمكن تمرير الجدول أفقياً لعرض بقية الأعمدة.
باقي القواعد التي تتبعها المهارة، ومفيد تعرفها لتكتب طلباً أفضل:
من أين تجيب القياسات؟ كتالوج الشركة المصنّعة، دليل الصيانة، المخططات الهندسية، أو قياسك المباشر للقطعة.
شغّل claude داخل مجلد العمل، اسحب صورة المرجع إلى النافذة (أو ضعها في المجلد واذكر اسمها)، ثم الصق القالب بعد تعبئة الأقواس. تقدر تكتب بالعربي أو الإنجليزي.
استخدم مهارة teardown وابنِ محاكياً لـ [اسم المكينة وموديلها].
المرجع: الصورة المرفقة [اسم الملف]. ابنِ عليها وقارن معها.
القياسات الحقيقية: [قائمة الأبعاد بوحداتها].
المدخل الذي يحرّك كل شيء: [زاوية العمود / الشوط / السرعة / الضغط].
القطعة التي يجب أن تُفتح: [الجزء الذي يقوم بالعمل].
اللوحات: [الأرقام والرسوم التي تريدها].
الجمهور: [طلاب / فنيون / زبائن].
بعد البناء تحقق من رقم واحد يدوياً واكتب لي الحساب.
هذه الثلاثة منشورة في صفحة المهارة بنصّها:
Build me a simulator of a 4-stroke motorcycle engine I can take apart.
How does a mechanical watch keep time? Show me as a simulator.
Make a teardown of a hydraulic excavator arm and record a 20-second video of it.
| المجال | الطلب | القياسات التي تجهّزها |
|---|---|---|
| تعليم الهندسة الميكانيكية | محاكي لناقل حركة يدوي 5 سرعات يبيّن مسار العزم في كل غيار، مع لوحة نسبة الترويس والسرعة | عدد أسنان كل ترس، الموديول، المسافات بين المحاور |
| النفط والمياه | محاكي لمضخة طاردة مركزية يبيّن مسار السائل ويعرض منحنى الأداء حسب السرعة | قطر المروحة، عدد الريش، السرعة، نقاط منحنى الأداء من كتالوج المصنّع |
| المعدات الثقيلة | محاكي لذراع حفارة هيدروليكية يبيّن شوط كل أسطوانة ومدى وصول الجرّاف | أطوال الأذرع، نقاط المفاصل، أشواط الأسطوانات |
| الصمامات والأنابيب | محاكي لصمام بوابة (gate valve) بقطاع يبيّن نسبة الفتح حسب عدد لفات المقبض | القطر الاسمي، خطوة اللولب، عدد اللفات للفتح الكامل |
| المبيعات التقنية | محاكي لمنتجنا [الاسم] يعرض الآلية التي تميّزه، مع فيديو 20 ثانية للعرض | رسمات المنتج ومواصفاته من الكتالوج |
| الفيزياء | محاكي لآلية ساعة بندول يبيّن كيف تضبط آلية الانفلات (escapement) الوقت | طول البندول، عدد أسنان عجلة الانفلات |
يمكن تمرير الجدول أفقياً لعرض بقية الأعمدة.
القوالب نقطة بداية: أضف قياسات مكينتك الحقيقية دائماً. البناء الأول نادراً يكون الأخير؛ اطلب تعديلات بالكلام مثل «قرّب الكاميرا من المكبس» أو «أضف لوحة للضغط».
احسب رقماً واحداً بيدك وقارنه بما يظهر في المحاكي. هذه أيضاً قاعدة مكتوبة في تعليمات المهارة.
مثال من جهاز هبوط Cessna في الأمثلة الجاهزة: الترس (pinion) فيه 32 سنّاً بموديول 4 مم، ويدور 180° من الفتح للطيّ. قطر دائرة الخطوة = 32 × 4 = 128 مم. نصف دورة تحرّك السنّة المسننة مسافة نصف المحيط:
(π × 128) ÷ 2 ≈ 201.06 mm
وهذا يطابق شوط السنّة المسننة في المحاكي: 201 مم.
ماذا يثبت هذا وماذا لا يثبت:
في كل محاكي تبنيه، اطلب من Claude: «اختر رقماً واحداً من اللوحات واحسبه من القياسات يدوياً أمامي»، ثم راجع الحساب بآلة حاسبة.
الطريق الأسهل: اطلبه من Claude بالكلام، مثلاً «سجّل جولة المحاكي فيديو 20 ثانية مع الصوت». المهارة تصوّر الجولة إطاراً إطاراً بدقة 60 إطاراً في الثانية، وتصنع صوتاً على نفس التوقيت، ثم تدمجهما بـ ffmpeg.
للمتقدمين، هذه الأوامر كما في تعليمات المهارة لمثال V8 (الماك ولينكس، من مجلد العمل):
S=~/.claude/skills/teardown
node "$S/sims/build.mjs" v8-film
node "$S/sims/capture.mjs" v8-film --size 1600x900 --dpr 1.2 --out teardown-out/v8-silent.mp4
python3 "$S/run_sfx.py" "$S/sims/v8-shared/score.py"
ffmpeg -y -i teardown-out/v8-silent.mp4 -i teardown-out/v8-score.wav -map 0:v -map 1:a -c:v copy -c:a aac -b:a 256k -shortest -movflags +faststart teardown-out/v8.mp4
| المشكلة | الحل |
|---|---|
| claude غير معروف بعد التثبيت | أغلق Terminal وافتحه من جديد. إذا استمرت، راجع حل مشاكل التثبيت |
| لا يقبل تسجيل الدخول | تأكد أن اشتراكك Pro أو أعلى؛ الخطة المجانية لا تشمل Claude Code |
| node -v يعطي أقل من v20 | حمّل نسخة LTS الحالية من nodejs.org |
| npx playwright install chromium فشل | الصفحات تتبنّى بدونه، هو للفيديو فقط. أعد المحاولة لاحقاً أو اطلب من Claude استخدام Chrome المثبّت عندك |
| المكينة تطلع عامة وبسيطة | أضف صورة مرجعية وقياسات حقيقية (القسم «لعبة أو محاكي») |
| قطعة تخترق قطعة أخرى | اطلب تعديل القياس المسؤول، لا تغيير زاوية الكاميرا |
| الفيديو بطيء جداً في التسجيل | الجهاز يرسم بدون كرت شاشة. سجّل على جهاز أقوى أو قلّل الدقة |
يمكن تمرير الجدول أفقياً لعرض بقية الأعمدة.
الدليل من يوسف الجبوري (@yousif_aljbouri). المهارة لصاحبها elvarofficial.