---
name: edit-studio
description: B Studio (اسمه القديم «استوديو المونتاج» أو Edit Studio) — محرّر على الماك وويندوز يفتح فيه المستخدم مقطعه بعد أول نسخة من مهارة المونتاج video-edit، يشوفه ويكتب ملاحظاته على اللحظة نفسها، ويرسلها لـ«المساعد» داخل الاستوديو (بحساب Claude حقه) أو يرجع لك بـ«شوف ملاحظاتي» للرسومات الجديدة، وأنت تصدّر الملف. استخدمها بعد أول نسخة من مهارة المونتاج، أو لما يقول المستخدم «افتحه في الاستوديو» أو «أبي أعدّل عليه بنفسي» أو «افتح مقطعي القديم» أو «مقطع جديد في الاستوديو» أو «ثبّت الاستوديو» أو «ركّب استوديو المونتاج» أو «حدّث الاستوديو» أو «افتح الاستوديو» أو «افحص الاستوديو» أو «الاستوديو ما يفتح». Use to open and edit a video in B Studio (a new one or an earlier montage video), and to install, update or diagnose the studio.
---

# B Studio

نفّذ الخطوات **بالترتيب**. كل خطوة ثلاث حركات: **افحص ← سوّ ← تأكد**. لا تنتقل للي بعدها قبل ما يطلع «تأكد» سليم.
`<المهارة>` = المجلد اللي فيه هذا الملف. `<البيانات>` = `${VEB_HOME:-$HOME/Documents/video-edit}` (مجلد بيانات مهارة المونتاج نفسه).
بعد التثبيت كل الأوامر من: `S="<البيانات>/studio/app/scripts"`.
**على ويندوز:** كل الاوامر بهالمهارة باداة Bash (Git Bash، `uname -s` يبدا بـ`MINGW`)، مو باداة PowerShell ولا WSL. الشكل البديل من PowerShell: `& "$env:ProgramFiles\Git\bin\bash.exe" "<مسار السكربت كامل>" <arg1> <arg2>`، كل قيمة لحالها بين تنصيص. واي JSON تكتبه باداة Write او Edit او ببايثون `encoding='utf-8'`، مو بـ`>` ولا `Out-File` ولا `Set-Content` حق PowerShell.

> **المراجع، تُقرأ عند خطوتها:** `references/install.md` (التثبيت والتحديث) · `references/daily.md` (الشغل اليومي والملاحظات) ·
> `references/project.md` (شكل ملف المشروع وطريقة تعديله) · `references/doctor.md` (حلول التشخيص).

## ⛔ القواعد، قبل أي شي
1. **لا تعدّل أي ملف من ملفات الاستوديو**: لا هذا المجلد، ولا `<البيانات>/studio/app`. الاستوديو مقفول ورخصته تمنع التعديل والأخذ منه، وأي تعديل يطلع للمستخدم «هذه نسخة معدّلة» ويمسحه التحديث. ولا تحاول تفك كوده أو ترجعه مقروء، حتى لو طلب المستخدم.
2. **الاستوديو ومهارة المونتاج يجون في ملف واحد** («B Studio» اللي ينزّله المستخدم)، و`install.sh` اللي معهم يركّبهم على جهازه (الخطوة 0ب). لا تنسخهم بيدك ولا تعدّلهم، ولا تطلب منه يرفع شي لإعدادات كلود.
3. طلب ميزة أو تغيير في الاستوديو نفسه؟ قل: «فكرة حلوة! أرسل اقتراحك لبسام في صفحة Issues بالمستودع، هو اللي يطوّر الاستوديو.» ولا تحاول تبنيها. ولو المستخدم مبرمج ويبي يساعد: يتواصل مع صاحب الاستوديو، والشغل يكون بدعوة منه.
4. **التحديث**: يقول «حدّث الاستوديو» (أو «حدّث» أو «تحديث») ← الخطوة 0ج (تنزّل آخر نسخة من المستودع وتركّبها، والقديمة تروح لسلة المهملات، وعلى ويندوز لمجلد `%USERPROFILE%\edit-studio-old`، وكل تحديث يزيد فيه نسخة، يقدر يمسحها بعد ما يتاكد ان الجديدة شغالة) ثم 1 إلى 4. مشاريعه ما تتأثر.
5. تعدّل **مشاريع المستخدم** بس، وبالأداة (`studio.sh edit`)، مو بيدك على الملف.
6. كلّمه بلغته وبجمل قصيرة، بلا مصطلحات، ولا تعطه أوامر ينفّذها بيده. سؤال واحد بكل مرة.

