Unda Uigaji Halisi wa Mashine Unaoshirikisha kwa Claude Code na Machine Skill

Machine Skill hufanya nini

Machine Skill ni Agent Skill ya chanzo huria kwa Claude Code. Unaeleza mashine kwa mstari mmoja, kisha Claude hufanya utafiti kuhusu kifaa halisi kabla ya kutengeneza simulizi ya 3D yenye uhalisia wa picha na mwingiliano, katika faili moja la HTML.

Kurasa zinazozalishwa zinaweza kuwakilisha mifumo ya kimitambo, injini, vyombo, na vifaa vya viwandani. Zinatumia jiometri ya three.js inayozalishwa kwa taratibu, uwiano halisi, vipengele vilivyopewa majina, vifaa, hali za mwingiliano, na kihesabu kidogo cha fizikia kinachofaa kwa mashine hiyo. Unaweza kufungua faili la HTML linalotokana katika kivinjari, kukagua sehemu zake, kubadilisha hali za uendeshaji, kulikata ili kuona ndani, au kulivunja chini ya hali ya hitilafu iliyokokotolewa.

Mradi huu pia unajumuisha kinasa video cha kutengeneza filamu, picha za skrini, na miundo ya mitandao ya kijamii inayoweza kurudiwa kutoka kwenye kurasa zinazozalishwa.

Vipengele muhimu

• Uundaji halisi wa mashine: miundo inajumuisha vipimo halisi, sehemu zilizopewa majina, vipengele imara, mabawa, gia, bolti, mabomba, na jiometri nyingine inayozalishwa kwa taratibu.
• Tabia inayoendeshwa na fizikia: vihesabu kama miundo ya mzunguko wa Brayton, nozeli ya roketi, mkondo wa pampu, kizungumishaji cha msokoto, Darcy, na Kienzle huendesha mwendo na thamani zinazoonyeshwa.
• Uwasilishaji wa mwingiliano: kurasa zinaweza kuburutwa, kusitishwa, kuonyesha lebo hai, mwendo wa polepole, mwonekano wa kutenganisha sehemu, mwonekano wa eksirei, na mipasuko yenye nyuso imara za sehemu.
• Utoaji wa kiwango cha studio: mazingira ya utekelezaji hutoa vifaa, mwanga, vivuli, kuzuiwa kwa mwanga wa mazingira, mwanga wa kung'aa, mwanga wa joto, na mazingira ya uwasilishaji.
• Filamu zinazotabirika: hali ya filamu huruhusu kinasa kuendeleza simulizi fremu kwa fremu, ili rekodi zinazorudiwa zitolewe kwa uthabiti.
• Hakuna hatua ya kuunda: kurasa zinazozalishwa ni faili za HTML zinazojitegemea, zikitumia mazingira ya utekelezaji yaliyojumuishwa ndani na utegemezi wa three.js 0.170 uliowekwa kwenye CDN.

Mahitaji

Ili kuunda mashine, sakinisha Claude Code au tumia mwenyeji mwingine anayeunga mkono Agent Skills. Ili kuendesha kurasa zinazozalishwa, tumia kivinjari chenye WebGL 2, kama matoleo ya sasa ya kompyuta za mezani ya Chrome, Safari, Firefox, au Edge.

Kwa picha za skrini na filamu, unahitaji pia Node 18 au mpya zaidi, Playwright, Chromium, na ffmpeg.

npm i -D playwright
npx playwright install chromium

Sakinisha ffmpeg kupitia kidhibiti cha vifurushi cha mfumo wako wa uendeshaji. Simu zinaweza kuendesha kurasa nyepesi, lakini simulizi changamano hufanya kazi vizuri zaidi kwenye kompyuta ya kisasa yenye GPU halisi.

Sakinisha Machine Skill

Usakinishaji unaopendekezwa hutumia CLI ya skills na kusakinisha hazina kama skill ya Claude Code.

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

Usakinishaji wa kimataifa huweka skill kwenye ~/.claude/skills/machine. Ili kuisakinisha kwa mradi wa sasa pekee, ondoa chaguo za global na agent:

npx skills add AirsupHQ/machine-skill

Usakinishaji huu wa mradi huweka skill kwenye .claude/skills/machine. Unaweza pia ku-clone hazina moja kwa moja:

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

