حول منشئ رسائل Conventional Commits — الدليل التفصيلي
تُنشئ أداة توليد الالتزامات القياسية (Conventional Commit Generator) رسائل التزام مهيكلة لـ Git وفقاً لمواصفات Conventional Commits. وترشد المطورين خلال اختيار النوع (Type)، والنطاق (Scope)، وسطر الموضوع (Subject)، والوصف التفصيلي الاختياري في المتن (Body)، وقضايا التذييل (Footer).
يمكنك بسهولة الإشارة إلى التغييرات الجذرية المعطلة للتوافق عبر صيغة علامة التعجب (`type!: description`)، والإشارة إلى المشكلات التي تم حلها (`Closes #123`)، وتصدير رسائل التزام معيارية تدعم الأدوات المؤتمتة مثل `semantic-release` ومولدات سجل التغييرات الآلية.
الميزات والقدرات الرئيسية
- دليل كامل للأنواع: feat وfix وdocs وstyle وrefactor وperf وtest وbuild وci وchore وrevert
- حقل إدخال اختياري للنطاق مع تنبيهات في الوقت الفعلي لطول سطر الموضوع وصيغة الفعل الأمرية
- زر تبديل بنقرة واحدة لتحديد التغييرات الجذرية (Breaking Change) مع تطبيق صيغة علامة التعجب القياسية (`!`)
- توليد تلقائي لتذييل ربط المشكلات مع إمكانية نسخ أمر `git commit -m` بنقرة واحدة
طريقة الاستخدام
- 1
اختر نوع الالتزام (مثل `feat` للميزات الجديدة، أو `fix` لإصلاح الأخطاء البرمجية).
- 2
أدخل النطاق اختيارياً (مثل `api` أو `auth`) مع وصف موجز بصيغة الأمر.
- 3
راجع نص الالتزام المُجمّع وانسخ أمر `git commit` الكامل لاستخدامه في الطرفية.
حالات الاستخدام الشائعة
- ← تأهيل وتدريب الفرق الهندسية على معايير موحدة لسجل التزامات Git
- ← أتمتة ترقيات الإصدارات الدلالية وملاحظات الإصدار الآلية عبر مسارات التكامل والنشر المستمر CI/CD
- ← تمييز التغييرات الجذرية غير المتوافقة مع الإصدارات السابقة في واجهات API أثناء تحديثات المكتبات الرئيسية
أدوات ذات صلة
مولد وسوم SEO و Open Graph
توليد وسوم HTML الوصفية و Open Graph و بطاقات Twitter لتحسين ظهور المواقع في محركات البحث.
مولد ملف .gitignore
إنشاء ملفات .gitignore المخصصة للغات الأطر البرمجية المختلفة (Node و Python و Rust و Go).
مولد تراخيص المصادر المفتوحة
إنشاء نصوص التراخيص مفتوحة المصدر (MIT و Apache 2.0 و GPLv3 و BSD) مع حقوق النشر.
مولد ملف README لمشاريع Git
توليد قوالب ملفات README احترافية للمشاريع مفتوحة المصدر مع الشارات والإرشادات.
حاسبة ترقيم الإصدارات SemVer
مقارنة وحساب نطاقات ترقيم الإصدارات الدلالية (SemVer) وحل تعارضات الحزم.
عارض مواصفات Swagger و OpenAPI
استعراض واختبار وتوثيق مواصفات واجهات البرمجة بصيغتي OpenAPI و Swagger محلياً.
الأسئلة الشائعة والخصوصية
ما هي ترقية الإصدار الدلالي المقابلة لكل نوع من أنواع الالتزامات؟
وفقاً لأعراف Conventional Commits القياسية، يؤدي الالتزام من نوع `fix` إلى ترقية PATCH، ويؤدي `feat` إلى ترقية MINOR، بينما يؤدي أي التزام يتضمن `BREAKING CHANGE` إلى ترقية MAJOR.
هل ينبغي أن ينتهي سطر الموضوع بنقطة في نهايته؟
كلا. توصي أفضل ممارسات Conventional Commits بكتابة جملة أمرية موجزة دون نقطة في نهايتها (مثال: `feat: allow user avatar upload`).