أفضل الممارسات — 10 نصائح

فكّر في وكيل Hermes وكأنه طاهٍ في مطبخ مزدحم. لن تسمح لكل طبّاخ بتقطيع الخضار على نفس لوح التقطيع بينما يزيّن الحلويات في الوقت نفسه — بل ستمنح كل واحدٍ منهم محطة عمل خاصة به. نفس المنطق ينطبق على قاعدة الأكواد البرمجية الخاصة بك.

---

١. شجرة عمل واحدة لكل تجربة

تخيّل أنك تدهن منزلاً. لن تدهن غرفة المعيشة والحمام في نفس الوقت بنفس الفرشاة — فستفسد الاثنين معاً. أشجار العمل في Git تتيح لك منح كل مهمة من مهام Hermes “غرفة” خاصة بها للعمل فيها.

بدلاً من ترك Hermes يعدّل الملفات مباشرة في مجلد مشروعك الرئيسي، أنشئ مساحة عمل منفصلة لكل تجربة. هذا يحافظ على أمان الكود الرئيسي ويبقي تغييراتك مرتبة.

٢. سمِّ الفروع باسم التجربة

امنح فروعك أسماءً واضحة ووصفية حتى تعرف أنت (ونسختك المستقبلية من نفسك) الغرض من كل فرع:

git checkout -b feature/hermes-checkpoints-docs

ليس branch-1 أو test-fix. كن محدداً — ستشكر نفسك لاحقاً.

٣. نفّذ عمليات الالتزام (Commit) بشكل متكرر

فكّر في عمليات الالتزام وكأنها حفظ لتقدّمك في لعبة فيديو. لن ترغب في اللعب لثلاث ساعات ثم تخسر كل شيء لأنك لم تحفظ.

نفّذ الالتزام عند المعالم الرئيسية:

git add .
git commit -m "Add checkpoint documentation"

أما بالنسبة للتعديلات الأصغر التي يقودها الأدوات بين ذلك، فاستخدم نقاط التفتيش في Hermes وأمر /rollback كشبكة أمان.

٤. تجنّب التشغيل من جذر المستودع الرئيسي

عند استخدام أشجار العمل، لا تشغّل Hermes من مجلد المستودع الأصلي. بدلاً من ذلك، انتقل إلى دليل شجرة العمل باستخدام cd. هذا يمنح كل وكيل نطاقاً واضحاً ويمنع التلوث العرضي بين المهام.

٥. استخدم hermes -w لأشجار العمل التلقائية

لا تريد إعداد أشجار العمل يدوياً؟ لدى Hermes اختصار مدمج:

cd /path/to/your/repo
hermes -w

هذا ينشئ تلقائياً شجرة عمل مؤقتة بفرع خاص بها. يمكنك حتى دمجه مع استعلام واحد:

hermes -w -z "Fix issue #123"

٦. شغّل الوكلاء المتوازيين بأمان

تريد تشغيل عدة وكلاء Hermes في وقت واحد؟ فقط افتح عدة أطراف طرفية وشغّل hermes -w في كل منها. كل جلسة تحصل تلقائياً على شجرة عمل وفرع معزول خاص بها. لا مزيد من تداخل الوكلاء في عمل بعضهم البعض.

٧. استخدم نقاط التفتيش + /rollback

الأخطاء تحدث. لا بأس في ذلك. يتيح لك Hermes إنشاء نقاط تفتيش أثناء الجلسة والعودة إليها إذا حدث خطأ ما. الأمر أشبه بامتلاك زر “تراجع” لأفعال وكيلك.

٨. ادمج أشجار العمل والفروع ونقاط التفتيش

إليك الصيغة الرابحة:

• أشجار العمل = ساحات عمل نظيفة لكل جلسة
• الفروع = سجل عالي المستوى للتجارب
• نقاط التفتيش + /rollback = تعافٍ سريع من الأخطاء

معاً، تمنحك تكراراً سريعاً، وتعافياً سهلاً، وطلبات سحب (Pull Requests) نظيفة.

٩. تعامل مع تطوير الواجهات بذكاء

إذا كنت تعمل على تطبيق TUI أو تطبيق سطح المكتب عبر أشجار عمل متعددة، فستحتاج إلى node_modules لكل منها. هذا كثير من الملفات المكررة. اطّلع على أدوات المساعدة htui / hgui التي تشارك تثبيتاً واحداً عبر الروابط الرمزية (symlink) — فهي توفر مساحة القرص ووقت الإعداد.

١٠. حافظ على نظافة فرعك الرئيسي

الهدف الأساسي من هذه الممارسات هو إبقاء فرعك الرئيسي مستقراً وجاهزاً للإنتاج. ادمج فروع أشجار العمل فقط عندما تكون مختبرة ومكتملة.

---

الخلاصة

فكّر في أشجار العمل كأنها مكاتب منفصلة في مكتب عمل. كل وكيل Hermes يحصل على مكتبه الخاص بأدواته الخاصة، فلا يفسد أحدٌ عملَ الآخر. الفروع هي نظام حفظ الملفات لديك، ونقاط التفتيش هي ملاحظاتك اللاصقة التي تقول “كنت هنا”.

نصيحة عملية: ابدأ فقط باستخدام hermes -w في مهمتك القادمة. إنها أسهل طريقة للحصول على العزل دون أي إعداد يدوي. وبمجرد أن تعتاد عليها، أضف نقاط التفتيش والتراجع إلى سير عملك. ستتساءل كيف كنت تعمل بدونها من قبل.

---