مهارة كتابة رسائل Commit بصيغة Conventional Commits

مهارة تشغيل جاهزة لوكلاء الكود (Claude Code وCursor وCodex وAntigravity) تحوّل التغييرات المجهّزة للـ commit إلى رسالة منظّمة بصيغة Conventional Commits بدل رسائل غامضة مثل «update» أو «fix». تقرأ المهارة ناتج git diff --staged، تستنتج النوع الصحيح (feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert) والنطاق (scope) من المسارات المتغيّرة، ثم تكتب عنوانًا أمريًّا موجزًا لا يتجاوز 72 حرفًا، يليه متن اختياري يشرح السبب لا الآلية، وحواشي تربط المهمة (Closes/Refs) وتُبرز أي تغيير كاسر للتوافق عبر BREAKING CHANGE أو علامة «!». تفرض المهارة قواعد صارمة: عدم اختراع تغييرات غير موجودة في الـ diff، فصل الالتزامات غير المترابطة إلى commits مستقلة، وطلب المعلومة الناقصة (مثل رقم المهمة) بدل التخمين. مناسبة لتوحيد سجل الـ git داخل الفريق، وتفعيل الإصدار الدلالي التلقائي (semantic-release)، وتوليد changelog نظيف.

رسالة Git commit كاملة بصيغة Conventional Commits: سطر «النوع(النطاق): عنوان أمري» ≤ 72 حرفًا، يليه متن اختياري يشرح السبب والأثر، ثم حواشي لربط المهمة (Closes/Refs) وإبراز أي BREAKING CHANGE. تُخرج داخل كتلة نص واحدة جاهزة للصق في git commit.