# Au sakinisha kwenye mradi mmoja
git clone https://github.com/AirsupHQ/machine-skill.git .claude/skills/machine

Kwa kawaida Claude Code hutambua skills mpya katika kipindi kinachoendelea. Ikiwa saraka ya skills haikuwepo kipindi kilipoanza, endesha /reload-skills.

Tengeneza mashine yako ya kwanza

Baada ya usakinishaji, fungua Claude Code na utumie amri ya /machine ikifuatiwa na maelezo mahususi.

/machine a mechanical watch movement, the escapement ticking

Claude huunda ukurasa wa HTML kama vile watch.html. Fungua faili hilo katika kivinjari chenye WebGL 2 na uingiliane na simulizi. Kulingana na mashine iliyozalishwa, unaweza kuburuta mwonekano, kukagua lebo, kutenganisha mkusanyiko, kuikata ili kuona ndani, au kuanzisha tabia yake ya hitilafu iliyoigwa.

Mifano mingine ya maombi halali ni:

• /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

Andika maombi bora ya mashine

Machine Skill hufanya kazi vizuri zaidi wakati ombi linatoa muktadha wa kutosha wa kihandisi ili Claude afanye utafiti kuhusu kitu kinacholengwa na kuchagua hali muhimu ya uendeshaji.

1. Taja mashine halisi. Ombi kama “turbofan kama zile zilizo kwenye 787” hutoa mwongozo zaidi kuliko “injini ya ndege.”
2. Eleza mwendo na tabia ya hitilafu. Eleza kinachopaswa kusogea na kinachopaswa kuvunjika, kama kumwomba Claude aongeze mzunguko wa injini hadi vali zake zielelee.
3. Eleza mahali itakapotumika. Mwambie Claude ikiwa matokeo ni ya ukurasa uliopachikwa, video ya mitandao ya kijamii, au picha tuli. Kwa video, jumuisha uwiano wa pande au muda unaokusudiwa.

Fizikia inayozalishwa ni modeli ndogo ya kweli, si CFD wala FEA. Kila ukurasa hueleza inachokokotoa na inachorahisisha, kwa hiyo chukulia thamani hizo kuwa za kielimu na za kuonyesha, si matokeo ya uhandisi yaliyoidhinishwa.

Rekodi filamu

Tumia hati ya record.mjs ya hazina kutoa ukurasa uliotengenezwa kuwa faili la video.

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

Unapofanya kazi kutoka kwenye hazina uliyoi-clone, tumia njia ya hati ya ndani:

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

Unaweza kuunda video ya wima kwa mpasho kwa kuweka vipimo vya matokeo:

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

Ili kutoa fremu maalum zisizotembea badala ya video, toa saraka ya matokeo na nambari za fremu:

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

Kirekodi kinaunga mkono vidhibiti vya ziada vya uonyeshaji. Tumia --ss 1.5 kwa supersampling, --blur 2 kwa ukungu wa mwendo, na --fps 60 kwa mwendo wa kasi. Muziki unaweza kuwa faili ya ndani, URL, au wimbo wa freepd:<Category>/<Name> kutoka FreePD.

Kurasa zinazozalishwa zinaweza kuendeshwa katika hali ya filamu isiyobadilika kwa kutumia vigezo vya utafutaji kama vile ?film=1&shot=main. Katika hali hii, muda unasonga tu kirekodi kinapouendeleza, jambo linalofanya kila fremu itolewe kikamilifu na kufanya rekodi zinazorudiwa zifanane.

Angalia matokeo yaliyotolewa

Machine Skill ina ulinzi dhidi ya hitilafu za uonyeshaji usio na kiolesura. Kirekodi hukagua picha za skrini ili kubaini fremu zenye rangi ya magenta tupu, na pinkscan.mjs inaweza kuchanganua video zilizokamilika.

