Jenga na Uhakiki Video Fupi za Mwendo kwa Kutumia Ujuzi wa Motion Video Production wa Claude Code

Uzalishaji wa Video za Mwendo ni Nini?

Uzalishaji wa Video za Mwendo ni ujuzi wa Claude Code unaoongoza uundaji wa michoro na video za mwendo zenye urefu wa sekunde 30–90, kuanzia mipango ya awali hadi uhariri wa mwisho. Badala ya kuchukulia uundaji wa video kama agizo moja, hugawanya uzalishaji katika hatua sita na kuthibitisha matokeo ya kila hatua kabla ya kuendelea na kazi.

Hifadhi hii inajumuisha hati ya vizuizi katika harness/gate.py. Kila kizuizi hupima vielelezo husika na kurudisha msimbo wa kutoka: 0 inamaanisha hatua imefaulu, huku 1 ikimaanisha matokeo yamezuiwa na lazima yasahihishwe. Mradi huu pia unaandika matatizo 29 yanayojirudia katika uzalishaji kwenye references/gotchas.md.

Vipengele Muhimu

• Mtiririko wa uzalishaji wa hatua sita: upangaji wa hadithi, muundo wa wahusika, fremu muhimu, klipu za video, sauti, na uhariri wa mwisho.
• Vizuizi vya ubora vinavyopimika: hati hukagua faili, muda, idadi ya fremu, uwiano wa picha, sifa za sauti, na mahitaji mengine mahususi ya kila hatua.
• Vituo vya ukaguzi wa binadamu: masuala ya kuona ambayo hayawezi kutathminiwa kwa kutegemewa kupitia kipimo cha nambari lazima yakaguliwe na kurekodiwa na mtu.
• Mwongozo wa uthabiti wa wahusika: vigezo saba husaidia kudumisha mwonekano, sauti, ulandanishi wa midomo, muda wa muziki, na ubora wa jumla katika mipaka ya matukio.
• Uundaji wa mikanda ya fremu: kizuizi cha klipu huunda mikanda ya picha inayoonyesha mabadiliko ya wahusika yanayotokea baada ya fremu ya mwanzo.
• Marejeleo ya matatizo yanayojulikana: gotcha 29 zinaeleza dalili, sababu, hatua za kuzuia, na vitambulisho vinavyohusiana vya ukaguzi wa harness.
• Violezo na hati zinazoweza kutumika tena: hifadhi hii inajumuisha violezo vya kupanga na zana za kugundua nakala, gridi za midundo, laha za klipu, uchanganyaji wa sauti, muxing, na uthibitishaji.

Mahitaji ya Awali

Unahitaji Claude Code, Python 3, ffmpeg, na ffprobe

Msimbo wa uundaji wa Remotion haujajumuishwa katika hifadhi hii. Sakinisha Remotion kando na uunde muundo unaohitajika na mradi wako.

Zana za hiari za uundaji zinazotajwa na mradi huu ni pamoja na ChatGPT au Grok Imagine kwa picha na video, Suno kwa muziki, ElevenLabs au Fish Audio kwa sauti, na Whisper kwa ukaguzi unaotegemea unukuzi. README inaeleza kuwa muunganisho wa Whisper katika verify.sh haujathibitishwa.

Sakinisha Ujuzi wa Claude Code

Claude Code hutambua ujuzi katika ~/.claude/skills/<skill-name>/SKILL.md. Nakili hifadhi, unda saraka ya skills, kisha unakili folda kamili ya ujuzi ndani yake:

git clone https://github.com/unclejobs-ai/motion-video-skill.git
mkdir -p ~/.claude/skills
cp -r motion-video-skill/skills/motion-video-production ~/.claude/skills/

Saraka nzima ya motion-video-production lazima inakiliwe kwa sababu harness, marejeleo, hati, na violezo vyake hufanya kazi pamoja.

Sakinisha kwa Mradi Mmoja Pekee

Ikiwa ujuzi unapaswa kupatikana ndani ya mradi fulani pekee, nakili folda hiyo hiyo kwenye saraka ya .claude/skills/ ya mradi huo badala ya saraka ya kimataifa.

mkdir -p your-video-project/.claude/skills
cp -r motion-video-skill/skills/motion-video-production \
  your-video-project/.claude/skills/

Washa upya Claude Code baada ya kunakili ujuzi ili iweze kutambua SKILL.md mpya.

Thibitisha Harness

Kutoka kwenye hifadhi iliyokopiwa, endesha jaribio la harness yenyewe:

bash skills/motion-video-production/harness/selftest.sh

Msimbo wa kutoka wa 0 unathibitisha kuwa harness ya vizuizi inafanya kazi kwenye kompyuta ya sasa. Jaribio likishindwa, kwanza thibitisha kuwa Python 3, ffmpeg, na ffprobe zimesakinishwa na zinapatikana kwenye njia ya amri.

Anzisha Mradi wa Video

Fungua Claude Code na ueleze video unayotaka kutengeneza. Kwa mfano:

Ningependa kutengeneza video ya ufunguzi ya sekunde 30 yenye mhusika.

