حزمة المهارات

المهارات تعليمات وسكربتات صغيرة يتبعها وكيل البرمجة. تجمع حسنات خمس مهارات في حزمة واحدة، معها بيان يحمل مجموع SHA-256 لكل ملف، وأداة تتحقّق منها قبل التثبيت.

المهارة	متى يستخدمها الوكيل
hasanat-builder	المسار الأساسي: من فكرة أو مواصفات إلى صفحة تعمل على جهازك، ثم طلب الخدمات والإطلاق
hasanat-auth	تسجيل الدخول المشترك عبر auth.hasanat.dev
hasanat-d1	قاعدة بيانات Cloudflare D1
hasanat-design	ألوان حسنات وخطوطها، والاتجاه من اليمين إلى اليسار، وإمكانية الوصول
hasanat-deploy	النشر على Cloudflare وطلب النطاق الفرعي

الحزمة الحالية

الإصدار	2026.10.13.1
المهارات	hasanat-auth, hasanat-builder, hasanat-d1, hasanat-deploy, hasanat-design
الملفات المتحقَّق منها	7
SHA-256	4c730633cd80c2f4ead93a7083af26071ca36a525746a00a7fadd61021f08362
الحجم	35.7 KB

• hasanat-skills.skill: الحزمة الكاملة بالمهارات الخمس.
• hasanat-skills.manifest.json: البيان: الإصدار، والمصادر، ومجموع SHA-256 لكل ملف.
• verify-hasanat-skills.mjs: أداة التحقق (تحتاج Node.js والأمر unzip).
• hasanat-skills.skill.sha256: مجموع الحزمة وحده.
• hasanat-builder.skill: مهارة hasanat-builder وحدها.
• hasanat-builder-SKILL.md: تعليمات hasanat-builder لتقرأها قبل التثبيت.

التنزيل والتحقق والتثبيت

تحتاج Node.js والأمر unzip.

1. نزّل الحزمة والبيان وأداة التحقق إلى مجلد مؤقت خارج مشروعك:

   mkdir -p ~/Downloads/hasanat-skills && cd ~/Downloads/hasanat-skills
   curl -fsSLO https://platform.hasanat.dev/skills/hasanat-skills.skill
   curl -fsSLO https://platform.hasanat.dev/skills/hasanat-skills.manifest.json
   curl -fsSLO https://platform.hasanat.dev/skills/verify-hasanat-skills.mjs

2. تحقّق من الحزمة. لا تثبّتها إن فشل التحقق:

   node verify-hasanat-skills.mjs hasanat-skills.skill hasanat-skills.manifest.json

   تقارن الأداة مجموع الحزمة وحجمها وقائمة ملفاتها ومجموع كل ملف بما في البيان.

3. اعرض محتوى الحزمة، وتأكّد أن فيها مجلدًا لكل مهارة من الخمس:

   unzip -l hasanat-skills.skill

4. فكّ الحزمة داخل مشروعك:

   mkdir -p .agents/skills
   unzip -n ~/Downloads/hasanat-skills/hasanat-skills.skill -d .agents/skills

   الخيار -n لا يستبدل أي ملف موجود. إن كان وكيلك يقرأ المهارات من مجلد آخر، فكّها هناك بحسب توثيقه.

رسالة البداية تطلب من الوكيل هذه الخطوات نفسها، وتسألك قبل التثبيت.

المهارات في القالب

في قالب حسنات أربع من هذه المهارات في .github/skills/، لكنها أقدم من الحزمة. نسخة hasanat-auth في القالب تصف تدفق OAuth للتطبيقات الخارجية غير موجود، ونسخة hasanat-deploy تطلب سرًّا لا تحتاجه. اعتمد نسخ الحزمة.

ما الذي تغيّر في هذا الإصدار

• hasanat-builder يتبع مسار حسنات الحالي: الأفكار والمواصفات والقادة و«أستطيع المساعدة»، وطلب الخدمات من لوحة المنصة.
• hasanat-auth يصف تسجيل الدخول كما يعمل فعلًا: لا تدفق OAuth للتطبيقات الخارجية، ولا سرّ في التطبيق، ولا تسجيل دخول على localhost.
• hasanat-deploy يطلب النطاق الفرعي من اللوحة، ولا يطلب AUTH_SECRET.
• hasanat-d1 وhasanat-design: تصحيحات صغيرة، وألوان حسنات وخطّها.
• أصبح لكل مهارة اسم ووصف في رأس ملفها، لتتعرّف عليها أدوات وكلاء البرمجة.