skill

إنهاء فرع تطوير

تستخدم عندما يكتمل التنفيذ، وتجتاز جميع الاختبارات بنجاح، وتحتاج إلى اتخاذ قرار بشأن كيفية دمج العمل.

obra198,790+ تثبيتموثوق

نبذة

# إنهاء فرع تطوير

## نظرة عامة

**المبدأ الأساسي:** التحقق من الاختبارات ← اكتشاف البيئة ← تقديم الخيارات ← تنفيذ الاختيار ← التنظيف.

**الإعلان في البداية:** "أنا أستخدم مهارة إنهاء فرع تطوير لإكمال هذا العمل."

## الخطوة 1: التحقق من الاختبارات

تشغيل مجموعة الاختبارات الكاملة للمشروع (`npm test` / `cargo test` / `pytest` / `go test ./...`).

**إذا فشلت الاختبارات**، أبلغ عن الإخفاقات وتوقف — تظهر القائمة بعد نجاح جميع الاختبارات:

``` Tests failing (<N> failures). Must fix before completing:

[Show failures] ```

**إذا نجحت الاختبارات:** تابع إلى الخطوة 2.

## الخطوة 2: اكتشاف البيئة

```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) # Capture now, while still inside the workspace — Step 5 changes directory # before cleanup (Step 6) needs this value WORKTREE_PATH=$(git rev-parse --show-toplevel) ```

يحدد هذا أي قائمة يجب عرضها وكيفية عمل التنظيف:

| الحالة | القائمة | التنظيف | |-------|------|---------| | `GIT_DIR == GIT_COMMON` (مستودع عادي) | 3 خيارات قياسية | لا يوجد worktree للتنظيف | | `GIT_DIR != GIT_COMMON`، فرع مسمى | 3 خيارات قياسية | يعتمد على المصدر (انظر الخطوة 6) | | `GIT_DIR != GIT_COMMON`، رأس منفصل (detached HEAD) | خياران مخفضان (لا دمج) | يدار خارجيا — يترك في مكانه |

## الخطوة 3: تحديد الفرع الأساسي

الفرع الأساسي هو ما تفرع منه هذا العمل — عادة ما يكون مذكورا في الخطة، أو المحادثة، أو الفرع الأصلي (upstream). إذا لم يكن معروفا بالفعل، اسأل: "هذا الفرع انقسم من <أفضل تخمين لديك> - هل هذا صحيح؟" تأكد قبل الدمج: الدمج في الفرع الأساسي الخاطئ مكلف للتراجع عنه.

## الخطوة 4: تقديم الخيارات

**المستودع العادي و worktree الفرع المسمى — قدم هذه الخيارات الثلاثة بالضبط:**

``` Implementation complete. What would you like to do?

1. Merge back to <base-branch> locally 2. Push and create a Pull Request 3. Keep the branch as-is (I'll handle it later)

Which option? ```

**رأس منفصل (detached HEAD) — قدم هذين الخيارين بالضبط:**

``` Implementation complete. You're on a detached HEAD (externally managed workspace).

1. Push as new branch and create a Pull Request 2. Keep as-is (I'll handle it later)

Which option? ```

قدم القائمة تماما كما هي مكتوبة — موجزة، مع كل خيار يأتي من القائمة أعلاه. لا يتم التخلص من العمل إلا استجابة لطلب صريح من شريكك البشري (انظر "إذا طلب شريكك البشري التخلص من العمل" أدناه). انتظر إجابته؛ قرار التكامل يعود إليه.

## الخطوة 5: تنفيذ الاختيار

### الخيار 1: الدمج محليا

```bash # Get main repo root for CWD safety MAIN_ROOT=$(git -C "$(git rev-parse --git-common-dir)/.." rev-parse --show-toplevel) cd "$MAIN_ROOT"

# Merge first — verify success before removing anything git checkout <base-branch> git pull git merge <feature-branch>

# Verify tests on merged result <test command> ```