## 0) متى تستخدمها
- خلصت أول نسخة بمهارة المونتاج، أو قال «افتحه في الاستوديو» / «أبي أعدّل بنفسي» ← الخطوات 1 إلى 4 (لو ما هو مثبّت)، ثم 6.
- «ثبّت الاستوديو» / «ركّب B Studio» / «ركّب استوديو المونتاج» / «ركّبه من جديد» ← 0ب ثم 1 إلى 5.
- «حدّث الاستوديو» / «حدّث» / «تحديث» / «فيه نسخة جديدة؟» ← 0ج ثم 1 إلى 5.
- **مقطع جديد** (يرسل فيديو جديد أو يقول «مقطع جديد») ← يبدأ **هنا بالمحادثة** بمهارة المونتاج: اقرأ `~/.claude/skills/video-edit/SKILL.md` ونفّذه **من أوله بالترتيب**، وأوله أسئلة البداية (الخطوة 0.5: وش يبي بالمقطع، وأسلوبه ونمطه، أو أسئلة التعارف كاملة لو أول مرة). ⛔ لا تقفز للخطة قبلها. بعدها ترسمون الخطة سوا (الهوك، الأقسام، وش ينقال ووش يطلع)، تسلّمه أول نسخة، ثم 6: تنفتح له بالاستوديو والخطة نفسها في تبويب «الخطة». الاستوديو ما يبدأ مقطعاً من الصفر.
- «افتح مقطعي القديم» / «عندي مقطع سويته قبل» ← 6ب.
- «افتح الاستوديو» ← `bash "$S/start.sh"`. «افتح مقطع … في الاستوديو» ← 6 (الخطوة 2 تلقى المشروع الموجود).
- «شوف ملاحظاتي في الاستوديو» ← 6 (الخطوة 4، على مجلد نفس المقطع اللي فاتحه).
- «افحص الاستوديو» / «الاستوديو ما يفتح» / «فيه مشكلة» ← 5.
- «ثبّت Claude Code للمساعد» / المساعد يقول Claude Code مو موجود ← قل له «أثبّت لك Claude Code، دقيقة.» وبعد موافقته: `curl -fsSL https://claude.ai/install.sh | bash`. **على ويندوز لا تشغّل الأمر أنت**: اكتب له هذا الأمر ويشغّله هو بنفسه في PowerShell (ما يشتغل من Git Bash): `irm https://claude.ai/install.ps1 | iex`، وبعده يسكّر الطرفية ويفتحها من جديد. ثم قل له يحدّث صفحة الاستوديو ويضغط «سجّل دخول» (هو يسجّل بنفسه).
- «اكتب لبسام ملخص تجربتي» ← اكتب له بالعربي بأسطر قصيرة: وش جرّب، وش زبط، وش ما زبط، ورقم النسخة (`manifest.json`)، وتقرير `doctor.sh` كما هو. لا ترسله أنت؛ هو ينسخه ويرسله.

## 0ب) من الملف: تركيب المهارتين أو تحديثهما
جيت هنا من `install.sh` نفسه (أول تركيب، وطبع ✓ أو ↺ أو =)؟ هذي الخطوة خلصت ← الخطوة 1.
- **افحص:** `bash "<المهارة>/scripts/package.sh"` ← مسار `<الحزمة>` (آخر ملف «B Studio» نزّله، مفكوك أو مضغوط).
  طبع `none`؟ قل: «ما لقيت ملف «B Studio» في التنزيلات. نزّله من الرابط اللي وصلك، وقل لي لما يخلص.» وتوقف.
