يمنحك Git طريقة لرؤية كل تغيير وهو يحدث، فلا تطير على غير هدى بينما يعمل OpenCode على مشروعك. يمنحك GitHub مكانًا لحفظ عملك بأمان والتعاون مع الآخرين. تعلّم هذه الأدوات سيمنحك ثقة أكبر في مشاريعك الخاصة، ويهيئك لتصبح مساهمًا مفتوح المصدر.
ما هو Git؟
Git نظام تحكم بالإصدارات يسجّل كل تغيير في كل ملف في مشروع. كل commit لقطة يمكنك العودة إليها، فلا شيء يُفقد حقًا: إن أجرى OpenCode تغييرًا لا يعجبك، يمكنك التراجع عنه.
يعمل Git بالكامل على جهازك. لا تحتاج إلى حساب أو خادم أو اتصال إنترنت للاستفادة منه. حتى بلا remote، يمنحك Git تاريخًا كاملًا لمشروعك.
ما هو GitHub؟
GitHub منصة سحابية لاستضافة Git repositories. هو المكان الذي تحفظ فيه عملك نسخًا احتياطية، وتشارك المشاريع علنًا أو خاصًا، وتتعاون مع أشخاص آخرين. وهو أيضًا حيث يعيش معظم عالم المصدر المفتوح.
يسهل الخلط بينهما: Git هو الأداة التي تتبّع التغييرات على جهازك، وGitHub مكان شائع لاستضافة الـ repositories التي ينشئها Git.
ابدأ مع GitHub Desktop
GitHub Desktop واجهة GitHub ممتازة للبشر. وهو أيضًا أسهل طريقة للانتقال من الصفر إلى إعداد Git عامل، لأنه يفعل ثلاثة أشياء في تثبيت واحد:
- يثبّت Git على جهازك.
- يتيح لك التسجيل في GitHub أو تسجيل الدخول إلى حساب موجود مباشرة من التطبيق.
- يصادق Git CLI نيابة عنك، حتى تتمكن من الدفع إلى GitHub دون إعداد مفاتيح SSH أو رموز وصول شخصية.
بعد نسخ repository أو إنشائه في GitHub Desktop، يمنحك أيضًا واجهة رسومية لتصفح تاريخ مشروعك وتصور ما تغيّر بالضبط في كل commit. هذا التصور أبسط طريقة لمراجعة ما فعله OpenCode بملفاتك.
إن كان لديك Git وحساب GitHub بالفعل، يمكنك تخطي GitHub Desktop. التمرين يعمل مع ذلك.
ثبّت gh CLI
إن كان GitHub Desktop واجهة GitHub للبشر، فإن gh CLI واجهة GitHub للوكلاء. مع تثبيت gh، يمكن لـ OpenCode قراءة الـ issues، وفتح pull requests، وجلب فروقات PR، وترك تعليقات، والتحقق من حالة CI، وإنشاء repositories نيابة عنك، كله دون أن تغادر جلستك.
ستثبّته كجزء من هذا التمرين وتبدأ استخدامه من OpenCode فورًا.
ما الذي ستفعله
- ثبّت GitHub Desktop و
ghCLI، وأضف قاعدةghإلى AGENTS.md العام - مهّد repository في مجلد مشروع حتى يبدأ Git بتتبع التغييرات
- اعمل commits: احفظ لقطات من عملك مع وصف قصير لما تغيّر
- راجع الفروقات: استخدم GitHub Desktop أو
git diffلرؤية ما غيّره OpenCode في ملفاتك بالضبط - ادفع إلى GitHub: احفظ repository نسخًا احتياطية في السحابة، عامًا أو خاصًا
- أنشئ branch: جرّب شيئًا تجريبيًا دون التأثير على مشروعك الرئيسي
بعد أن تعمل الأساسيات، يمكنك المضي أبعد: اكتب .gitignore لإبقاء الفوضى خارج الـ repository الخاص بك، أو افتح pull request، أو استكشف تاريخ commits مشروعك على github.com.
ساهم في OpenCode School
بعد أن ترتاح مع الـ commits والـ branches وGitHub، أنت جاهز لتقديم أول مساهمة حقيقية مفتوحة المصدر. يتضمن هذا التمرين مسارًا ثانيًا اختياريًا يمشيك فيه OpenCode عبر عمل fork لـ OpenCode School repository، وإجراء تحسين صغير، وفتح pull request ضده.
لست مضطرًا لأخذ هذا المسار لإنهاء التمرين. إن فضّلت البقاء مع repo الخاص بك، فلا بأس. لكن إن كنت تريد المساهمة في المصدر المفتوح يومًا، فهذه طريقة منخفضة المخاطر لفعل ذلك. سيساعدك OpenCode على إيجاد تغيير صغير والمشي معك عبر كل خطوة، باستخدام gh لتصفح الـ issues المفتوحة وفتح الـ PR نيابة عنك.
وتذكّر: لا تحتاج إلى أي من هذا للمساعدة في تحسين OpenCode School. فتح GitHub issue عن شيء مربك أو معطوب أو ناقص مرحّب به دائمًا ولا يتطلب Git أصلًا. راجع المساهمة للمزيد.