skill
إنهاء فرع تطوير
تستخدم عندما يكتمل التنفيذ، وتجتاز جميع الاختبارات بنجاح، وتحتاج إلى اتخاذ قرار بشأن كيفية دمج العمل.
نبذة
# إنهاء فرع تطوير
## نظرة عامة
**المبدأ الأساسي:** التحقق من الاختبارات ← اكتشاف البيئة ← تقديم الخيارات ← تنفيذ الاختيار ← التنظيف.
**الإعلان في البداية:** "أنا أستخدم مهارة إنهاء فرع تطوير لإكمال هذا العمل."
## الخطوة 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يعمل مع
خطوات التثبيت
ثبت باستخدام `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.
هل إنهاء فرع تطوير مجانية؟
نعم، يمكنك استخدامها مجانا.
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
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى