تثبيت Playwright CLI عامًا ثم إضافة SKILLS لوكيل البرمجة

لمن هذا الدليل

هذا الدليل للمطوّرين الذين يحتاجون Playwright CLI ويريدون تثبيت SKILLS المرافقة لوكيل برمجة. رسميًا هو مكتوب كـ Playwright CLI with SKILLS.

قبل البدء، أكّد أن هذا الجهاز Node.js 18 or newer. الصفحة تذكر أيضًا Claude Code وGitHub Copilot أو any other coding agent؛ هذه ملاحظة تشغيل وليست قائمة حصرية، ولا تعمم التثبيت العام عبر npm إلى إضافة سوق غير ظاهرة.

الـ CLI افتراضيًا headless. أضف --headed إلى open فقط عندما تريد رؤية المتصفح صراحة. في المحاولة الأولى لا تفتح ولا تسجّل عنوانًا غير مؤكد.

إكمال أول محاولة في 3 دقائق

استخدم فقط أمر التثبيت الموصى به الوارد في الصفحة:

npm install -g @playwright/cli@latest

الشرط المسبق: Node.js 18 أو أحدث، ووجود coding agent قابل للاستخدام في البيئة الحالية. موضع التثبيت هو حزمة npm العامة @playwright/cli؛ لا تعِد كتابة ذلك كمثبّت آخر غير ظاهر.

نقطة تأكيد الأثر الجانبي: هذا الأمر يكتب الـ CLI في البيئة العامة. إذا لم تكن تنوي تغيير الحزم العامة لهذا الجهاز، فتوقف أولًا. أكّد ثم نفّذ. بعد نجاح التثبيت، إن احتجت بعدُ ملفات مهارات محلية، فشغّل playwright-cli install --skills الوارد في الصفحة؛ هذا وضع مهارات بعد التثبيت وليس مثبّتًا أساسيًا ثانيًا. يكتب ملفات المهارات، لذا أكّد أيضًا دليل المشروع/الـ Agent الحالي قبل التشغيل.

إشارة النجاح: الأمر العام متاح، و(إن شغّلته) انتهى --skills بشكل طبيعي. بعد ذلك تحقق فقط: في الـ Agent أكّد أنه يتعرّف على مهارات Playwright CLI، أو في الطرفية أن الـ CLI مثبت. لا تتعجل open لموقع أو تسجيل سكربت أو التقاط صورة. إذا كنت ستستخدم open، فتذكّر أولًا أن الافتراضي بلا واجهة؛ أضف --headed فقط عندما تريد رؤية المتصفح، وأكّد عنوان الهدف أولًا.

حالات الاستخدام

الحالة 1: تثبيت الـ CLI الرسمي عامًا. بعد تأكيد Node.js 18+ نفّذ npm install -g @playwright/cli@latest. الدليل يغطي أمر التثبيت هذا و«Playwright CLI with SKILLS». معيار الإنجاز يتوقف عند نجاح تثبيت الحزمة العامة. لا تضف خطوات إلغاء تثبيت أو سجل مرآة غير ظاهرة.

الحالة 2: تثبيت المهارات محليًا وفهم افتراض بلا واجهة. بعد تثبيت الـ CLI نفّذ playwright-cli install --skills. الدليل ينص على أن المهارات المحلية تُثبَّت بهذا الأمر؛ وينص أيضًا على أن الـ CLI افتراضيًا headless، وأن رؤية المتصفح تتم بتمرير --headed إلى open. إشارة نجاح المحاولة الأولى هي اكتمال --skills ورؤية الـ Agent للمهارات. المقتطف لا يعطي URL لـ open، لذا لا تخترع URL ولا تعامل --headed كسلوك افتراضي.

حدود الاستخدام

مسار التثبيت الأساسي هو فقط npm install -g @playwright/cli@latest. playwright-cli install --skills هو وضع مهارات وليس تثبيت سوق موازيًا. يلزم Node.js 18+. الـ Agents المذكورة ليست النطاق الحصري المدعوم. الافتراضي بلا واجهة؛ إضافة --headed إلى open تُظهر متصفحًا. أهداف التسجيل والمحددات ومسارات اللقطات غير المكتوبة لا تُتخذ خلاصة أمان.