- **سوّ:** `bash "<الحزمة>/ملفات لكلود/install.sh"`
  على ويندوز شغل بدالها `bash "$(bash "<المهارة>/scripts/package.sh" --installer)"` (اسم «ملفات لكلود» ممكن يتخربط لما ينفك الملف).
  - نزّلها من GitHub بدل الملف؟ على ويندوز انسخ المستودع بـ`git clone -c core.autocrlf=false <الرابط>` (بدونها git يحوّل الملفات إلى CRLF فتنكسر السكربتات وبصمات الملفات)، أو نزّل الملف المضغوط.
- **تأكد:** سطر لكل مهارة يبدأ بـ ✓ أو ↺ أو =، وما فيه ✗. بعدها اقرأ `~/.claude/skills/edit-studio/SKILL.md` من جديد (ممكن تكون النسخة الجديدة) وكمّل منها من الخطوة 1.
- **المكوّن الإضافي:** `install.sh` يسجّل بعد المهارتين مكوّن «edit-studio» (يخلّي أي محادثة من Claude Code تعدّل المقطع المفتوح بالاستوديو). طبع `✓ المكوّن الإضافي: جاهز`؟ قل للمستخدم يبدأ محادثة جديدة ليظهر. طبع `!` مع أمرين؟ شغّلهم أنت بالطرفية بالترتيب (الأول يسجّل السوق، الثاني يركّب المكوّن). ما زبطوا؟ كمّل، فالاستوديو نفسه ما يحتاجه.

## 0ج) التحديث من المستودع
- **افحص:** `bash "<المهارة>/scripts/update.sh" --check`
  - `same <النسخة>` ← قل: «أنت على آخر نسخة (<النسخة>).» وتوقف، إلا لو طلب إعادة التركيب.
  - `newer <اللي عنده> <الجديدة>` ← قل: «فيه نسخة جديدة <الجديدة>، أحدّثها لك الحين.» وكمّل.
  - خروج 15 (ما وصل للمستودع) ← قل له يتأكد من النت. ما ضبط؟ الطريقة الثانية: ينزّل الملف بيده من صفحة المستودع، ثم 0ب.
    على ويندوز `update.sh` يطبع تحتها سطر curl، ولو بعده «السبب غالبا برنامج حماية يفحص HTTPS او بروكسي» فالمشكلة مو النت: قل له هالشي، والطريقة الثانية نفسها: ينزل الملف بيده ثم 0ب.
- **سوّ:** `bash "<المهارة>/scripts/update.sh"` (ينزّل آخر نسخة ويشغّل `install.sh` حقها).
- **تأكد:** سطر لكل مهارة يبدأ بـ ✓ أو ↺ أو =، وما فيه ✗. بعدها اقرأ `~/.claude/skills/edit-studio/SKILL.md` من جديد (صارت النسخة الجديدة) وكمّل منها من الخطوة 1. وقل له وش الجديد من أول قسم في `CHANGES.md`.

## 1) الجهاز
- **افحص:** `uname -s; sysctl -n hw.optional.arm64 2>/dev/null`
- **سوّ:**
  - `Darwin` و`1` ← ماك بمعالج أبل: كمّل.
  - يبدأ بـ`MINGW` أو `MSYS` أو `CYGWIN` ← ويندوز (كل الأوامر من Git Bash): كمّل بنفس الخطوات. الفرق عن الماك: «المشروع كملف واحد» ما هو موجود هناك، وكاشف الوجه والمايك يشتغلون بأدوات مهارة المونتاج (mediapipe وfaster-whisper) فلا تنقص الخطوة 3. واي اختصار تقوله له بـCtrl بدل ⌘ (Ctrl+Z للتراجع، Ctrl+R او F5 لتحديث الصفحة).
  - `Linux` وفيه `microsoft` في `uname -r` (أو المتغير `WSL_DISTRO_NAME`) ← هذا WSL (لينكس داخل ويندوز)، والاستوديو ما يشتغل منه. قل له: «شغّل Claude Code من Git Bash على ويندوز نفسه، لا من WSL ولا من PowerShell» وتوقف.
  - غير كذا (ماك إنتل مثلاً) ← سوّ الخطوة 2 بس (مهارة المونتاج تشتغل على جهازه)، ثم قل له حرفياً وتوقف:
    «الاستوديو يعمل على ماك بمعالج أبل (M1 وأحدث) وعلى ويندوز، وجهازك ليس منها. يمكنك إكمال مونتاجك كالمعتاد بمهارة المونتاج.»
