Install
npx skills add https://github.com/currents-dev/playwright-best-practices-skillلمن يناسب
هذا الدليل لمن يكتب أو ينقّح أو يصون اختبارات Playwright بـ TypeScript ويريد أن يعطي وكيل نصائح موجّهة إلى النشاط الحالي. رسمياً هو مدفوع بالنشاط: ما تفعله يشير إلى المراجع المطابقة بدل تحميل كل المواد دفعة واحدة.
المستودع:
https://github.com/currents-dev/playwright-best-practices-skill
يناسب عندما يحتوي المستودع مسبقاً على اختبارات Playwright وتريد إصلاح حالة غير مستقرة أو إضافة فحوصات إتاحة. تقول المواد إنك لست بحاجة إلى نطق اسم المهارة أو “Playwright best practices”؛ يكفي بيان المهمة بوضوح.
لا تناسب بيئات تكتب أساساً اختبارات بلغات أخرى، أو بلا آلية تثبيت مهارات متوافقة. المواد القائمة تحصر الإرشاد في اختبارات Playwright لـ TypeScript؛ لا توسّع ذلك إلى لغات غير مكتوبة.
أول محاولة في 3 دقائق
اتبع المسار الرسمي الموصى به فقط.
الشروط المسبقة: هذا الجهاز يشغّل npx، والوكيل الحالي يقبل طريقة التثبيت هذه، وفي مساحة العمل اختبار Playwright يمكن مناقشته. قبل التثبيت أكّد أنك تكتب في بيئة الوكيل المستخدمة فعلاً.
موضع التثبيت: يعالجه npx skills add. المواد لا تسمّي مجلداً مستهدفاً؛ لا تُكمل مساراً غير ظاهر.
انسخ ونفّذ:
npx skills add https://github.com/currents-dev/playwright-best-practices-skill
إشارة النجاح: ينتهي الأمر بشكل طبيعي. ابدأ بفحص للقراءة فقط: افتح اختباراً مرتبطاً بتسجيل الدخول وقل للوكيل «انظر هذا الاختبار غير المستقر لتسجيل الدخول، اذكر الأسباب المحتملة أولاً، لا تغيّر الملفات». المثال الرسمي هو تماماً “fix this flaky login test”. إن استشهد الرد بانتظار أو استهداف أو تأكيدات محددة لا إعادة كتابة فضفاضة، فقد استُخدمت المراجع المطابقة.
بعد قبول التحليل صرّح أي ملف يجوز تغييره. تغيير الاختبارات له آثار جانبية؛ لا تدعه يرقّع قبل تأكيد النطاق.
حالات الاستخدام
الحالة الأولى: التحقيق في اختبار تسجيل دخول غير مستقر. تقابل المهمة الرسمية “fix this flaky login test”. تناسب اختباراً ينجح أحياناً ويفشل أحياناً وتريد نصيحة مركّزة أولاً. صف الظاهرة وسجل الفشل واطلب التحليل فقط. عند النجاح يقع الرد على مراجع النشاط الحالي لا يفرغ الوثائق الـ 57 دفعة واحدة. المواد لا تسمّي التصنيفات الثمانية؛ لا تخترع تصنيفات أو أسماء ملفات. قبل التغيير الحقيقي أكّد الملف والسلوك المتوقع.
الحالة الثانية: إضافة اختبارات إتاحة. تقابل المثال الرسمي “add accessibility tests”. تناسب من لديه تدفق صفحة ويريد فحوصات إتاحة. اطلب أولاً تأكيدات مقترحة من اختبار الصفحة الحالي دون كتابة ملفات بعد. بعد تأكيد المحددات والتغطية دعه يضيف حالات. إشارة النجاح: نصيحة تطابق الصفحة التي سمّيتها لا قالباً عاماً. المواد القائمة تُظهر فقط أن وصف المهمة هذا يمكن أن يشغّل المهارة؛ ولا توسّع واجهات API أو مفاتيح إعداد.
حدود الاستخدام
المواد القائمة تعطي أمر تثبيت واحد واستعمال «الإشارة إلى المراجع حسب النشاط». لا تبدّل إلى أمر سوق أو مسار استنساخ أو مثبّت آخر غير ظاهر. ولا تسمّي عملاء إلزاميين؛ لا تكتب دعماً حصرياً لبضعة وكلاء.
مكتبة المراجع 57 وثيقة في 8 أصناف؛ أسماء الأصناف ومسارات الوثائق غير مكتوبة. لا تخترع مسارات وثائق أو مجلدات فرعية للمهارة.
ترشد كتابة اختبارات Playwright وتنقيحها وصيانتها في TypeScript. خطوات لغات أخرى أو أطر اختبار أخرى لا تُستكمل من المواد القائمة. تغيير الاختبارات يغيّر المستودع؛ حلّل أولاً ثم اأذن بالكتابة. مزيد من التفصيل في المستودع الرسمي:
https://github.com/currents-dev/playwright-best-practices-skill