عن المشروع

# PUA Skill — مهارة وكيل برمجة ذكاء اصطناعي عالي المبادرة هذا مكوّن مهارات موجّه لوكلاء البرمجة بالذكاء الاصطناعي (مثل Claude Code وOpenAI Codex CLI وغيرها)، يحاكي أساليب إدارة الأداء في شركات التقنية (مثل علي بابا، بايت دانس، هواوي، أمازون، جوجل وغيرها) — بنسخة صينية تُعرف بـ PUA وبنسخة إنجليزية تُعرف بـ PIP — لإجبار الذكاء الاصطناعي على استنفاد جميع الحلول الممكنة عند مواجهة المشكلات، بدلاً من الاستسلام بسهولة أو التنصل من المسؤولية. ## الميزات الأساسية - **أساليب PUA**: تجعل الذكاء الاصطناعي يخشى الاستسلام ويواصل المحاولة - **منهجية التصحيح**: تمنح الذكاء الاصطناعي القدرة على عدم الاستسلام وتوفّر خطوات استقصاء منهجية - **إلزام بالمبادرة**: تجعل الذكاء الاصطناعي يستقصي المشكلات بنشاط بدلاً من الانتظار السلبي للتعليمات ## المنصات المدعومة يدعم Claude Code وOpenAI Codex CLI وpi coding agent وTrae وCursor وKiro وCodeBuddy وOpenClaw وGoogle Antigravity وOpenCode وVSCode (GitHub Copilot) وغيرها. ## النسخ متعددة اللغات توفر نسخًا بالصينية (الافتراضية) والإنجليزية (نسخة PIP) واليابانية، ولكل لغة ملفات مهارات مستقلة ومتكيفة ثقافيًا. ## طرق التثبيت ### Vercel Skills CLI (عام) الأمر: npx skills add tanweai/pua --skill pua-en ### Claude Code يدعم التثبيت من السوق أو من كود المطوّر، مع الحاجة إلى تسجيل المكوّن يدويًا. ### OpenAI Codex CLI يُنصح بالتثبيت بنقرة واحدة (git clone + symlink)، ويدعم التحديث عبر git pull. ### منصات أخرى لكل منصة تعليمات تثبيت مقابلة، مثل استخدام Cursor لملفات القواعد .mdc، واستخدام VSCode Copilot لملفات التعليمات، وغيرها. ## حالات الاستخدام يناسب جميع أنواع المهام مثل التصحيح، التنفيذ، الإعداد، النشر، التشغيل، تكامل API، معالجة البيانات، وغيرها. يتم تفعيله عندما يظهر على الذكاء الاصطناعي الأنماط الكسولة التالية: - إلقاء المشكلة على المستخدم (“يرجى التحقق...”، “أقترح القيام يدويًا...”) - تعديل نفس الكود/المعلمات مرارًا دون إنتاج معلومات جديدة - تخطي التحقق والادعاء بالانتهاء مباشرة - تقديم اقتراحات فقط دون تقديم كود/أوامر - الانتظار السلبي لتعليمات المستخدم ## الاختبارات المرجعية في اختبارات تحمّل التصحيح (ستة سيناريوهات)، زاد عدد استدعاءات الأدوات بنسبة 56%-100% بعد استخدام هذه المهارة، وزاد عدد المشكلات المكتشفة بنسبة 50%. على سبيل المثال، في سيناريو مراجعة الإعدادات، تم تجاهل خطأ إعدادات Redis وخطر أمني متعلق بـ CORS wildcard عند عدم استخدام المهارة، وبعد الاستخدام تم اكتشاف هذه المشكلات عبر قائمة فحص استباقية. ## ملاحظة إعلان رسمي: لم تنجح جميع النماذج في اجتياز الاختبارات، ولم يتم إثبات تحسين الإنتاجية عبر هذا التقييم بعد.