skill
استخدام Git Worktrees
يستخدم عند بدء عمل على ميزة تتطلب عزلا عن مساحة العمل الحالية أو قبل تنفيذ خطط التطبيق - يضمن وجود مساحة عمل معزولة عبر الأدوات الأصلية أو استخدام git worktree كبديل.
نبذة
# استخدام Git Worktrees
## نظرة عامة
تأكد من أن العمل يتم في مساحة عمل معزولة. فضل أدوات worktree الأصلية لمنصتك. ارجع إلى أدوات git worktree اليدوية فقط عندما لا تتوفر أداة أصلية.
**المبدأ الأساسي:** اكتشف العزل الموجود أولا. ثم استخدم الأدوات الأصلية. ثم ارجع إلى git. لا تقاوم النظام أبدا.
**أعلن في البداية:** "أنا أستخدم مهارة using-git-worktrees لإعداد مساحة عمل معزولة."
## الخطوة 0: اكتشاف العزل الموجود
**قبل إنشاء أي شيء، تحقق مما إذا كنت بالفعل في مساحة عمل معزولة.**
```bash GIT_DIR=$(cd "$(git rev-parse --git-dir)" 2>/dev/null && pwd -P) GIT_COMMON=$(cd "$(git rev-parse --git-common-dir)" 2>/dev/null && pwd -P) BRANCH=$(git branch --show-current) ```
**حماية Submodule:** `GIT_DIR != GIT_COMMON` صحيح أيضا داخل git submodules. قبل الاستنتاج بأنك "بالفعل في worktree"، تحقق من أنك لست في submodule:
```bash # إذا أعاد هذا مسارا، فأنت في submodule، وليس worktree — تعامل معه كمستودع عادي git rev-parse --show-superproject-working-tree 2>/dev/null ```
**إذا كان `GIT_DIR != GIT_COMMON` (وليس submodule):** أنت بالفعل في worktree مرتبط. انتقل إلى الخطوة 2 (إعداد المشروع). لا تنشئ worktree آخر.
أبلغ بحالة الفرع: - على فرع: "بالفعل في مساحة عمل معزولة في `<path>` على الفرع `<name>`." - رأس منفصل (Detached HEAD): "بالفعل في مساحة عمل معزولة في `<path>` (رأس منفصل، مدار خارجيا). يلزم إنشاء فرع عند الانتهاء."
**إذا كان `GIT_DIR == GIT_COMMON` (أو في submodule):** أنت في استنساخ مستودع عادي.
هل أشار المستخدم بالفعل إلى تفضيله ل worktree في تعليماتك؟ إذا لم يكن كذلك، اطلب الموافقة قبل إنشاء worktree:
> "هل ترغب في أن أقوم بإعداد worktree معزول؟ إنه يحمي فرعك الحالي من التغييرات."
احترم أي تفضيل معلن موجود دون سؤال. إذا رفض المستخدم الموافقة، اعمل في المكان وانتقل إلى الخطوة 2.
## الخطوة 1: إنشاء مساحة عمل معزولة
**لديك آليتان. جربهما بهذا الترتيب.**
### 1أ. أدوات Worktree الأصلية (مفضلة)
طلب المستخدم مساحة عمل معزولة (موافقة الخطوة 0). هل لديك بالفعل طريقة لإنشاء worktree؟ قد تكون أداة باسم مثل `EnterWorktree`، `WorktreeCreate`، أمر `/worktree`، أو علامة `--worktree`. إذا كان لديك، استخدمها وانتقل إلى الخطوة 2.
تتعامل الأدوات الأصلية مع وضع الدليل وإنشاء الفروع والتنظيف تلقائيا. استخدام `git worktree add` عندما يكون لديك أداة أصلية ينشئ حالة وهمية لا يمكن لنظامك رؤيتها أو إدارتها.
انتقل إلى الخطوة 1ب فقط إذا لم تتوفر لديك أداة worktree أصلية.
### 1ب. Git Worktree Fallback
**استخدم هذا فقط إذا لم تنطبق الخطوة 1أ** — ليس لديك أداة worktree أصلية متاحة. أنشئ worktree يدويا باستخدام git.
#### اختيار الدليل
اتبع ترتيب الأولوية هذا. تفضيل المستخدم الصريح يتفوق دائما على حالة نظام الملفات المرصودة.
1. **تحقق من تعليماتك بحثا عن تفضيل معلن لدليل worktree.** إذا حدد المستخدم واحدا بالفعل، استخدمه دون سؤال.
2. **تحقق من وجود دليل worktree محلي للمشروع:** ```bash ls -d .worktrees 2>/dev/null # مفضل (مخفي) ls -d worktrees 2>/dev/null # بديل ``` إذا وجد، استخدمه. إذا وجد كلاهما، يفوز `.worktrees`.
3. **إذا لم تتوفر إرشادات أخرى،** فافترض افتراضيا `.worktrees/` في جذر المشروع.
#### التحقق من السلامة (للدلائل المحلية للمشروع فقط)
**يجب التحقق من تجاهل الدليل قبل إنشاء worktree:**
```bash git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null ```
**إذا لم يتم تجاهله:** أضفه إلى .gitignore، التزم بالتغيير، ثم تابع.
**لماذا هو حاسم:** يمنع الالتزام العرضي لمحتويات worktree إلى المستودع.
#### إنشاء Worktree
```bash # تحديد المسار بناء على الموقع المختار path="$LOCATION/$BRANCH_NAME"
git worktree add "$path" -b "$BRANCH_NAME" cd "$path" ```
**العودة إلى Sandbox:** إذا فشل `git worktree add` بسبب خطأ في الأذونات (رفض Sandbox)، أخبر المستخدم أن Sandbox منع إنشاء worktree وأنك تعمل في الدليل الحالي بدلا من ذلك. ثم قم بتشغيل الإعداد والاختبارات الأساسية في المكان.
## الخطوة 2: إعداد المشروع
اكتشف تلقائيا وقم بتشغيل الإعداد المناسب:
```bash # Node.js if [ -f package.json ]; then npm install; fi
# Rust if [ -f Cargo.toml ]; then cargo build; fi
# Python if [ -f requirements.txt ]; then pip install -r requirements.txt; fi if [ -f pyproject.toml ]; then poetry install; fi
# Go if [ -f go.mod ]; then go mod download; fi ```
## الخطوة 3: التحقق من الأساس النظيف
قم بتشغيل الاختبارات للتأكد من أن مساحة العمل تبدأ نظيفة:
```bash # استخدم الأمر المناسب للمشروع npm test / cargo test / pytest / go test ./... ```
**إذا فشلت الاختبارات:** أبلغ عن الفشل، واسأل عما إذا كنت تريد المتابعة أو التحقيق.
**إذا نجحت الاختبارات:** أبلغ بأنها جاهزة.
### التقرير
``` Worktree جاهز في <full-path> الاختبارات ناجحة (<N> اختبارات، 0 فشل) جاهز لتنفيذ <feature-name> ```
## مرجع سريع
| الموقف | الإجراء | |-----------|--------| | بالفعل في worktree مرتبط | تخطي الإنشاء (الخطوة
التثبيت
شغل هذا الأمر
npx skills add obra/superpowersيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add obra/superpowers`، أو استنسخ المستودع وانسخ مجلد `skills/using-git-worktrees` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة استخدام Git Worktrees؟
يستخدم عند بدء عمل على ميزة تتطلب عزلا عن مساحة العمل الحالية أو قبل تنفيذ خطط التطبيق - يضمن وجود مساحة عمل معزولة عبر الأدوات الأصلية أو استخدام git worktree كبديل.
كيف أثبت استخدام Git Worktrees؟
شغل هذا الأمر في الطرفية:
npx skills add obra/superpowersمع أي أدوات ذكاء اصطناعي تعمل استخدام Git Worktrees؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور استخدام Git Worktrees؟
طورها obra.
هل استخدام Git Worktrees مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى