● مجتمع
GridLtd-ProductDev
⚡ فوري
narrator-ai-cli-skill
بواسطة GridLtd-ProductDev · GridLtd-ProductDev/narrator-ai-cli-skill
مهارة وكيل لواجهة سطر الأوامر Narrator AI لتسجيل الفيديوهات - يقود Claude عمليات التسجيل الصوتي من البداية إلى النهاية من سطر الأوامر.
تعلم مهارة narrator-ai-cli الـ Claude كيفية استخدام narrator-ai-cli، عميل واجهة سطر الأوامر لـ API تسجيل الفيديوهات الخاص بـ Narrator AI. تُغلف الأعلام والمسارات الشائعة ومعالجة المخرجات بحيث يمكن للـ Claude تجميع طلبات التسجيل الصوتي وبدء المهام والاستفسار عن الانتهاء ووضع ملفات المخرجات في مواقع منطقية - مفيد عندما تريد تسجيل صوت لسلسلة من الفيديوهات دفعة واحدة دون تشغيل واجهة سطر الأوامر يدويًا.
لماذا تستخدمه
الميزات الأساسية
- تغليف أعلام narrator-ai-cli والأوامر الفرعية
- معالجة أنماط إرسال المهام والاستفسار
- اتفاقيات وضع ملفات المخرجات
- تسجيل صوت دفعي عبر فيديوهات مصدر متعددة
- فشل صريح عند غياب مفتاح API أو التكوين
عرض مباشر
كيف يبدو في الممارسة
narrator-ai-cli-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: narrator-ai-cli-skill
متى تستخدمه: لديك فيديو وسيناريو تعليق صوتي مسودة وتريد إنتاج تسجيل صوتي عبر واجهة سطر الأوامر.
الخطوات
-
إعداد المدخلات
بناءً على الفيديو scene_01.mp4 والسيناريو script.md، قم بتشغيل narrator-ai-cli وحفظ المخرجات في ./narrations/.✓ تم النسخ
→ استدعاء واجهة سطر الأوامر بأعلام صحيحة
-
الانتظار والتحقق
استفسر حتى انتهاء المهمة، ثم تأكد من وجود ملف المخرجات واحتوائه على صوت.✓ تم النسخ
→ وجود ملف المخرجات بمدة غير صفرية
النتيجة: ملف تسجيل صوتي جاهز للإدراج في محررك.
المزالق
- انتهاء صلاحية المهام الطويلة في shell — استخدم الوضع غير المتزامن للـ CLI + الاستفسار بدلاً من استدعاء محظور
متى تستخدمه: لديك 10+ مشاهد لكل منها سيناريو خاص بها وتحتاج إلى تسجيل صوتي متسق.
الخطوات
-
تصفح هيكل المشروع
ابحث عن جميع أزواج scene_*.mp4 + scene_*.md تحت project/ وقم بتصف تسجيل صوتي لكل منها.✓ تم النسخ
→ الأزواج المُعدودة + قائمة انتظار المهام
-
التشغيل متسلسلاً أو متوازياً
قم بتشغيل ما يصل إلى 3 مهام بالتوازي؛ حدد السرعة وفقاً لحد معدل API المسموح به.✓ تم النسخ
→ التزامن المنضبط
-
الإبلاغ عن النتائج
أنتج جدولاً: المشهد والحالة والمدة ومسار المخرجات.✓ تم النسخ
→ جدول إنجاز واضح
النتيجة: تسجيل صوتي للمشروع كله في تشغيل واحد مع حالة واضحة.
المزالق
- الوصول إلى حدود API في منتصف الدفعة — احترم حدود معدل الخادم الأصلي؛ تراجع عند استقبال 429
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
البحث عن المدخلات تلقائياً وإسقاط المخرجات في مجلدات منظمة
تصفح project/، سجل صوتاً لكل مشهد، خرج إلى project/narrations/.✓ تم النسخ
إضافة تسجيل صوتي بواسطة AI إلى مقاطع Short المُنتجة بواسطة claude-shorts
لكل مقطع Short معروض، سجل سطر مقدمة وامزجه فيه.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- يعتمد على مستوى Narrator AI
- الرموز لكل استدعاء
- حد أدنى من توكنات LLM؛ التكلفة الحقيقية هي دقائق API
- التكلفة المالية
- يتم فرض الرسوم على API بواسطة Narrator AI
- نصيحة
- سجل السيناريوهات النهائية فقط؛ كرر النص في LLM أولاً
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: مفتاح API الخاص بـ Narrator AI في متغير البيئة؛ لا تضعه مباشرة أبداً
نقل البيانات الخارجي: نقاط نهاية Narrator AI
- يمر الفيديو/الصوت المرفوع عبر خدمة طرف ثالث؛ تحقق من سياسات معالجة البيانات
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
لم يتم العثور على أمر واجهة سطر الأوامر
ثبت narrator-ai-cli وتأكد من وجوده في PATH حيث يعمل Claude Code.
تحقق: which narrator-ai-cli
خطأ 401 من Narrator API
اضبط NARRATOR_API_KEY (أو متغير البيئة المتوقع من قبل واجهة سطر الأوامر).
تحقق: env | grep NARRATOR
البدائل
narrator-ai-cli-skill مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| claude-shorts-skill | تريد خط أنابيب كامل من طويل إلى قصير، وليس فقط تسجيل صوتي | خط الأنابيب مقابل الغرض الفردي |