إذا فشلت الاختبارات على النتيجة المدمجة: توقف، اترك ال worktree والفرع في مكانهما، وتحقق — لم يتم دفع أي شيء، لذا الدمج محلي وقابل للاسترداد.

بمجرد أن تكون النتيجة المدمجة ناجحة: نظف ال worktree (الخطوة 6)، ثم احذف الفرع:

```bash git branch -d <feature-branch> ```

### الخيار 2: الدفع وإنشاء طلب سحب (Pull Request)

```bash git push -u origin <feature-branch> # From a detached HEAD, name the new branch on the remote: # git push origin HEAD:refs/heads/<new-branch> ```

ثم أنشئ طلب السحب/الدمج (pull/merge request) مقابل <base-branch> باستخدام أدوات ال forge — واجهة سطر الأوامر (CLI) الخاصة به إذا كانت متاحة، أو عنوان URL للإنشاء الذي تطبعه معظم ال forges عند الدفع — باتباع قالب واتفاقيات طلب السحب للمستودع إذا كانت موجودة، وأبلغ شريكك البشري بعنوان URL.

احتفظ بال worktree — شريكك البشري سيقوم بالتكرار بناء على ملاحظات طلب السحب هناك.

### الخيار 3: الاحتفاظ كما هو

أبلغ: "الاحتفاظ بالفرع <الاسم>. ال worktree محفوظ في <المسار>."

### إذا طلب شريكك البشري التخلص من العمل

هذا المسار موجود فقط استجابة لطلب صريح للتخلص من العمل. تأكد أولا:

``` This will permanently delete: - Branch <name> - All commits: <commit-list> - Worktree at <path>

Type 'discard' to confirm. ```

انتظر هذا التأكيد الدقيق. عندما يصل:

```bash MAIN_ROOT=$(git -C "$(git rev-parse --git-common-dir)/.." rev-parse --show-toplevel) cd "$MAIN_ROOT" ```

ثم نظف ال worktree (الخطوة 6) واحذف الفرع بالقوة:

```bash git branch -D <feature-branch> ```

## الخطوة 6: تنظيف مساحة العمل

**يتم تشغيله للخيار 1 وللطلبات المؤكدة بالتخلص من العمل.** الخياران 2 و 3 يحافظان دائما على ال worktree. لقد قام كلا المتصلين بالفعل بتغيير الدليل إلى جذر المستودع الرئيسي — يجب أن يتم إزالة ال worktree من خارج ال worktree — ويستخدمان قيم `GIT_DIR`/`GIT_COMMON`/`WORKTREE_PATH` التي تم التقاطها في الخطوة 2، قبل تغيير الدليل هذا.

**إذا كان `GIT_DIR == GIT_COMMON`:** مستودع عادي، لا يوجد worktree للتنظيف. انتهى.

**إذا كان `WORKTREE_PATH` تحت `.worktrees/` أو `worktrees/`:** أنشأت القوى الخارقة هذا ال worktree — نحن نملك التنظيف:

```bash git worktree remove "$WORKTREE_PATH" git worktree prune # Self- ```

التثبيت

شغل هذا الأمر

npx skills add obra/superpowers

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

ثبت باستخدام `npx skills add obra/superpowers`، أو استنسخ المستودع وانسخ مجلد `skills/finishing-a-development-branch` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة إنهاء فرع تطوير؟

تستخدم عندما يكتمل التنفيذ، وتجتاز جميع الاختبارات بنجاح، وتحتاج إلى اتخاذ قرار بشأن كيفية دمج العمل.

كيف أثبت إنهاء فرع تطوير؟

شغل هذا الأمر في الطرفية:

npx skills add obra/superpowers
مع أي أدوات ذكاء اصطناعي تعمل إنهاء فرع تطوير؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور إنهاء فرع تطوير؟

طورها obra.

هل إنهاء فرع تطوير مجانية؟

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

أصول ذات صلة

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

كل بدائل إنهاء فرع تطوير ←
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+

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

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

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