referencelisted
Install: claude install-skill ysucode/jawla-skills
# جولة: الرفرنس
هدفنا **نفهم ليش المقطع يشد**، مو إننا ننسخه. والنتيجة تكون وصفة فيها أرقام تقدر `plan` و`edit` تمشي عليها.
اقرأ `../../references/house-rules.md`. الأدوات في `../../tools`.
## 1. المدخلات
- **رابط حساب كامل:** صفحات الحسابات في تيك توك ما تنقرا بشكل موثوق. اطلب من المالك 3 إلى 5 روابط لمقاطع بعينها، أو ملفات نزّلها بنفسه، ويختار المقاطع اللي يحس إنها **أوضح شي في الأسلوب**.
- **ملفات على الجهاز:** استخدمها على طول.
- **روابط:** تحتاج `yt-dlp`. إذا كان ناقص، اسأل المالك قبل ما تثبته. وقبل التنزيل قل له وش بتنزل ومن وين.
- **تيك توك:** ما يسمح بالتنزيل إلا لو كان مع yt-dlp حزمة `curl-cffi`. أمر التثبيت الصحيح يطلعه `doctor.py`.
- **إذا فشل التنزيل:** اقرأ `hint` في نتيجة الأداة. والحل الأسهل دائماً إن المالك يحفظ المقطع من التطبيق ويعطيك الملف.
- **مكان الحفظ:** المجلد `02-reference/<اسم الحساب>/<رقم المقطع>/`.
## 2. التحليل الآلي
شغّل هذا الأمر لكل مقطع:
```
python probe.py ref "<ملف أو رابط>" --out "<vault>/02-reference/<الحساب>/v1" --transcribe
```
الأمر يطلع:
- **`report.json`:** المدة، وأوقات القصات، وطول اللقطات، وعدد القصات في كل 10 ثواني، ومستوى الصوت (LUFS)، وكم كلمة في الثانية، ونسبة الكلام من المقطع، ونص أول 3.5 ثانية.
- **`hook_sheet.jpg`:** 8 إطارات من أول 3.5 ثانية.
- **`cuts_sheet.jpg`:** الإطار اللي بعد كل قصة.
- **`transcript.json`:** الكلام مع وقت كل كلمة.
**أول تشغيل:** التفريغ ينزل موديل Whisper مرة وحدة، حجمه حوالي 1.5 جيجا. قل للمالك قبل.
## 3. القراءة بعينك
1. **الصور.** اقرأ `hook_sheet.jpg` و`cuts_sheet.jpg` كصور، وطلّع م