GITHUB_ACTIONS_GUIDE.md

🚀 دليل استخدام سياق المشروع من الجوال

الهدف

تشغيل سكريبت استخراج السياق أونلاين على GitHub دون الحاجة إلى كمبيوتر.

---

⚡ الخطوات (من الجوال)

1. إضافة الملفات للمستودع

في مستودعك على GitHub، أنشئ هذين الملفين (يمكنك من التطبيق أو المتصفح):

.github/
├── scripts/
│   └── repo_to_context.py    ← السكريبت
└── workflows/
    └── generate-context.yml  ← الـ Workflow

للإنشاء من الجوال:

1. افتح تطبيق GitHub
2. ادخل إلى مستودعك
3. اضغط ➕ (Add file) → Create new file
4. اكتب المسار: .github/workflows/generate-context.yml
5. الصق محتوى ملف الـ Workflow
6. اضغط Commit
7. كرر نفس الخطوة لملف السكريبت: .github/scripts/repo_to_context.py

---

2. تشغيل الـ Workflow

1. من تطبيق GitHub، ادخل إلى مستودعك
2. اذهب إلى تبويب Actions (الأسفل)
3. اختر 📦 Generate Project Context
4. اضغط Run workflow (الأعلى)
5. اترك الإعدادات الافتراضية واضغط Run workflow مرة أخرى

---

3. تحميل الملف

1. انتظر 30 ثانية حتى تكتمل العملية (سترى ✅ أخضر)
2. ارجع إلى تبويب Code (الملفات)
3. ستجد ملفاً جديداً باسم project_context.txt
4. اضغط عليه → اضغط ⬇️ (Download) أو انسخ النص

---

📋 ما يفعله السكريبت

• ✅ يقرأ كل ملفات الكود في المشروع
• ✅ يستبعد الصور والملفات الثنائية
• ✅ ينظمها في ملف نصي واحد منسق
• ✅ يضيف شجرة الملفات + الإحصائيات
• ✅ يدعم اللغة العربية (UTF-8)

---

⚙️ خيارات متقدمة (اختياري)

عند تشغيل الـ Workflow، يمكنك تغيير:

• max_size: حجم السياق (افتراضي 800000 حرف)
• split: true إذا كان المشروع كبيراً (ينتج عدة ملفات)
• format: txt أو md

---

🔄 الاستخدام مع Gemini Flash

بعد تحميل project_context.txt:

1. افتح Gemini Flash في متصفح الجوال
2. ارفع الملف
3. ابدأ المحادثة: "هذا مشروعي. أريدك أن تُحسّن دالة X"

---

🛟 في حال واجهت مشكلة

• العملية تفشل؟ تأكد أن السكريبت موجود في .github/scripts/repo_to_context.py
• الملف غير موجود؟ تأكد من صلاحيات الـ Workflow (يجب أن يحتوي على permissions: contents: write)
• مشروع كبير؟ شغل الـ Workflow مع split = true