بعد أن ينتهي وكيلك الذكي من مهمة البرمجة، تبقى التغييرات معلّقة دون تسجيل. لا commits، ولا توثيق لما تعلّمه، ولا سجل للقرارات المعمارية. فتجد نفسك مضطرًا للقيام بأعمال الصيانة بنفسك، أو تُترك دون إنجاز.

تعمل مهارة Smart Commit تلقائيًا بعد كل مهمة برمجية وتتولى أمرين: الحفاظ على تحديث ملف CLAUDE.md وإنشاء git commits نظيفة برسائل واضحة.

تستخدم المهارة نظام تقييم للتعقيد لتحديد مستوى الصيانة الذي تستحقه كل مهمة. إصلاح خطأ إملائي في سطر واحد يحصل على commit بسيط لا أكثر. أما إعادة هيكلة متعددة الملفات تمتد على ثلاثة مجلدات، فتحصل على رسالة commit وصفية مع نص تفصيلي، إضافةً إلى تحديث CLAUDE.md يوثّق ما تعلّمه الوكيل عن قاعدة الكود.

بالنسبة لـ CLAUDE.md، تركّز المهارة على المعلومات التي ستوفّر على الجلسات المستقبلية إعادة اكتشاف الأمور بالطريقة الصعبة: القرارات المعمارية، ورؤى التصحيح غير الواضحة، وخصائص البيئة، والاتفاقيات الجديدة. وتتجاهل التحديثات حين يكون التغيير واضحًا من الكود نفسه.

أما للـ commits، فتتبع المهارة تنسيق conventional commit (feat, fix, refactor, إلخ) برسائل محددة النطاق تصف النية لا مجرد الملفات التي تغيّرت. وتُضيف الملفات بشكل انتقائي بدلًا من تشغيل git add بشكل أعمى، لتتجنب الالتزام العرضي بملفات .env أو مخرجات البناء. وتدفع التغييرات بعد كل commit لضمان مزامنة عملك دائمًا.

تتعامل المهارة أيضًا مع الحالات الاستثنائية بكفاءة: أشجار العمل غير النظيفة التي تحتوي على تغييرات لأشخاص آخرين، والـ monorepos ذات التوثيق لكل حزمة، وتعارضات الفروع التي تستلزم تدخلًا بشريًا، والمشاريع التي ليست git repos أصلًا.

تعمل مع Claude Code وCursor وCodex CLI وVS Code Copilot وأي وكيل يدعم معيار SKILL.md.