بني محاكاة واقعية وتفاعلية ديال الماكينات باستعمال Claude Code وMachine Skill

شنو كيدير Machine Skill

Machine Skill هو Agent Skill مفتوح المصدر مخصّص لـ Claude Code. كتوصف ماكينة فسطر واحد، وClaude كيقلب على معلومات الجهاز الحقيقي قبل ما يولّد محاكاة ثلاثية الأبعاد تفاعلية وواقعية بحال التصوير، فملف HTML واحد.

الصفحات المولّدة تقدر تمثّل الآليات، المحركات، الآلات، والمعدات الصناعية. كتستعمل هندسة إجرائية بـ three.js، ونِسَب حقيقية، ومكوّنات مسمّاة، ومواد، وأنماط تفاعلية، وحلّ فيزيائي صغير مناسب للماكينة. تقدر تحل ملف HTML الناتج فالمتصفح، وتفحص القطع ديالو، وتبدّل ظروف التشغيل، وتفتح الماكينة من الداخل، أو تخليها تخسر فحالة عطل محسوبة.

المشروع فيه حتى مسجّل لإنتاج أفلام، لقطات شاشة، وصيغ مخصّصة لوسائل التواصل الاجتماعي انطلاقاً من الصفحات المولّدة.

أهم المزايا

• بناء واقعي للماكينات: النماذج فيها أبعاد حقيقية، وقطع مسمّاة، ومكوّنات صلبة، وريش، وتروس، وبراغي، وأنابيب، وهندسة إجرائية أخرى.
• سلوك مبني على الفيزياء: حلالات بحال نماذج دورة Brayton، وفوهة الصاروخ، ومنحنى المضخة، والمذبذب الالتوائي، وDarcy، وKienzle كتحرّك الحركة والقيم المعروضة.
• عرض تفاعلي: الصفحات كتدعم السحب، والتوقيف المؤقت، والتسميات المباشرة، والحركة البطيئة، وعروض تفكيك التجميعة، وعروض الأشعة السينية، والقطع مع أسطح مقطعية صلبة.
• تصيير بجودة الاستوديو: بيئة التشغيل كتوفّر المواد، والإضاءة، والظلال، والإضاءة المحيطة، والتوهّج، وتوهّج الحرارة، وبيئات العرض.
• أفلام حتمية: نمط الفيلم كيخلّي المسجّل يقدّم المحاكاة إطاراً بإطار، باش تخرج التسجيلات المتكررة بنفس الشكل.
• بلا مرحلة بناء: الصفحات المولّدة ملفات HTML مستقلة، كتستعمل بيئة تشغيل مضمّنة واعتمادية three.js 0.170 مثبتة من CDN.

المتطلبات

باش تبني الماكينات، نصّب Claude Code أو استعمل مضيفاً آخر كيدعم Agent Skills. باش تشغّل الصفحات المولّدة، استعمل متصفحاً فيه WebGL 2، بحال الإصدارات الحالية لسطح المكتب من Chrome أو Safari أو Firefox أو Edge.

بالنسبة للقطات الشاشة والأفلام، خاصك حتى Node 18 أو أحدث، وPlaywright، وChromium، وffmpeg.

npm i -D playwright
npx playwright install chromium

نصّب ffmpeg باستعمال مدير الحزم ديال نظام التشغيل. التليفونات تقدر تشغّل الصفحات الخفيفة، ولكن المحاكاة المعقّدة كتخدم أحسن فحاسوب حديث فيه GPU حقيقي.

تثبيت Machine Skill

التثبيت الموصى به كيستعمل skills CLI وكيثبّت المستودع كمهارة لـ Claude Code.

npx skills add AirsupHQ/machine-skill -g -a claude-code

التثبيت العام كيحط المهارة فـ ~/.claude/skills/machine. باش تثبّتها غير فالمشروع الحالي، حيد الخيارات ديال global وagent:

npx skills add AirsupHQ/machine-skill

تثبيت المشروع كيحط المهارة فـ .claude/skills/machine. وتقدر حتى تنسخ المستودع مباشرة:

git clone https://github.com/AirsupHQ/machine-skill.git ~/.claude/skills/machine

# Or install into one project
git clone https://github.com/AirsupHQ/machine-skill.git .claude/skills/machine

Claude Code كيتعرّف عادةً على المهارات الجديدة فالجلسة اللي خدامة. إلا ما كانش مجلد المهارات موجود ملي بدات الجلسة، شغّل /reload-skills.