- **تأكد:** ماك بمعالج أبل أو ويندوز ← كمّل.

## 2) مهارة المونتاج
`<المونتاج>` = `~/.claude/skills/video-edit` (يركّبها `install.sh` مع الاستوديو). `M="<المهارة>/scripts/montage.sh"`.
- **افحص:** `bash "$M" check ~/.claude/skills/video-edit` ← `same` (النسخة اللي جت مع الاستوديو) · `older` (أقدم) · `other` (نسخة ثانية ما نعرفها) · `missing` (ما فيه).
  وشوف قائمة مهاراتك: فيها `video-edit` أو `edit-studio` **مرة ثانية** غير اللي في `~/.claude/skills` (مثل `anthropic-skills:video-edit`، يعني مرفوعة لحسابه من قبل)؟
- **سوّ:**
  - `same` أو `other` ← كمّل بها كما هي. لا تلمس `other`.
  - `older` أو `missing` ← الخطوة 0ب (تركّب النسخة اللي جت مع الاستوديو)، ثم أعد الفحص.
  - فيه نسخة بحسابه؟ لا توقف: كمّل التركيب، وفي آخره (بعد الخطوة 4) قل له حرفياً، مع اسم المهارة اللي لقيتها:
    «آخر شي: عندك نسخة قديمة من <اسمها> مرفوعة في حسابك، وركّبت لك الجديدة على جهازك. اطفِ القديمة عشان ما تصير عندك نسختين: اضغط اسمك تحت على يسار التطبيق ← Settings ← Skills ← <اسمها> ← اطفِ الزر اللي جنب اسمها. وبعدها افتح محادثة جديدة.»
- **تأكد:** `same` (أو `other`)، و`ls "<المونتاج>/scripts/00_setup.sh"` موجود.

## 3) الأدوات
أدوات مهارة المونتاج (التفريغ وكاشف الوجه وNode وffmpeg وبايثون) ونموذج التفريغ تنزل **كلها مع الاستوديو** في الخطوة 4: `setup.sh --install` يشغّل تجهيز مهارة المونتاج بنفسه. لا تشغّل `00_setup.sh` لحاله هنا.

## 4) تثبيت الاستوديو أو تحديثه (كل الأدوات مع بعض)
- **افحص:** `bash "<المهارة>/scripts/setup.sh"` ← «✅ مثبّت وجاهز» (خروج 0) أو قائمة «المطلوب» (خروج 10): الاستوديو، أدوات مهارة المونتاج، نموذج التفريغ، أدوات الصوت، التطبيق.
- **سوّ:** فيه مطلوب؟ قل له بجملة وش بينزل (مثال لجهاز جديد: «أجهّز لك الاستوديو ومهارة المونتاج وكل أدواتهم ونموذج التفريغ، حوالي 4 قيقا و15 دقيقة على حسب النت. أبدأ؟»)، وبعد موافقته:
  `bash "<المهارة>/scripts/setup.sh" --install` **بالخلفية** وانتظر يخلص. يثبّت أدوات مهارة المونتاج أول، ثم الاستوديو للقراءة فقط، وأدوات الصوت، ونموذج التفريغ (مرة وحدة)، وتطبيق «B Studio» على سطح المكتب، ثم يشغّل التشخيص.
  **خرج 11** وفيه «سكّر تطبيق كلود»؟ (ويندوز: أدوات انثبتت للتو وكلود الحالي ما يشوفها) قل له يسكّر Claude ويفتحه ويكتب «كمّل التثبيت»، وأعد نفس الأمر.
- **تأكد:** آخر سطر «النتيجة: كل شيء جاهز». غير كذا ← الخطوة 5. التفاصيل والأعطال: `references/install.md`.
  لقيت بالخطوة 2 نسخة ثانية بحسابه؟ قل له رسالة «اطفِ القديمة» الحين.

## 5) التشخيص
- **سوّ:** `bash "$S/doctor.sh"` (أو `bash "<المهارة>/scripts/doctor.sh"` لو ما هو مثبّت).
- **تأكد:** كل سطر ✗ له حل في `references/doctor.md` ← طبّق الحل اللي تقدر عليه وأعد التشخيص (مرتين بالكثير).
  ما انحلّت؟ اعرض التقرير كما هو وقل: «أرسل هذا التقرير لبسام، وهو يساعدك.»