Kabla ya uzalishaji kuanza, Claude huuliza kuhusu masharti manne:

1. Jinsi video itakavyochapishwa au kusambazwa.
2. Muda na uwiano wa picha unaokusudiwa.
3. Zana zinazopatikana kwa uzalishaji.
4. Vipengele ambavyo havipaswi kuonekana kwenye matokeo.

Baada ya maswali haya kujibiwa, ujuzi huanza na STORY.md na kuendelea kupitia hatua kwa mpangilio.

Elewa Mtiririko wa Hatua Sita

Mtiririko huu huunda vielelezo kama vile STORY.md, character.txt, key/, clip/, voices.json, na edit.json. Kila kielelezo huwa ingizo la hatua inayofuata, kwa hiyo hatua haipaswi kurukwa kwa sababu tu matokeo yake yanaonekana kukubalika kwa mtazamo wa kwanza.

1. Upangaji wa Hadithi na Matukio

Kizuizi cha story hukagua sehemu ambazo hazijakamilika, taarifa ya BPM, nyakati za nambari katika jedwali la ulandanishi wa muziki, na jedwali la matukio. Kiendeshe kwa kutumia saraka ya mradi kama hoja ya pili:

python3 harness/gate.py story /path/to/video-project

Sahihisha makosa ya upangaji kabla ya kuunda midia ya gharama kubwa. Hasa, weka muda wa muziki na muundo wa matukio mapema vya kutosha ili mikato ya baadaye ifuate gridi ya midundo.

2. Laha ya Mhusika

Kizuizi cha character hukagua kuwa character.txt ni aya moja ya maandishi wazi, inajumuisha maelezo ya rangi, na inaambatana na picha inayohitajika ya laha ya mhusika.

python3 harness/gate.py character /path/to/video-project

Maelezo ya mwonekano usiobadilika na karatasi ya mhusika hutoa marejeleo ya pamoja ya kuona kwa keyframe na klipu zitakazofuata.

3. Keyframe

Gate ya keyframes hugundua faili zilizorudiwa na hukagua uwiano wa pande unaotarajiwa na klipu.

python3 harness/gate.py keyframes /path/to/video-project

Keyframe si picha za kupanga tu. Pia hutumika kama fremu ya kuanzia inayotarajiwa kwa klipu za video zinazozalishwa.

4. Klipu za Video

Gate ya clips hukagua muda, idadi ya fremu, na ikiwa klipu inaanza na keyframe inayotarajiwa. Pia hutengeneza mikanda ya fremu na huhitaji uamuzi uliorekodiwa kwa kila klipu.

python3 harness/gate.py clips /path/to/video-project

Klipu inaweza kufanana na keyframe yake mwanzoni na bado ikabadilisha mavazi, miwani, nywele, au uso wa mhusika sekunde moja au mbili baadaye. Kwa sababu hii, gate huunda faili za qa/strip-<clip>.png zenye keyframe na fremu za sekunde 0, 1.0, 1.5, 2.0, na 3.0.

Fungua mikanda hiyo, kagua fremu za baadaye, na rekodi matokeo katika qa/clips-review.md. Vipimo vya ufanano kama SSIM haviwezi kutofautisha kwa uhakika mwendo uliokusudiwa wa mhusika na mgeuko usiotakiwa wa mhusika, kwa hiyo fremu za baadaye zinahitaji uamuzi wa binadamu.

5. Muziki na Sauti

Gate ya audio hukagua kuwa mradi unatumia kitambulisho kimoja cha sauti na una faili za mazungumzo zinazohitajika.

python3 harness/gate.py audio /path/to/video-project

Pima muda wa mazungumzo kabla ya kukamilisha urefu wa mikato. La sivyo, mstari wa mazungumzo unaweza usitoshee kwa njia ya kawaida ndani ya tukio ulilopewa.

6. Kuunganisha na Ukaguzi wa Mwisho

Hatua ya mwisho hutumia gate za edit na final. Ukaguzi huu unahusu gridi ya midundo, miunganiko ya mikato, mikato inayojirudia, muda wa mazungumzo, idadi ya fremu, uwepo wa sauti, loudness, kilele halisi, na rekodi ya ukaguzi inayohitajika.

python3 harness/gate.py edit /path/to/video-project
python3 harness/gate.py final /path/to/video-project

Matokeo ya ukaguzi wa kuona wa kazi iliyokamilika lazima yarekodiwe katika qa/review.md. Vipimo vya kiotomatiki havichukui nafasi ya ukaguzi huu.

Jinsi ya Kujibu Gate Iliyokwama

Tumia mzunguko huo wa marekebisho katika kila hatua:

1. Endesha python3 harness/gate.py <stage> <project-directory>.
2. Kagua msimbo wa kutoka wa mchakato.
3. Ikiwa msimbo ni 0, endelea hadi hatua inayofuata.
4. Ikiwa msimbo ni 1, fungua qa/gate-<stage>.txt.
5. Tafuta mistari iliyowekwa alama BLOCK.
6. Rekebisha kifaa kinachohusika.
7. Endesha gate hiyo hiyo tena hadi ipite.