ولّد أول ماكينة ديالك

من بعد التثبيت، حل Claude Code واستعمل الأمر /machine متبوعاً بوصف دقيق.

/machine a mechanical watch movement, the escapement ticking

Claude كينشئ صفحة HTML بحال watch.html. حل داك الملف فمتصفح فيه WebGL 2 وتفاعل مع المحاكاة. على حساب الماكينة المولّدة، تقدر تجرّ العرض، وتفحص التسميات، وتفكّك التجميعة، وتفتحها من الداخل، أو تشغّل سلوك العطل الممثّل فيها.

أمثلة أخرى على أوامر صالحة:

• /machine a hydroelectric Francis turbine
• /machine a Swiss lever escapement, slowed down so I can see the impulse
• /machine the gearbox of a 5 MW wind turbine, cut open
• /machine a steam locomotive's valve gear, and give me a 30 second video for X

كتب أوامر أحسن للماكينات

Machine Skill كيخدم أحسن ملي كيكون الأمر فيه سياق هندسي كافي باش Claude يبحث على الجسم المقصود ويختار نقطة تشغيل مفيدة.

1. سمّي الماكينة الحقيقية. أمر بحال “a turbofan like the ones on a 787” كيعطي توجيهاً أكثر من “a jet engine”.
2. حدّد الحركة وسلوك العطل. شرح شنو خاصو يتحرّك وشنو خاصو يتكسّر، بحال تطلب من Claude يطلع سرعة المحرك حتى تطفو الصمامات.
3. وصف فين غادي تستعمل النتيجة. قول لـ Claude واش الخرج مخصّص لصفحة مضمّنة، أو لفيديو اجتماعي، أو لصورة ثابتة. بالنسبة للفيديو، ضمّن نسبة الأبعاد أو المدة المطلوبة.

الفيزياء المولّدة هي نموذج صغير وصريح، ماشي CFD ولا FEA. كل صفحة كتشرح شنو كتحسب وشنو كتبرّط، لذلك اعتبر القيم تعليمية وتوضيحية، وماشي نتائج هندسية معتمدة.

سجّل فيلماً

استعمل السكريبت record.mjs ديال المستودع باش تصيّر صفحة مولّدة فملف فيديو.

node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_Lemon

إلا كنت خدام من مستودع منسوخ، استعمل المسار المحلي ديال السكريبت:

node scripts/record.mjs examples/turbofan.html out/turbofan.mp4 --music freepd:Classical/Easy_Lemon

تقدر تنشئ فيديو عمودي للـ feed بتحديد أبعاد الخرج:

node scripts/record.mjs examples/turbofan.html out/turbofan-feed.mp4 --w 1080 --h 1350

باش تصدّر لقطات ثابتة مختارة بلاصة الفيديو، عطِ مجلد الإخراج وأرقام اللقطات:

node scripts/record.mjs examples/turbofan.html out/stills --stills 3,9,14,19

المسجّل كيدعم حتى تحكّمات إضافية فالرندرة. استعمل --ss 1.5 لأخذ عينات بدقّة أعلى، و--blur 2 لطمس الحركة، و--fps 60 للحركة السريعة. الموسيقى تقدر تكون ملف محلّي، ولا رابط، ولا مقطع بصيغة freepd:<Category>/<Name> من FreePD.

الصفحات المولّدة تقدر تخدم فمود الفيلم المحدّد باستعمال بارامترات فالرابط بحال ?film=1&shot=main. فهاد المود، الوقت كيتقدّم غير ملي المسجّل كيدوزو، وهاد الشي كيخلّي كل فريم مترندر مزيان وكيخلّي الإعادات المتكررة متناسقة.

تأكّد من الإخراج المترندر

Machine Skill فيه إجراءات حماية ضدّ أعطاب الرندرة بلا واجهة. المسجّل كيتحقّق من السكرينشوتات باش يلقا الفريمات اللي لونها ماجنتا كامل، وpinkscan.mjs يقدر يفتّش فالفيديوهات كاملة.

node scripts/pinkscan.mjs out/*.mp4

إلى تكتاشف فريم وردي، الأمر كيسالي بحالة غير ناجحة، وهاد الشي كيخلّيه مناسب لسيرورة آلية.

استكشف المستودع

• SKILL.md كيحدّد مستوى الجودة، وسيرورة البحث والنمذجة، وجولات النقد، وطريقة إنتاج الفيلم، وأسلوب الكتابة اللي كيبان فالشاشة.
• kit/lab-kit.js هو الرانتايم اللي كيتضمّن داخل الصفحات المولّدة. فيه الستوديو، ومعالجة ما بعد الرندرة، والمواد، ومساعدات الهندسة، واللّيبلات، والتأثيرات، وأوضاع التفاعل، والخط الزمني ديال الفيلم.
• kit/template.html هو قالب الصفحة الابتدائي للآلات اللي كتتصاوب يدوياً.
• references/solvers.md فيه وصفات الفيزياء وثوابت حقيقية لآلات بحال التوربينات الغازية، والصواريخ، ومحركات المكابس، والمضخات، والدوّارات، والآلات الكهربائية.
• scripts/ فيه أدوات السكرينشوتات، والتسجيل، وفحص الفريمات الوردية، وإدماج الرانتايم.
• examples/ فيه أمثلة HTML مستقلة، من بينها توربوفان، ومحرك صاروخي، ومضخة للمعالجة، وضاغط.
• film/launch.html هي صفحة المخرج المستعملة ففيلم الإطلاق.

فهم المقطع التفاعلي

نظام المقطع كيخدم مع مجسّمات مسدودة ومستويات القطع. ملي مستوى كيفتح مجسّماً، الرانتايم كيتعرّف على سطح المقطع وكيعرض وجه مقطع صلب بالمظهر المشغول ديال المادة ومعاه تهشير خفيف. وبما أن عمق المقطع مكتوب بشكل صحيح، المقطع يقدر يحجب هندسة أخرى بلا حاجة لشبكات أغطية منفصلة.

هاد الشي كيخلّي موضع القطع يدوز عبر النموذج مع الحفاظ على وجه معدني أو مادي مقنع. نفس الرانتايم كيدعم حتى المقاطع النصّية والربعية، والعرض بالأشعة السينية، والتجميعات المفككة، واللّيبلات، وآثار الجريان، والأعمدة، والشرر، والحطام الصلب.

كيّف سيرورة العمل مع مضيفين آخرين للوكلاء

Machine Skill مجمّع كـ Agent Skill عادي. فـ Claude.ai ولا تطبيق Claude المكتبي، تقدر تضغط مجلد المهارة فملف zip وترفعو من Settings ثم Capabilities ثم Skills. وبالنسبة لـ Claude Agent SDK ولا API، ركّب المجلد كمجلد مهارة. الأدوات الأخرى المتوافقة مع Agent Skills تقدر تشير مباشرة إلى SKILL.md.

إلى ما كنتيش كتستعمل وكيلاً، نسخ kit/template.html وعمّر الأقسام ديالو بيدك. الصفحات المولّدة كتبقى ملفات HTML عادية كتخدم فالمتصفّح.

عرف الحدود

• المهارة مخصّصة للآلات، والميكانيزمات، والمحركات، والأجهزة، والمعدات. الناس، والمناظر الطبيعية، والخرائط حالات استعمال أضعف.
• الهندسة هي محتوى إجرائي مبني بـ three.js. الهدف ديالها هو نسب دقيقة وعدد صحيح ديال الأجزاء، ماشي تحمّلات التصنيع ولا الدقّة ديال تصدير CAD.
• نماذج الفيزياء صغيرة وشفافة عن قصد. كتتراجع بمقارنتها مع أرقام منشورة للعموم، ولكن ماشي بديل على CFD ولا FEA ولا التحليل الهندسي المعتمد.
• الصفحات المعقّدة تقدر تضم تقريباً 600,000 مثلث، وقد تحتاج إلى GPU حديث ديال حاسوب محمول باش تحافظ على أداء سلس مع الظلال، والحجب المحيطي، والتوهّج.

الخلاصة

Machine Skill كيحوّل برومبت هندسي مختصر لمحاكاة قابلة للاستكشاف فالمتصفّح، بنسب حقيقية، وسلوك محسوب، ورندرة واجدة للعرض. ثبّتو باستعمال skills CLI، ووصف آلة محدّدة مع متطلبات واضحة للحركة والأعطاب، ومن بعد حلّ صفحة HTML المولّدة. ملي تكون واجد للنشر، استعمل المسجّل المحدّد زمنياً باش تنتج فيديوهات ولا لقطات ثابتة من نفس المحاكاة.