صايب وراجَع فيديوهات حركية قصيرة باستعمال مهارة Motion Video Production فـ Claude Code

شنو هي صناعة فيديوهات الموشن؟

صناعة فيديوهات الموشن هي مهارة فـ Claude Code كتهدف لتنظيم إنشاء فيديوهات وموشن غرافيك كيدومو بين 30 و90 ثانية، من التخطيط الأولي حتى للتجميع النهائي. بلا ما تتعامل مع إنشاء الفيديو بحال إلا هو أمر واحد، كتقسم الإنتاج لست مراحل وكتتحقق من نتيجة كل مرحلة قبل ما تكمل الخدمة.

المستودع فيه سكريبت ديال البوابات فـ harness/gate.py. كل بوابة كاتقيس الملفات والنتائج المرتابطة بالمرحلة وكتردّ برمز خروج: 0 كيعني أن المرحلة دازت، و1 كيعني أن النتيجة موقوفة وخصها التصحيح. المشروع حتى هو موثّق 29 مشكل كيتعاودو فالإنتاج فـ references/gotchas.md.

الميزات الرئيسية

• مسار إنتاج من ست مراحل: تخطيط القصة، تصميم الشخصية، الإطارات الرئيسية، مقاطع الفيديو، الصوت، والتجميع النهائي.
• بوابات جودة قابلة للقياس: السكريبتات كاتراقب الملفات، التوقيت، عدد الإطارات، نسب العرض، خصائص الصوت، ومتطلبات أخرى خاصة بكل مرحلة.
• نقط مراجعة بشرية: المشاكل البصرية اللي مايمكنش يتحكم فيها مزيان مقياس رقمي خاص شخص يراجعها ويوثّقها.
• إرشادات للحفاظ على انسجام الشخصية: سبعة معايير كاتعاون تحافظ على الشكل، الصوت، تزامن الشفايف، التوقيت الموسيقي، والجودة العامة بين مشاهد مختلفة.
• إنشاء شرائط الإطارات: بوابة المقاطع كاتنشئ شرائط صور كاتبيّن تغييرات الشخصية اللي كتوقع من بعد الإطار الأول.
• مرجع للمشاكل المعروفة: 29 حالة مشكلة كاتشرح الأعراض، الأسباب، خطوات الوقاية، ومعرّفات فحوصات الـ harness المرتابطة بها.
• قوالب وسكريبتات قابلة لإعادة الاستعمال: المستودع فيه قوالب للتخطيط وأدوات لاكتشاف التكرار، وإنشاء شبكات الإيقاع، وأوراق المقاطع، وخلط الصوت، والدمج، والتحقق.

المتطلبات الأساسية

خاصك Claude Code، وPython 3، وffmpeg، وffprobe

كود ديال تركيبة Remotion ما داخلش فهاد المستودع. ثبّت Remotion بوحدو وصايب التركيبة اللي كيحتاجها المشروع ديالك.

أدوات الإنشاء الاختيارية اللي كيذكرها المشروع كاتشمل ChatGPT أو Grok Imagine للصور والفيديو، وSuno للموسيقى، وElevenLabs أو Fish Audio للأصوات، وWhisper للمراجعة المعتمدة على التفريغ الصوتي. ملف README كايذكر أن دمج Whisper فـ verify.sh مازال ما متحققش منو.

ثبّت مهارة Claude Code

Claude Code كايكتاشف المهارات فـ ~/.claude/skills/<skill-name>/SKILL.md. كلون المستودع، صايب مجلد المهارات، ونسخ مجلد المهارة كامل ليه:

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/

خاص يتنسخ مجلد motion-video-production كامل حيث الـ harness والمراجع والسكريبتات والقوالب خدامين مجموعين.

ثبّتها فمشروع واحد فقط

إلا بغيتي المهارة تكون متاحة غير داخل مشروع معيّن، نسخ نفس المجلد لمجلد .claude/skills/ ديال داك المشروع بلاصة المجلد العام.

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

عاود شغّل Claude Code من بعد ما تنسخ المهارة باش يقدر يكتاشف SKILL.md الجديد.

تحقق من الـ Harness

من المستودع اللي كلونّيتيه، شغّل الاختبار الذاتي ديال الـ harness:

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

رمز الخروج 0 كايأكد أن الـ harness خدام فالحاسوب الحالي. إلا فشل الاختبار، تأكد أولاً أن Python 3 وffmpeg وffprobe مثبّتين ومتاحين فمسار الأوامر ديالك.

بدا مشروع فيديو

حل Claude Code ووصف الفيديو اللي بغيتي تنتج. مثلاً:

بغيت نصايب فيديو افتتاحي مدتو 30 ثانية وكيبان فيه واحد الشخصية.

قبل ما يبدا الإنتاج، Claude كايسول على أربعة ديال القيود:

1. كيفاش غادي يتنشر الفيديو أو يتوزع.
2. المدة ونسبة العرض المقصودين.
3. الأدوات المتاحة للإنتاج.
4. العناصر اللي ماخاصهاش تبان فالنتيجة.

من بعد ما كتجاوب على هاد الأسئلة، المهارة كاتبدا بـ STORY.md وكتدوز على المراحل بالترتيب.

فهم مسار العمل من ست مراحل

مسار العمل كاينشئ ملفات بحال STORY.md، وcharacter.txt، وkey/، وclip/، وvoices.json، وedit.json. كل ملف كايولي مدخلاً لمرحلة من بعد، وداكشي علاش ماخاصش تتجاوز شي مرحلة غير حيث النتيجة ديالها باينة مقبولة من النظرة الأولى.

1. تخطيط القصة والمشاهد

بوابة story كاتتحقق من الخانات الناقصة، ومعلومات BPM، والأوقات الرقمية فجدول مزامنة الموسيقى، وجدول المشاهد. شغّلها مع مجلد المشروع كوسيط ثاني:

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

صلّح أخطاء التخطيط قبل ما تنشئ الوسائط المكلفة. بالخصوص، حدّد التوقيت الموسيقي وبنية المشاهد بكري بما يكفي باش القطوعات اللاحقة تتبع شبكة الإيقاع.

2. ورقة الشخصية

بوابة character كاتتحقق أن character.txt عبارة عن فقرة وحدة بالنص العادي، وفيها أوصاف الألوان، ومرفوقة بصورة ورقة الشخصية المطلوبة.

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

الوصف الثابت ديال المظهر وورقة الشخصيّة كيوفّرو مرجع بصري موحّد للإطارات الرئيسيّة والمقاطع اللي غادي يتدارو من بعد.

3. الإطارات الرئيسيّة

بوّابة keyframes كتكشف الملفات المكرّرة وكتتحقّق من نسبة العرض للارتفاع اللي كيتسناوها المقاطع.

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

الإطارات الرئيسيّة ماشي غير صور للتخطيط. حتى هي كتخدم كإطار البداية المتوقّع لمقاطع الفيديو المُولّدة.

4. مقاطع الفيديو

بوّابة clips ككتحقّق من المدّة، وعدد الإطارات، واش المقطع كيبدا بالإطار الرئيسي المتوقّع. وكتولّد حتى شرائط ديال الإطارات، وكتطلب تسجيل قرار لكل مقطع.

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

يقدر المقطع يطابق الإطار الرئيسي ديالو فالبداية، ومن بعد بثانية ولا جوج يبدّل لباس الشخصيّة، ولا النظارات، ولا الشعر، ولا ملامح الوجه. لهاد السبب، البوّابة كتنشئ ملفات qa/strip-<clip>.png فيها الإطار الرئيسي وإطارات فـ 0 و1.0 و1.5 و2.0 و3.0 ثواني.

حلّ الشرائط، عاين الإطارات المتأخّرة، وسجّل النتائج فـ qa/clips-review.md. مقاييس التشابه بحال SSIM ما كتقدرش تفرّق بشكل موثوق بين حركة الشخصيّة المقصودة والتشوّه غير المرغوب فيه، وهادشي علاش الإطارات المتأخّرة خاصها حكم بشري.

5. الموسيقى والصوت

بوّابة audio ككتحقّق بلي المشروع كيستعمل معرّف صوت واحد وعندو ملفات الحوار المطلوبة.

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

قِس مدّة الحوار قبل ما تثبّت مدَد القصّات النهائية. وإلا، يقدر سطر حواري ما يركبش بشكل طبيعي داخل المشهد المخصّص ليه.

6. التركيب والمراجعة النهائيّة

المرحلة الأخيرة كتستعمل بوّابتي edit وfinal. هاد الفحوصات كتغطّي شبكة الإيقاع، وروابط القصّات، والقصّات المكرّرة، ومدّة الحوار، وعدد الإطارات، ووجود الصوت، وعلوّ الصوت، والذروة الحقيقيّة، وسجلّ المراجعة المطلوب.

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

خاص نتائج المراجعة البصريّة ديال العمل كامل تتسجّل فـ qa/review.md. القياسات الآليّة ما كتعوّضش هاد المراجعة.

كيفاش تتصرّف مع بوّابة محجوبة

استعمل نفس دورة التصحيح فكل مرحلة:

