
Machine Skill nima qiladi
Machine Skill — Claude Code uchun ochiq kodli Agent Skill. Siz mashinani bir qatorda tasvirlaysiz, Claude esa avval haqiqiy qurilmani o‘rganadi, so‘ngra bitta HTML faylida fotorealistik, interaktiv 3D simulyatsiya yaratadi.
Yaratilgan sahifalar mexanizmlar, dvigatellar, asboblar va sanoat uskunalarini tasvirlashi mumkin. Ularda procedural three.js geometriyasi, haqiqiy nisbatlar, nomlangan komponentlar, materiallar, interaktiv rejimlar va mashinaga mos kichik fizik hisoblagichdan foydalaniladi. Natijadagi HTML faylini brauzerda ochib, qismlarini ko‘rishingiz, ish sharoitlarini o‘zgartirishingiz, ichini kesib ko‘rishingiz yoki hisoblangan nosozlik sharoitida uni ishdan chiqarishingiz mumkin.
Loyihada yaratilgan sahifalardan takrorlanadigan videolar, skrinshotlar va ijtimoiy tarmoqlar formatlarini tayyorlash uchun recorder ham mavjud.
Asosiy imkoniyatlar
- Haqiqiy mashina konstruksiyasi: modellar haqiqiy o‘lchamlar, nomlangan qismlar, yaxlit komponentlar, parraklar, tishli g‘ildiraklar, boltlar, quvurlar va boshqa procedural geometriyani o‘z ichiga oladi.
- Fizikaga asoslangan xatti-harakat: Brayton sikli, raketa soplosi, nasos xarakteristikasi, torsion osillyatori, Darcy va Kienzle kabi hisoblagichlar harakat hamda ko‘rsatiladigan qiymatlarni boshqaradi.
- Interaktiv taqdimot: sahifalar sudrash, pauza qilish, jonli yorliqlar, sekin harakat, portlatilgan ko‘rinish, rentgen ko‘rinishi va yaxlit kesim yuzalariga ega kesib ko‘rsatish rejimlarini qo‘llab-quvvatlaydi.
- Studiyaviy sifatdagi render: runtime materiallar, yoritish, soyalar, atrof-muhit okklyuziyasi, bloom, issiqlik nuri va taqdimot muhitlarini taqdim etadi.
- Deterministik videolar: film rejimi recorder simulyatsiyani kadrma-kadr oldinga siljitishiga imkon beradi, shu sababli takroriy yozuvlar bir xil render qilinadi.
- Build bosqichisiz: yaratilgan sahifalar ichiga joylangan runtime va three.js 0.170 CDN’iga mahkamlangan bog‘liqlikdan foydalanadigan mustaqil HTML fayllaridir.
Talablar
Mashinalarni yaratish uchun Claude Code dasturini o‘rnating yoki Agent Skills’ni qo‘llab-quvvatlaydigan boshqa hostdan foydalaning. Yaratilgan sahifalarni ishga tushirish uchun WebGL 2’ni qo‘llab-quvvatlaydigan brauzer, masalan, Chrome, Safari, Firefox yoki Edge’ning joriy desktop versiyasi kerak.
Skrinshotlar va videolar uchun Node 18 yoki undan yangiroq versiya, Playwright, Chromium va ffmpeg ham kerak.
npm i -D playwright
npx playwright install chromiumffmpeg’ni operatsion tizimingiz paket menejeri orqali o‘rnating. Telefonlarda yengilroq sahifalar ishlashi mumkin, ammo murakkab simulyatsiyalar haqiqiy GPU’ga ega zamonaviy kompyuterda eng yaxshi ishlaydi.
Machine Skill’ni o‘rnatish
Tavsiya etiladigan o‘rnatish usuli skills CLI’dan foydalanadi va repozitoriyni Claude Code skill’i sifatida o‘rnatadi.
npx skills add AirsupHQ/machine-skill -g -a claude-codeGlobal o‘rnatish skill’ni ~/.claude/skills/machine manziliga joylaydi. Uni faqat joriy loyiha uchun o‘rnatish uchun global va agent opsiyalarini olib tashlang:
npx skills add AirsupHQ/machine-skillUshbu loyiha o‘rnatishi skill’ni .claude/skills/machine manziliga joylaydi. Repozitoriyni bevosita klonlashingiz ham mumkin:
git clone https://github.com/AirsupHQ/machine-skill.git ~/.claude/skills/machine
# Yoki bitta loyihaga o‘rnating
git clone https://github.com/AirsupHQ/machine-skill.git .claude/skills/machineClaude Code odatda ishlayotgan sessiyada yangi skill’larni aniqlaydi. Agar sessiya boshlanganda skills katalogi mavjud bo‘lmagan bo‘lsa, /reload-skills buyrug‘ini ishga tushiring.
Birinchi mashinangizni yarating
O‘rnatishdan so‘ng Claude Code’ni oching va /machine buyrug‘idan keyin aniq tavsif kiriting.
/machine a mechanical watch movement, the escapement tickingClaude watch.html kabi HTML sahifa yaratadi. Ushbu faylni WebGL 2 brauzerida oching va simulyatsiya bilan ishlang. Yaratilgan mashinaga qarab, ko‘rinishni sudrashingiz, yorliqlarni ko‘rishingiz, yig‘mani portlatishingiz, ichini kesib ko‘rishingiz yoki modellashtirilgan nosozlik xatti-harakatini ishga tushirishingiz mumkin.
Boshqa yaroqli so‘rovlar:
/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
Yaxshiroq mashina so‘rovlarini yozing
Machine Skill so‘rov Claude’ga mo‘ljallangan obyektni o‘rganish va foydali ish nuqtasini tanlash uchun yetarli muhandislik kontekstini berganda eng yaxshi ishlaydi.
- Haqiqiy mashinani nomlang. “787 samolyotlaridagiga o‘xshash turbofan” kabi so‘rov “reaktiv dvigatel” so‘roviga qaraganda aniqroq yo‘nalish beradi.
- Harakat va nosozlik xatti-harakatini belgilang. Nima harakatlanishi va nima buzilishi kerakligini tushuntiring, masalan, Claude’dan dvigatel klapanlari suzib ketguncha uning aylanish tezligini oshirishni so‘rang.
- Mo‘ljallangan foydalanish joyini tasvirlang. Natija ichki sahifa, ijtimoiy tarmoq videosi yoki statik rasm uchun ekanini ayting. Video uchun mo‘ljallangan tomonlar nisbati yoki davomiylikni kiriting.
Yaratilgan fizika CFD yoki FEA emas, balki amaliyotga yaqin kichik modeldir. Har bir sahifa nimani hisoblashini va nimani soddalashtirishini tushuntiradi, shuning uchun qiymatlarni tasdiqlangan muhandislik natijalari emas, ta’limiy va tushuntiruvchi ma’lumot sifatida qabul qiling.
Video yozish
Yaratilgan sahifani video faylga render qilish uchun repozitoriyning record.mjs skriptidan foydalaning.
node ~/.claude/skills/machine/scripts/record.mjs watch.html out/watch.mp4 --music freepd:Classical/Easy_LemonKlonlangan repozitoriy bilan ishlaganda mahalliy skript yo‘lidan foydalaning:
node scripts/record.mjs examples/turbofan.html out/turbofan.mp4 --music freepd:Classical/Easy_LemonChiqish o‘lchamlarini belgilash orqali lenta uchun portret video yaratishingiz mumkin:
node scripts/record.mjs examples/turbofan.html out/turbofan-feed.mp4 --w 1080 --h 1350Video o‘rniga tanlangan statik kadrlarni eksport qilish uchun chiqish katalogi va kadr raqamlarini ko‘rsating:
node scripts/record.mjs examples/turbofan.html out/stills --stills 3,9,14,19Yozib oluvchi qo‘shimcha render boshqaruvlarini qo‘llab-quvvatlaydi. Supersampling uchun --ss 1.5, harakat xiraligi uchun --blur 2, tez harakat uchun esa --fps 60 dan foydalaning. Musiqa mahalliy fayl, URL yoki FreePD xizmatidagi freepd:<Category>/<Name> trek bo‘lishi mumkin.
Yaratilgan sahifalar ?film=1&shot=main kabi so‘rov parametrlari bilan deterministik film rejimida ishlashi mumkin. Bu rejimda vaqt faqat yozib oluvchi uni ilgarilatganda o‘tadi, natijada har bir kadr to‘liq render qilinadi va takroriy yozuvlar bir xil bo‘ladi.
Render qilingan chiqishni tekshirish
Machine Skill headless render xatolaridan himoyalanish vositalarini o‘z ichiga oladi. Yozib oluvchi bir xil magenta rangli kadrlarni tekshiradi, pinkscan.mjs esa tayyor videolarni skanerlashi mumkin.
node scripts/pinkscan.mjs out/*.mp4Agar pushti kadr aniqlansa, buyruq noldan farqli holat kodi bilan yakunlanadi, shuning uchun uni avtomatlashtirilgan ish jarayonida ishlatish mumkin.
Repozitoriyni o‘rganish
SKILL.mdsifat mezonlari, tadqiqot va modellashtirish jarayoni, tanqid bosqichlari, film jarayoni hamda ekrandagi matn uslubini belgilaydi.kit/lab-kit.jsyaratilgan sahifalarga joylashtiriladigan runtime hisoblanadi. Unda studiya, post-processing, materiallar, geometriya yordamchilari, yorliqlar, effektlar, o‘zaro ta’sir rejimlari va film vaqt jadvali mavjud.kit/template.htmlqo‘lda yaratiladigan mashinalar uchun boshlang‘ich sahifa shablonidir.references/solvers.mdgaz turbinalari, raketalar, porshenli dvigatellar, nasoslar, rotorlar va elektr mashinalari kabi qurilmalar uchun fizika formulalari hamda haqiqiy konstantalarni o‘z ichiga oladi.scripts/skrinshot olish, yozib olish, pushti kadrlarni tekshirish va runtime’ni joylashtirish vositalarini o‘z ichiga oladi.examples/turbofan, raketa dvigateli, texnologik nasos va kompressorni o‘z ichiga olgan mustaqil HTML namoyishlarini saqlaydi.film/launch.htmlishga tushirish filmi uchun ishlatiladigan rejissor sahifasidir.
Interaktiv kesimni tushunish
Kesim tizimi yopiq qattiq jismlar va kesish tekisliklari bilan ishlaydi. Tekislik qattiq jismni ochganda, runtime kesim yuzasini aniqlaydi va materialning ishlov berilgan ko‘rinishiga ega, nozik shtrixli qattiq kesim yuzasini render qiladi. Kesim chuqurligi to‘g‘ri yozilgani sababli, kesim alohida qopqoq to‘rlarini talab qilmasdan boshqa geometriyani to‘sib qo‘yishi mumkin.
Bu kesim holatini model bo‘ylab siljitish va shu bilan birga ishonarli metall yoki material yuzasini saqlash imkonini beradi. Xuddi shu runtime yarim va chorak kesimlar, rentgen ko‘rinishi, portlatilgan yig‘ilmalar, yorliqlar, oqim izlari, alangalar, uchqunlar va qattiq parchalalarni ham qo‘llab-quvvatlaydi.
Ish jarayonini boshqa agent xostlariga moslashtirish
Machine Skill standart Agent Skill sifatida paketlangan. Claude.ai yoki Claude desktop ilovasida skill jildini zip qilib, uni Settings, Capabilities va Skills bo‘limlari orqali yuklashingiz mumkin. Claude Agent SDK yoki API uchun jildni skill katalogi sifatida ulang. Agent Skills bilan mos boshqa vositalar SKILL.md fayliga to‘g‘ridan-to‘g‘ri yo‘naltirilishi mumkin.
Agar agentdan foydalanmasangiz, kit/template.html faylidan nusxa oling va uning bo‘limlarini qo‘lda to‘ldiring. Yaratilgan sahifalar brauzerda ishlaydigan oddiy HTML fayllari bo‘lib qoladi.
Cheklovlarni biling
- Skill mashinalar, mexanizmlar, dvigatellar, asboblar va qurilmalar uchun mo‘ljallangan. Odamlar, landshaftlar va xaritalar undan zaifroq foydalanish holatlaridir.
- Geometriya protseduraviy three.js kontentidir. U ishlab chiqarish toleranslari yoki CAD eksport aniqligiga emas, aniq nisbatlar va qismlar soniga intiladi.
- Fizika modellari ataylab kichik va shaffof yaratilgan. Ular ochiq manbalardagi ko‘rsatkichlar bilan tekshiriladi, biroq CFD, FEA yoki sertifikatlangan muhandislik tahlilining o‘rnini bosa olmaydi.
- Murakkab sahifalarda taxminan 600,000 ta uchburchak bo‘lishi mumkin; soyalar, atrof-muhit okklyuziyasi va bloom bilan silliq ishlashni ta’minlash uchun yangi noutbuk GPU’si kerak bo‘lishi mumkin.
Xulosa
Machine Skill qisqa muhandislik so‘rovini haqiqiy nisbatlar, hisoblangan xatti-harakatlar va taqdimotga tayyor renderga ega, brauzerda o‘rganiladigan simulyatsiyaga aylantiradi. Uni skills CLI orqali o‘rnating, aniq harakat va nosozlik talablari bilan muayyan mashinani tavsiflang, so‘ng yaratilgan HTML sahifani oching. Nashr qilishga tayyor bo‘lganingizda, xuddi shu simulyatsiyadan video yoki statik kadrlar yaratish uchun deterministik yozib oluvchidan foydalaning.
