skill

استخدام Git Worktrees

يستخدم عند بدء عمل على ميزة تتطلب عزلا عن مساحة العمل الحالية أو قبل تنفيذ خطط التطبيق - يضمن وجود مساحة عمل معزولة عبر الأدوات الأصلية أو استخدام git worktree كبديل.

obra202,261+ تثبيتموثوق

نبذة

# استخدام 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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 مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في الإنتاجية والمكتب.

كل بدائل استخدام Git Worktrees ←
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/skills
البحث عن المهارات
يساعد المستخدمين على اكتشاف وتثبيت مهارات الوكلاء عندما يطرحون أسئلة مثل "كيف أفعل X؟"، "ابحث عن مهارة ل X"، "هل توجد مهارة يمكنها..."، أو يعبرون عن ا…3,611,572+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
استخدام الوسائط
احصل على أو أنشئ أي وسائط لفيديو HyperFrames - موسيقى، مؤثرات صوتية، صور، أيقونات، شعارات، تعليق صوتي، صورة رمزية وفيديو مولد، نصوص، قصاصات، درجات ألو…1,085,267+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تحسين هيكلية قاعدة الكود
افحص قاعدة بيانات برمجية بحثا عن فرص للتحسين والتعميق، وقدمها كتقرير HTML مرئي، ثم تعمق في أي فرصة تختارها.1,040,100+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تسليم المهام
لخص المحادثة الحالية في وثيقة تسليم ليتابعها وكيل آخر.946,569+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
فرز أولي
نقل المشكلات وطلبات السحب الخارجية عبر آلة حالة لأدوار الفرز، وتصنيفها، والتحقق منها، والتدقيق فيها عند الحاجة، وكتابة ملخصات جاهزة للوكلاء.881,979+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تعليم
علم المستخدم مهارة أو مفهوما جديدا ضمن مساحة العمل هذه.778,928+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في الإنتاجية والمكتب