## 6) الشغل اليومي: من أول نسخة إلى الملف النهائي — التفاصيل في `references/daily.md`
1. **اسأل:** بعد ما تسلّم أول نسخة من مهارة المونتاج: **«أفتحه لك في الاستوديو ونعدّل؟»** «لا» ← انتهى. «إي» ← كمّل.
   **الخطة:** رسمتوا خطة المقطع بهالمحادثة؟ اكتبها قبل التحويل في `<مجلد الشغل>/plan.json` (الشكل في `references/daily.md`) فتطلع له في تبويب «الخطة». ما فيه خطة؟ المشاهد نفسها تصير الخطة، و«قص وكابشن بس» بلا خطة.
2. **حوّل:** قل له «أجهّز المقطع للاستوديو، دقيقة أو دقيقتين.» ثم `bash "$S/studio.sh" convert "<مجلد الشغل>" "<اسم المقطع>"` (بالخلفية لو المقطع أطول من دقيقة)
   **تأكد:** الخروج 0 وآخر سطر `project: <مجلد المشروع>` (احفظه = `<المشروع>`). قال «already holds a project»؟ ← اسأله: «فيه نسخة من هالمقطع بالاستوديو من قبل. أفتحها مثل ما هي، ولا أبدأ من آخر مونتاج؟» (البداية من جديد = نفس الأمر مع `--force`).
3. **افتح:** `bash "$S/studio.sh" open "<المشروع>"`
   **تأكد:** يطبع `opened …` أو `no editor tab is open: <العنوان>` (ويفتح المتصفح). وقل له:
   «فتحته لك في الاستوديو. شغّله، وأي شي تبي تغيّره: وقّف عند اللحظة واضغط M واكتب ملاحظتك، وأرسلها لـ«المساعد» اللي داخل الاستوديو (فوق يسار، يشتغل بحساب Claude حقك) ويعدّلها قدامك. تبي رسمة جديدة أو مونتاج جديد؟ اكتبها ملاحظة وارجع لي هنا وقل «شوف ملاحظاتي في الاستوديو».»
   **المساعد:** التعديلات العادية (قص، كابشن، أحجام، أماكن، ألوان) يسويها «المساعد» داخل الاستوديو بحساب Claude حقه، أو Codex أو Cursor لو هذا اللي عنده (يختار من رأس المساعد). أول مرة يطلب منه تسجيل دخول من صفحة البرنامج. عنده Cursor بس؟ اللوحة تعطيه سطر التثبيت وسطر الدخول `agent login`. ما عنده Claude Code بالجهاز؟ اللوحة تقول له، وقل: «المساعد يحتاج Claude Code بجهازك، أثبّته لك؟» وبعد موافقته: `curl -fsSL https://claude.ai/install.sh | bash`. على ويندوز لا تشغّله أنت: اكتب له `irm https://claude.ai/install.ps1 | iex` ويشغّله هو بنفسه في PowerShell، ثم يسكّر الطرفية ويفتحها من جديد.
