تقديم Pull Request 🔀

إرشادات للمساهمة في مشروع OpenClaw من خلال Pull Requests.

قبل أن تبدأ

✅ قائمة التحقق السريعة

  • ✓ تحقق من Issues الموجودة لتجنب التكرار
  • ✓ ناقش التغييرات الكبيرة في Issue أولاً
  • ✓ اتبع معايير الكود الموجودة
  • ✓ قم بتشغيل الاختبارات قبل التقديم

سير العمل

1. Fork المستودع

انقر على زر "Fork" في أعلى صفحة المستودع على GitHub.

2. Clone النسخة المستنسخة

git clone https://github.com/YOUR_USERNAME/openclaw.git
cd openclaw

3. إنشاء فرع جديد

git checkout -b feature/your-feature-name

💡 نصيحة: تسمية الفروع

استخدم أسماء وصفية:

  • feature/add-telegram-support — ميزة جديدة
  • fix/memory-leak-session — إصلاح خطأ
  • docs/update-install-guide — تحديث التوثيق

4. قم بإجراء التغييرات

  • اكتب كوداً نظيفاً وقابلاً للصيانة
  • اتبع أسلوب الكود الموجود
  • أضف تعليقات عند الضرورة
  • حدّث التوثيق إذا لزم الأمر

5. قم بتشغيل الاختبارات

# تثبيت التبعيات
pnpm install

# تشغيل الاختبارات
pnpm test

# فحص linting
pnpm lint

6. Commit التغييرات

git add .
git commit -m "feat: add new feature description"

📝 تنسيق رسائل Commit

استخدم Conventional Commits:

  • feat: ميزة جديدة
  • fix: إصلاح خطأ
  • docs: تحديث التوثيق
  • refactor: إعادة هيكلة الكود
  • test: إضافة اختبارات
  • chore: مهام صيانة

7. Push إلى Fork الخاص بك

git push origin feature/your-feature-name

8. إنشاء Pull Request

  1. انتقل إلى المستودع الأصلي على GitHub
  2. انقر على "New Pull Request"
  3. اختر فرعك من القائمة المنسدلة
  4. املأ قالب PR بالتفاصيل
  5. انقر على "Create Pull Request"

إرشادات PR

العنوان والوصف

  • عنوان واضح: صِف ما يفعله PR في جملة واحدة
  • السياق: اشرح لماذا التغيير ضروري
  • التنفيذ: قدّم نظرة عامة على النهج
  • الاختبار: صِف كيف تم اختبار التغييرات

حجم PR

  • احتفظ بـ PRs مركزة على تغيير واحد
  • قسّم التغييرات الكبيرة إلى PRs أصغر
  • تجنب التغييرات غير المرتبطة في نفس PR

مراجعة الكود

  • استجب للمراجعات بسرعة
  • كن منفتحاً للتعليقات
  • اطلب التوضيح إذا لزم الأمر
  • قم بإجراء التغييرات المطلوبة بسرعة

بعد الدمج

بمجرد دمج PR الخاص بك:

  • احذف الفرع المحلي والبعيد
  • احتفظ بـ fork الخاص بك محدثاً
  • شاهد المستودع للتحديثات
# تحديث fork الخاص بك
git checkout main
git pull upstream main
git push origin main

# حذف الفرع
git branch -d feature/your-feature-name
git push origin --delete feature/your-feature-name

موارد إضافية