عن المشروع

Waza هو مجموعة من ثماني مهارات للعادات الهندسية مخصصة لوكلاء البرمجة بالذكاء الاصطناعي. الفرضية هي أن المهندسين الجيدين يفعلون أكثر من كتابة الكود: فهم يختبرون المتطلبات تحت الضغط، ويصححون الأخطاء حتى السبب الجذري، ويراجعون تغييراتهم بأنفسهم، ويقرؤون المصادر الأولية. يحزم Waza تلك العادات كمهارات يمكن للوكيل تشغيلها، لكل منها وظيفة واحدة ومحفز واضح. ## المهارات الثماني - /think — تُستخدم قبل بناء أي شيء جديد. تتحدى المشكلة، وتختبر التصميم تحت الضغط، وتنتج خطة مكتملة القرار يمكن لوكيل آخر تنفيذها. - /ui — تُستخدم عند بناء واجهات أمامية. تهدف إلى واجهة مستخدم مميزة باتجاه ملتزم، بما في ذلك تكرار جمالي مدفوع بلقطات الشاشة. - /check — تُستخدم بعد المهمة وقبل الدمج أو الإصدار. تراجع التغييرات مقابل قيود المشروع، وتتحقق من النتيجة، وتتولى إجراءات الإصدار والصيانة المعتمدة. - /hunt — تُستخدم لأي خطأ أو تراجع أو سلوك غير متوقع. تصحيح أخطاء منهجي يؤكد السبب الجذري قبل تطبيق الإصلاح. - /write — تُستخدم عند كتابة أو تحرير النثر. تعيد كتابة النثر ليبدو طبيعيًا بالصينية والإنجليزية وتزيل الصياغة الجامدة والنمطية. - /learn — تُستخدم عند الغوص في مجال غير مألوف. سير عمل بحثي من ست مراحل: الجمع، والهضم، والتخطيط، والملء، والتنقيح، ثم المراجعة الذاتية والنشر. - /read — تُستخدم لأي رابط أو ملف PDF. تعيد ملخصًا موجزًا أو Markdown نظيفًا للتحويل أو الاقتباس أو الاستشهاد أو الحفظ أو البحث الإضافي. - /health — تدقق صحة الوكيل: Codex وClaude Code وتعليمات المشروع ومخرجات المدقق وقابلية الصيانة بالذكاء الاصطناعي، مع تمريرة تلخيص واعية بالميزانية قبل الفحص العميق. كل مهارة هي مجلد يحتوي على مستندات مرجعية وسكربتات مساعدة وملاحظات حول المزالق المستخلصة من إخفاقات حقيقية. ## التثبيت بالنسبة لـ Claude Code وCodex وCursor ووكلاء آخرين، يقوم أمر npx واحد بتثبيت المهارات في الدليل المشترك `~/.agents/skills`، مع ربط رمزي لـ Claude Code. الوكلاء الذين يقرؤون ذلك الدليل يلتقطون المهارات كأوامر slash؛ أما الوكلاء الذين لديهم دليل مهارات خاص فيُحددون بعد علامة `-a`. تستخدم التحديثات `npx skills update -g -y`. الإضافات المضيفة مدعومة أيضًا لـ Claude Code وCodex، حيث تكون المهارات ضمن نطاق أسماء (على سبيل المثال `/waza:check`). يمكن لمستخدمي Claude Desktop تنزيل ZIP من الإصدارات ورفعه تحت Customize > Skills. تتوفر حزمة Pi أيضًا. ## التسلسل والسياق يقرر المستخدمون كيفية تسلسل المهارات. تشمل سير العمل الموثقة تخطيط ميزة (/think ثم /check)، وشحن إصلاح (/hunt، إصلاح، /check)، والبحث والكتابة (/read، /learn، /write)، وتصحيح الأخطاء والتحقق (/hunt ثم /check). يشحن Waza عادات عامة فقط. تصبح مهارة /check واعية بالمشروع في وقت التشغيل من خلال قراءة السياق العام للمستودع المستهدف مثل ملفات README وبيانات الحزم وMakefiles وسير عمل CI، بالإضافة إلى قيود المهمة — وليس المسارات الخاصة أو بيانات الاعتماد أو الرموز. ## إضافات شريط حالة بسيط لـ Claude Code يعرض نافذة السياق وحصة الخمس ساعات وحصة السبعة أيام، مرمزًا بالألوان حسب الاستخدام دون أشرطة تقدم. لدى Codex عناصر شريط حالة أصلية مكونة في `~/.codex/config.toml`. يمكن تثبيت ثلاثة مفاتيح قواعد اختيارية: تدريب إنجليزي يضيف تصحيحًا قصيرًا عندما يحتوي الموجه على خطأ إنجليزي، وحواجز حماية مضادة للأنماط تعمل دائمًا، وتلميح توجيه يخبر المضيفين غير Claude بتفضيل مهارات Waza عندما يطابق الطلب محفزاتها. ## الخلفية Waza (技) هو مصطلح فنون قتالية ياباني يعني التقنية. يضع المشروع نفسه على أنه صغير عمدًا مقارنة بمجموعات المهارات الأثقل، ويقول إن المهارات بُنيت من مشاريع حقيقية وصُقلت عبر أكثر من 300 جلسة على 7 مشاريع. يوصف بأنه جزء من ثلاثية إلى جانب Kaku (الكود) وKami (المستندات). مرخص تحت MIT.