Usifiche amri nyuma ya pipeline kama python3 harness/gate.py clips project | tail. Pipeline inaweza kubadilisha hali ya kutoka ya gate na kutumia hali ya amri ya mwisho, na hivyo kufanya gate iliyoshindwa ionekane kuwa imefaulu.

Vidokezo vya Juu vya Uzalishaji

Dumisha Utambulisho wa Mhusika katika Kila Muunganisho

Mradi unaainisha vigezo saba vya uthabiti: karatasi ya mhusika, maelezo ya mwonekano usiobadilika, picha ya kuanzia ya keyframe, sauti isiyobadilika, mazungumzo na mwendo wa midomo, upangaji na midundo ya muziki, na ukaguzi wa ubora. Angalia references/consistency-7.md ili kuona mahali kila kigezo kinapotumika katika mtiririko wa kazi wa hatua sita.

Jenga Mikato kwa Midundo, Sio Sekunde za Kubahatisha

Chagua urefu wa mikato kama vizidishi vya midundo ya muziki. Unapobadilisha muda uliokusanywa kuwa fremu, zungusha fremu ya kuanzia mara moja kutoka kwenye muda uliokusanywa badala ya kuzungusha kila sehemu moja moja mara kwa mara. Hii hupunguza kuachana kwa muda na hufuata mwongozo unaohusishwa na changamoto G11 na G12.

Pima Usemi Kabla ya Kufunga Uhariri

Tengeneza au pima mazungumzo kabla ya kuamua muda wa mwisho wa mkato. Mpangilio huu huzuia mazungumzo kubanwa ndani ya tukio fupi kupita kiasi na hushughulikia changamoto G13.

Tumia Matokeo Yanayotegemeka ya ffprobe

Video zenye profaili za ICC zinaweza kusababisha ffprobe -of csv=p=0 kuchapisha idadi ya fremu kama 30,. Mradi unapendekeza matokeo chaguo-msingi bila vifungashio au funguo:

ffprobe -of default=nw=1:nk=1 ...

Hifadhi Ucheleweshaji wa Sauti Wakati wa Kuchuja

Unapotumia ffmpeg, kutumia apad na atrim baada ya adelay kunaweza kuondoa ucheleweshaji uliokusudiwa. Mwongozo wa changamoto wa mradi unahitaji asetpts=N/SR/TB katika hali hii.

Tumia Marejeleo Yaliyojumuishwa Kabla ya Kutatua Matatizo Bila Mwongozo

Fungua skills/motion-video-production/references/gotchas.md wakati hatua inashindwa mara kwa mara au media inayozalishwa inabadilika bila kutarajiwa. Kila mojawapo ya maingizo yake 29 hurekodi dalili, sababu inayowezekana, hatua ya kuzuia, na kitambulisho cha ukaguzi wa harness kinachohusika.

Vipengele vya Hifadhi Vinavyostahili Kujulikana

• SKILL.md ina maagizo ya ujuzi wa Claude Code.
• harness/gate.py hufanya ukaguzi wa kupitisha au kuzuia kulingana na hatua.
• harness/selftest.sh huthibitisha usakinishaji wa harness.
• scripts/ ina ukaguzi wa nakala, utengenezaji wa karatasi za klipu, key plate, utengenezaji wa gridi ya midundo, uchanganyaji, muxing, na zana za uthibitishaji.
• templates/ ina violezo vya hadithi, karatasi za wahusika, vidokezo, na ukaguzi wa matukio.
• references/ ina mwongozo wa uthabiti, maelezo ya gridi ya midundo, kanuni za gharama, dokezo za zana, maelezo ya leseni, na changamoto za uzalishaji.
• NOTICE.md inatoa muhtasari wa mambo ya kuzingatia kuhusu zana za nje.

Leseni na Wajibu

Hazina yenyewe hutumia leseni ya MIT, lakini zana za nje za uundaji zina bei, matumizi, na masharti yao ya leseni ya kibiashara. Kagua NOTICE.md na references/licensing.md, kisha thibitisha masharti ya sasa moja kwa moja kabla ya matumizi ya uzalishaji kwa sababu bei na sera zinaweza kubadilika. Wajibu kuhusu rasilimali zilizoundwa unasalia chini ya notisi hizo na masharti ya nje.

Hitimisho

Motion Video Production hubadilisha uundaji wa video fupi kuwa mtiririko wa kazi unaoweza kurudiwa na kujaribiwa. Thamani yake kuu si zana moja ya uundaji, bali ni mfuatano uliopangiliwa unaounganisha mipango, marejeleo ya wahusika, fremu muhimu, klipu, sauti, na uhariri wa mwisho. Kwa kuchukulia kushindwa kwa lango kama kazi ya marekebisho badala ya kuliruka, na kwa kukamilisha ukaguzi wa lazima wa kuona, unaweza kugundua matatizo ya mwendelezo, muda, na uwasilishaji kabla hayajafikia video iliyokamilika.