tests-maintenance
مراجعة وصيانة جودة مجموعة الاختبارات
تتراكم الديون التقنية في مجموعات الاختبارات بمرور الوقت. تفقد الاختبارات المعطلة سياقها، وتفتقر استثناءات Neovim إلى التوثيق، ويصبح محتوى الاختبار بلا معنى. تساعد هذه المهارة المشرفين على مراجعة الاختبارات المعطلة بشكل منهجي، وتوثيق أسباب الاستثناءات، وتحسين قابلية قراءة الاختبارات.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "tests-maintenance". البحث عن الاختبارات المعطلة في مشروع IdeaVim
النتيجة المتوقعة:
- وجدت 3 اختبارات معطلة:
- - DeleteMotionTest.testDeleteLine: معطل بسبب خطأ في تحديد الموقع (#1234)
- - SearchTest.testNextWord: معطل - يحتاج إلى تحقيق
- - VisualModeTest.testBlockSelection: معطل - مشكلة توافق Neovim
- التوصية: تشغيل DeleteMotionTest للتحقق مما إذا كان الإصلاح في الالتزام abc123 حل المشكلة.
استخدام "tests-maintenance". مراجعة استثناءات Neovim
النتيجة المتوقعة:
- وجدت 5 تعليقات @TestWithoutNeovim تفتقد إلى الوصف:
- - ScrollTest.testScrollDown: يستخدم سبب UNCLEAR，但没有描述
- - CommandTest.testShowCmd: يستخدم سبب SHOW_CMD، يحتاج إلى رابط YouTrack
- - PluginTest.testSurround: يستخدم سبب PLUGIN، الوصف كافٍ
- الإجراءات المطلوبة: إضافة أوصاف إلى 2 تعليق، التحقق من صلاحية سبب 1
استخدام "tests-maintenance". فحص قابلية قراءة محتوى الاختبار
النتيجة المتوقعة:
- وجدت 2 ملف اختبارات يحتويان على محتوى عديم المعنى:
- - ChangeActionTest: يحتوي على نص بديل 'asdfgh' في 3 طرق اختبار
- - MotionTest: يحتوي على سلاسل 'qwerty' في طرق الإعداد
- استبدال بـ: قطع كود واقعية من إرشادات CONTRIBUTING.md
التدقيق الأمني
آمنThis is a legitimate test maintenance skill from JetBrains for the IdeaVim project. All 74 static findings are false positives: SHA-256 hash identifiers in metadata were misidentified as cryptographic algorithms, markdown code blocks and documentation tables were misidentified as shell execution, and standard dev commands were misidentified as reconnaissance. The skill only provides guidance for test quality review and does not execute code automatically.
عوامل الخطر
⚙️ الأوامر الخارجية (1)
📁 الوصول إلى نظام الملفات (1)
درجة الجودة
ماذا يمكنك بناءه
مراجعة الاختبارات المعطلة
البحث عن الاختبارات المعطلة وتقييمها لتحديد ما إذا كان يمكن إعادة تفعيلها أو يجب إزالتها.
توثيق استثناءات Neovim
مراجعة تعليقات @TestWithoutNeovim والتأكد من وجود توثيق واضح لكل استثناء.
تحسين قابلية قراءة الاختبارات
تحديد واستبدال محتوى الاختبار عديم المعنى بقطع كود واقعية.
جرّب هذه الموجهات
البحث عن جميع الاختبارات المعطلة في مشروع IdeaVim. استخدام grep للبحث عن تعليق @Disabled في ملفات الاختبارات. سرد كل فئة طريقة اختبار وطريقتها مع سبب تعطيلها.
مراجعة جميع تعليقات @TestWithoutNeovim. تحديد أي منها يفتقد إلى معامل الوصف. التحقق من صلاحية سبب الاستثناء.
البحث في ملفات الاختبار عن أنماط المحتوى عديم المعنى مثل 'asdf'، 'qwerty'، أو سلاسل عشوائية. استبدالها بقطع كود واقعية ذات صلة بكل اختبار.
تنفيذ مراجعة صيانة اختبارات كاملة: البحث عن الاختبارات المعطلة، والتحقق من توثيق استثناءات Neovim، وفحص قابلية قراءة محتوى الاختبارات، وتشغيل الاختبارات لتأكيد الحالة.
أفضل الممارسات
- توثيق سبب تعطيل كل اختبار بوضوح
- التحقق من الاختبارات المعطلة بتشغيلها قبل إعادة تفعيلها
- استبدال سلاسل الاختبار عديمة المعنى بأمثلة كود واقعية
تجنب
- ترك الاختبارات المعطلة بدون توثيق
- الافتراض أن الاختبارات المعطلة ستُصلح لاحقاً بدون تتبع
- التركيز على التوثيق فقط بدون التحقق من حالة الاختبار