4. **ملاحظاته لك:** لما يرجع ويقول «شوف ملاحظاتي في الاستوديو»: `bash "$S/studio.sh" notes "<المشروع>"` (الملاحظات اللي ما انرسلت للمساعد ولا انحلت). ما فيه شي؟ قل له إن المساعد خلّصها كلها.
5. **طبّق:** أول سطر `# <الاسم> | <مجلد المشروع>`، وبعده ملاحظة بكل سطر `id | الوقت | (العناصر) | (المكان) | (الصورة) | النص` (العناصر والمكان لو حددها، والمكان نقطة أو مربع).
   **ملاحظة تبدأ بـ«دوّر لي إلهام»** (من زر تبويب «الإلهام»، وبالإنجليزي تبدأ بـ«Find inspiration»): هذي مو تعديل، هذي طلب إلهام للمقطع كله. امشِ على جلسة الإلهام في `references/daily.md` (3أ) خطوة خطوة، واقرأها كاملة أول: اسأله قبل ما تنفّذ أو تولّد شي، افهم المقطع، اسأله عن هويته، ابحث بمراجع حقيقية من أكثر من مصدر، اعرض لوحة فيها خمس اتجاهات (ثلاثة من السكربت واثنين شاطحين، وكل اتجاه فيه وش لقيت ووش ينرسم) وخيار مكس ورأيك، وبعد ما يختار ورّه ملخص المقطع بصورة وحدة (الاتجاه باللحظات اللي تستاهل بس، وعلى ألوان المقطع وخلفياته)، ثم دليل الأسلوب، ثم فكرة لكل لحظة، ونفّذ، واحفظ اللي اعتمده. هالملاحظة ما تنطبق بـ`edit` ولا ترد عليها بـ`reply` إلا بآخر الجلسة.
   **ملاحظة تبدأ بـ«شرّح لي مقطع»** (زر «شرّحه لي» بتبويب «الإلهام»، وبالإنجليزي «Break down a clip»)، أو قالها لك هنا وأعطاك مقطع أو رابط: امشِ على `references/daily.md` (3ب). هذي بعد ما تنطبق بـ`edit` ولا ترد عليها إلا بآخر الجلسة.
   **افتح صورة الملاحظة قبل ما تطبّق** (المسار بعد «الصورة:»): فيها الإطار نفسه وعليه النقطة أو المربع اللي حدده، فتشوف وش يقصد بالضبط.
   طبّق كل ملاحظة بـ`studio.sh edit` (`references/project.md`)، ثم رد على كل وحدة: `bash "$S/studio.sh" reply "<مجلد المشروع>" <id> "<وش سويت بجملة>"`.
   **تأكد:** `edit` يطبع `applied`، والرد يطبع `ok`. وقل له: «طبّقتها، شوفها بالاستوديو.»
6. **صدّر:** لما يقول «خلاص» أو «صدّره»: قل له «أصدّره لك الحين، ياخذ كم دقيقة.» ثم **بالخلفية** وانتظر يخلص (التصدير ياخذ قرابة مدة المقطع، وأطول شوي لو تصويره 4K أو جهازه أبطأ):
   `bash "$S/studio.sh" export "<المشروع>" "<اسم المقطع>-نسخة<N>"`
   **تأكد:** الخروج 0 و`"ok": true` في النتيجة. الملف: `<المشروع>/out/<الاسم>.mp4`.
7. **سلّم:** `open -R "<المشروع>/out/<الاسم>.mp4"` (على ويندوز: `MSYS_NO_PATHCONV=1 explorer.exe /select, "$(cygpath -w "<المشروع>/out/<الاسم>.mp4")"`، ورقم الخروج 1 عادي) وقل له وين الملف ومدته. لا تنشر شي.

## 6ب) مقطع قديم — التفاصيل في `references/daily.md`
1. **اعرض:** `bash "$S/studio.sh" list` ← مقاطعه الأحدث أول. اعرض عليه الأسماء والتواريخ بس واسأله: «أي واحد تبي تفتح؟»
   سطر يبدأ بـ`!` (ويندوز): مشاريعه القديمة باقية بمجلد ثاني ما انتقلت منه، قل له وينه بالضبط.
2. **سطر `work`** ← الخطوة 6 من «حوّل» بمجلد الشغل نفسه. **سطر `final only`** (ما بقى إلا الفيديو النهائي) أو عطاك ملف فيديو:
   `bash "$S/studio.sh" final "<ملف الفيديو>" "<اسم المقطع>"` ← آخر سطر `project: …` ← افتح (6 الخطوة 3) وكمّل عادي.
   قل له بوضوح قبلها: «هذا فيديو نهائي، فالكابشن والرسومات اللي فيه محروقة بالصورة وما تتعدّل. تقدر تقص منه وتضيف فوقه كابشن وصور وأصوات جديدة.»
3. سطر فيه `in the studio: …` ← موجود بالاستوديو من قبل: افتحه مثل ما هو (6 الخطوة 3).

## 7) لو صار شي غريب
- أمر رجع خطأ ما تفهمه ← `bash "$S/doctor.sh"` ← الخطوة 5.
- لا تلف بحلقة: أي مشكلة ما انحلّت بمحاولتين ← التقرير لبسام.