برومبت يخطط تحديث حزم npm مع اختبار ورجوع واضحين
قالب يفرق بين Current وWanted وLatest، ويحوّل سجل التغييرات إلى خطة صغيرة بدل تحديث كل الحزم دفعة واحدة.

ظهور رقم أحدث لا يعني أن تحديث المشروع كله هو الخطوة المناسبة الآن. ما تحتاجه أولًا: سبب التحديث، نطاقه، وما الذي قد يتغير للمستخدم. اطلب خطة محددة قبل السماح لأداة بتعديل الملفات.
اقرأ الأعمدة دون خلط
توثق npm أن Wanted هو الإصدار الذي يلائم النطاق المطلوب في package.json، بينما Latest يعتمد على وسم الناشر في السجل، ولا يلزم أن يكون أعلى رقم منشور. لذلك لا تتعامل مع الفرق بينهما كدليل أمان أو توافق مستقل.
أعد خطة مراجعة تحديث تبعية، دون تشغيل أو تعديل أي ملف. المدخلات: package.json المنقح، نتيجة npm outdated، نسخة Node ومدير الحزم، ورابط سجل التغييرات الرسمي: [املأ]. الحزمة وسبب التحديث: [إصلاح/ميزة/صيانة، مع مصدر الادعاء]. 1. ميز Current وWanted وLatest، وسجل ما لا تستطيع إثباته. 2. حدد التغيير المقترح الأصغر، واعرض التوافق المطلوب وpeer dependencies وتغييرات API الموثقة فقط. 3. حول كل تغيير مؤثر إلى اختبار سلوك واضح: قبل التحديث وبعده، مع معيار نجاح. 4. افصل البناء ونجاح الاختبارات عن إثبات خلو الحزمة من الثغرات. 5. اقترح فرعًا أو نسخة عمل معزولة، ومراجعة ملف القفل، وخطة رجوع تحفظ التعديلات السابقة. 6. توقف إذا احتاج التحديث أسرارًا أو تغيير إنتاج؛ لا تفترض موافقة. لا تختلق CVE أو سجل تغييرات أو نتائج اختبار، ولا تقترح force أو تحديث جميع الحزم لمجرد اختصار العمل.
مثال لقرار أضيق
إن كنت تعالج خطأ تنسيق في مكتبة واحدة، اجمع توثيق الإصلاح واختبارًا يعيد الخطأ. لا تضم ترقية إطار العمل وتغيير قاعدة البيانات إلى العملية نفسها بلا سبب. كلما كان الفرق أصغر، سهل ربط السلوك المتغير بتعديل معين.
المخرج الجيد قابل للمراجعة
يجب أن ترى الحزمة والنسخة والسبب والاختبار والتراجع في صفحة واحدة. إذا اكتفى الناتج بـ«حدث كل شيء وستصبح الأمور أفضل»، أعد طلب الأدلة. القالب يساعد على التخطيط، ولا يمثل تقرير ثغرات أو موافقة نشر.
المصادر والمراجع
دليل أصلي من B52؛ راجع الروابط للمعلومات المرجعية.