node scripts/pinkscan.mjs out/*.mp4

Fremu yenye rangi ya pinki ikigunduliwa, amri hutoka kwa hali isiyo ya sifuri, hivyo inaweza kutumika katika mtiririko wa kazi wa kiotomatiki.

Chunguza hazina

• SKILL.md hufafanua kiwango cha ubora, mtiririko wa utafiti na uundaji wa modeli, awamu za ukosoaji, mchakato wa filamu, na mtindo wa maandishi yanayoonekana kwenye skrini.
• kit/lab-kit.js ni runtime inayowekwa ndani ya kurasa zinazozalishwa. Ina studio, uchakataji wa baadae, nyenzo, visaidizi vya jiometri, lebo, madoido, hali za mwingiliano, na ratiba ya filamu.
• kit/template.html ni kiolezo cha ukurasa wa kuanzia kwa mashine zinazoundwa kwa mikono.
• references/solvers.md ina mapishi ya fizikia na viambajengo halisi kwa mashine kama mitambo ya gesi, roketi, injini za pistoni, pampu, rota, na mashine za umeme.
• scripts/ ina zana za picha za skrini, kurekodi, kukagua fremu za pinki, na kuweka runtime ndani ya kurasa.
• examples/ ina maonyesho ya HTML yanayojitegemea, yakiwemo turbofan, injini ya roketi, pampu ya mchakato, na kompresor.
• film/launch.html ni ukurasa wa mkurugenzi uliotumika kwa filamu ya uzinduzi.

Elewa mwonekano wa sehemu ya ndani

Mfumo wa kuonyesha sehemu ya ndani hufanya kazi kwa miili iliyofungwa na ndege za kukata. Ndege inapofungua mwili, runtime hutambua uso wa sehemu na kutoa uso thabiti wa sehemu hiyo wenye mwonekano wa nyenzo iliyotengenezwa kwa mashine pamoja na mistari midogo ya hatch. Kwa kuwa kina cha sehemu kimeandikwa kwa usahihi, mwonekano huu wa sehemu unaweza kuficha jiometri nyingine bila kuhitaji meshes tofauti za kufunika.

Hii huruhusu nafasi ya ukataji kusogea kupitia modeli huku ikihifadhi uso wa chuma au nyenzo unaoaminika. Runtime hiyo hiyo inaunga mkono sehemu za nusu na robo, uwasilishaji wa eksirei, mikusanyiko iliyolipuliwa, lebo, mistari ya mtiririko, mikia ya moshi, cheche, na vipande vigumu.

Badilisha mtiririko wa kazi kwa wapangishi wengine wa mawakala

Machine Skill imepakiwa kama Agent Skill ya kawaida. Katika Claude.ai au programu ya mezani ya Claude, unaweza kubana folda ya skill kuwa ZIP na kuipakia kupitia Settings, Capabilities, na Skills. Kwa Claude Agent SDK au API, weka folda hiyo kama saraka ya skill. Zana nyingine zinazooana na Agent Skills zinaweza kuelekezwa moja kwa moja kwenye SKILL.md.

Kama hutumii agent, nakili kit/template.html na ujaze sehemu zake kwa mikono. Kurasa zinazozalishwa hubaki kuwa faili za kawaida za HTML zinazoendeshwa kwenye kivinjari.

Tambua vikwazo

• Skill hii inalenga mashine, mifumo, injini, vifaa vya kupimia, na vifaa vingine. Watu, mandhari, na ramani si matumizi bora kwake.
• Jiometri ni maudhui ya three.js yanayozalishwa kimchakato. Inalenga uwiano sahihi na idadi ya sehemu, si ustahimilivu wa utengenezaji au usahihi wa kuhamisha CAD.
• Modeli za fizikia ni ndogo na wazi kimakusudi. Hukaguliwa dhidi ya takwimu za umma, lakini si mbadala wa uchanganuzi wa CFD, FEA, au uhandisi ulioidhinishwa.
• Kurasa changamano zinaweza kuwa na takribani pembetatu 600,000 na huenda zikahitaji GPU ya kisasa ya kompyuta mpakato ili kudumisha utendaji laini ikiwa na vivuli, occlusion ya mazingira, na bloom.

Hitimisho

Machine Skill hubadilisha agizo fupi la kihandisi kuwa uigaji wa kivinjari unaoweza kuchunguzwa, wenye uwiano halisi, tabia iliyokokotolewa, na uonyeshaji tayari kwa uwasilishaji. Isakinishe kwa kutumia skills CLI, eleza mashine mahususi yenye mahitaji yaliyo wazi ya mwendo na hitilafu, kisha fungua ukurasa wa HTML unaozalishwa. Ukiwa tayari kuchapisha, tumia kirekodi kisichobadilika ili kutoa video au picha zisizotembea kutoka kwenye uigaji huo huo.