برومبت يكتب رسالة Commit من الفرق الحقيقي دون اختراع اختبارات

رسالة الالتزام المفيدة تختصر قرارًا يمكن الرجوع إليه. لا يكفي أن تقول «تحسينات عامة»، ولا يصح أن تضيف «جميع الاختبارات ناجحة» لمجرد أن أداة كتبت الرسالة. هذا القالب يحول فرقًا راجعته إلى وصف محدد.

جهز المدخل المناسب

استخدم الفرق المجهز للحفظ إذا كان المطلوب وصف الالتزام التالي، واحذف منه الأسرار والبيانات الشخصية قبل مشاركته. لا ترسل مستودعك كاملًا عندما يكفي فرق ملفين، ولا تفترض أن الأداة رأت ملفات لم توفرها.

القالب

اكتب رسالة Commit عربية موجزة من المدخلات أدناه.
الفرق المجهز الذي راجعته: [ألصق الفرق المنقح]
سبب التعديل المعروف: [اكتبه أو قل غير مذكور]
التحقق المنفذ فعلًا ونتيجته: [اكتب الدليل أو لم ينفذ]

القواعد:
- عنوان يصف السلوك المتغير، لا عبارة تحسينات عامة.
- لا تضف ملفات أو نتائج أو إصلاحات غير ظاهرة في المدخل.
- ميّز سببًا مؤكدًا عن استنتاج محتمل.
- لا تدّع اختبارًا أو نشرًا أو حل المشكلة نهائيًا دون دليل.
- إذا لم يكفِ الفرق لفهم الغرض، اذكر السؤال الناقص خارج الرسالة.

أخرج عنوانًا قصيرًا، ثم فقرتين عند الحاجة: ما تغير ولماذا، والتحقق الفعلي. لا تضع استنتاجاتك ضمن الحقائق.

مثال من B52 للتوضيح

إذا كان الفرق يضيف overflow-wrap إلى عنوان بطاقة، فقد يكون الوصف المناسب «اسمح بالتفاف العناوين الطويلة في البطاقات». أما «أصلح جميع مشاكل الجوال» فيتجاوز الدليل. وإذا راجعت عرضًا واحدًا فقط، اذكره بدل تعميم الاختبار على كل الأجهزة.

راجع الناتج قبل استعماله

• هل يصف الملفات التي جهزتها فعلًا؟
• هل يستطيع قارئ فهم أثر التغيير دون معرفة المحادثة السابقة؟
• هل نقلت الأداة توقعًا أو هدفًا إلى نتيجة مكتملة؟
• هل أضافت صياغة تحقق لم تجره؟

القالب من إعداد B52. المرجع التقني أدناه يشرح أي فرق تعرضه أوامر Git؛ كتابة رسالة جيدة لا تحفظ الالتزام تلقائيًا ولا تنشره.