منشئ رسائل Conventional Commits

صياغة رسائل التعديل لـ Git وفقاً لمعيار Conventional Commits بدقة وتنظيم.

0/72

املأ الوصف لمعاينة رسالة الإيداع

صيغة Conventional Commits

<type>[scope]: <description>

[optional body]

[optional footer(s)]

أمثلة شائعة

حول منشئ رسائل Conventional Commits — الدليل التفصيلي

الفئة: DevOps والمعايير معالجة محلية 100% في المتصفح

تُنشئ أداة توليد الالتزامات القياسية (Conventional Commit Generator) رسائل التزام مهيكلة لـ Git وفقاً لمواصفات Conventional Commits. وترشد المطورين خلال اختيار النوع (Type)، والنطاق (Scope)، وسطر الموضوع (Subject)، والوصف التفصيلي الاختياري في المتن (Body)، وقضايا التذييل (Footer).

يمكنك بسهولة الإشارة إلى التغييرات الجذرية المعطلة للتوافق عبر صيغة علامة التعجب (`type!: description`)، والإشارة إلى المشكلات التي تم حلها (`Closes #123`)، وتصدير رسائل التزام معيارية تدعم الأدوات المؤتمتة مثل `semantic-release` ومولدات سجل التغييرات الآلية.

#git #commit #conventional #message #changelog

الميزات والقدرات الرئيسية

  • دليل كامل للأنواع: feat وfix وdocs وstyle وrefactor وperf وtest وbuild وci وchore وrevert
  • حقل إدخال اختياري للنطاق مع تنبيهات في الوقت الفعلي لطول سطر الموضوع وصيغة الفعل الأمرية
  • زر تبديل بنقرة واحدة لتحديد التغييرات الجذرية (Breaking Change) مع تطبيق صيغة علامة التعجب القياسية (`!`)
  • توليد تلقائي لتذييل ربط المشكلات مع إمكانية نسخ أمر `git commit -m` بنقرة واحدة

طريقة الاستخدام

  1. 1

    اختر نوع الالتزام (مثل `feat` للميزات الجديدة، أو `fix` لإصلاح الأخطاء البرمجية).

  2. 2

    أدخل النطاق اختيارياً (مثل `api` أو `auth`) مع وصف موجز بصيغة الأمر.

  3. 3

    راجع نص الالتزام المُجمّع وانسخ أمر `git commit` الكامل لاستخدامه في الطرفية.

حالات الاستخدام الشائعة

  • ← تأهيل وتدريب الفرق الهندسية على معايير موحدة لسجل التزامات Git
  • ← أتمتة ترقيات الإصدارات الدلالية وملاحظات الإصدار الآلية عبر مسارات التكامل والنشر المستمر CI/CD
  • ← تمييز التغييرات الجذرية غير المتوافقة مع الإصدارات السابقة في واجهات API أثناء تحديثات المكتبات الرئيسية

أدوات ذات صلة

الأسئلة الشائعة والخصوصية

ما هي ترقية الإصدار الدلالي المقابلة لكل نوع من أنواع الالتزامات؟

وفقاً لأعراف Conventional Commits القياسية، يؤدي الالتزام من نوع `fix` إلى ترقية PATCH، ويؤدي `feat` إلى ترقية MINOR، بينما يؤدي أي التزام يتضمن `BREAKING CHANGE` إلى ترقية MAJOR.

هل ينبغي أن ينتهي سطر الموضوع بنقطة في نهايته؟

كلا. توصي أفضل ممارسات Conventional Commits بكتابة جملة أمرية موجزة دون نقطة في نهايتها (مثال: `feat: allow user avatar upload`).