1. شغّل python3 harness/gate.py <stage> <project-directory>.
2. تحقّق من رمز الخروج ديال العملية.
3. إلا كان الرمز هو 0، كمّل للمرحلة الموالية.
4. إلا كان الرمز هو 1، حلّ qa/gate-<stage>.txt.
5. قلّب على السطور اللي معلّمة بـ BLOCK.
6. صحّح العنصر المقابل.
7. عاود شغّل نفس البوّابة حتى تدوز.

ما تخبّيش الأمر ورا خطّ أنابيب بحال python3 harness/gate.py clips project | tail. خطّ الأنابيب يقدر يعوّض رمز خروج البوّابة برمز خروج الأمر الأخير، وبهذا يبان فشل البوّابة بحال إلا نجح.

نصائح متقدّمة للإنتاج

حافظ على ثبات هويّة الشخصيّة فكل وصلة

المشروع كيحدّد سبعة معايير للاتساق: ورقة الشخصيّة، ووصف ثابت للمظهر، وصورة البداية ديال الإطار الرئيسي، وصوت ثابت، والحوار وحركة الشفاه، والتوافق مع الإيقاع الموسيقي، ومراجعة الجودة. راجع references/consistency-7.md باش تعرف فين كيدخل كل معيار فمسار العمل ديال المراحل الست.

بني القصّات على الإيقاعات، ماشي على ثواني عشوائيّة

اختار مدَد القصّات كمضاعفات ديال الإيقاعات الموسيقيّة. ملي كتحوّل التوقيت المتراكم لإطارات، دوّر إطار البداية مرّة وحدة انطلاقاً من الوقت التراكمي، بلا ما تعاود تدوّر كل مقطع بشكل منفصل. هادشي كينقص انجراف التوقيت وكيوافق التوجيهات المرتبطة بالمشكلتين G11 وG12.

قِس الكلام قبل ما تثبّت المونتاج

ولّد الحوار ولا قِس مدّتو قبل ما تقرّر المدّة النهائيّة ديال القصّة. هاد الترتيب كيمنع تزاحم الكلام فمشهد قصير بزاف وكيعالج المشكل G13.

استعمل مخرجات موثوقة من ffprobe

الفيديوهات اللي فيها بروفايلات ICC تقدر تخلّي ffprobe -of csv=p=0 يطبع عدد الإطارات بحال 30,. المشروع كيوصي بالمخرجات الافتراضيّة بلا أغلفة ولا مفاتيح:

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

حافظ على تأخير الصوت أثناء التصفية

فاش كتستعمل ffmpeg، تطبيق apad وatrim من بعد adelay يقدر يحيد التأخير المقصود. توجيهات المشكل ديال المشروع كتطلب استعمال asetpts=N/SR/TB فهاد الحالة.

استعمل المراجع المرفقة قبل ما تبدا تشخّص المشاكل بالتخمين

حلّ skills/motion-video-production/references/gotchas.md ملي كتفشل مرحلة بشكل متكرّر ولا كتبدّل الوسائط المُولّدة بشكل غير متوقّع. كل واحد من الإدخالات الـ29 ديالو كيسجّل العَرَض، والسبب المحتمل، والإجراء الوقائي، ومعرّف فحص الـharness المرتبط به.

مكوّنات المستودع اللي مهم تعرفها

• SKILL.md فيه تعليمات مهارة Claude Code.
• harness/gate.py كينفّذ فحوصات النجاح ولا الحجب الخاصة بكل مرحلة.
• harness/selftest.sh كيتحقّق من تثبيت الـharness.
• scripts/ فيه أدوات التحقّق من التكرار، وتوليد أوراق المقاطع، واللوحات الرئيسيّة، وتوليد شبكة الإيقاع، والمزج، والدمج، والتحقّق.
• templates/ فيه قوالب للقصص، وأوراق الشخصيّات، والمطالبات، ومراجعات المشاهد.
• references/ فيه توجيهات الاتساق، ومعلومات شبكة الإيقاع، وقواعد التكلفة، وملاحظات الأدوات، ومعلومات الترخيص، ومشاكل الإنتاج الشائعة.
• NOTICE.md كيلخّص الاعتبارات المرتبطة بالأدوات الخارجيّة.

الترخيص والمسؤوليّة

المستودع براسو كيستعمل رخصة MIT، ولكن أدوات التوليد الخارجية عندها شروطها الخاصة فالثمن والاستعمال والترخيص التجاري. راجع NOTICE.md وreferences/licensing.md، ومن بعد تأكد من الشروط الحالية مباشرة قبل الاستعمال فالإنتاج، حيت الأثمنة والسياسات يقدرو يتبدلو. المسؤولية على الأصول المولَّدة كتبقى خاضعة لهاد الإشعارات والشروط الخارجية.

الخلاصة

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