المهارات

🎯 كيف تعمل المهارات

عندما تطلب من الوكيل تنفيذ مهمة، يحلل طلبك ويحدد المهارات المطلوبة. ثم يحمّل الوكيل بيان المهارة، يفحص الأذونات، وينفذ الأدوات المطلوبة. كل استدعاء أداة يمر عبر بوابة الأذونات — إذا احتاجت المهارة وصولاً للملفات أو أوامر shell، سيُطلب منك الموافقة (ما لم يكن ملف التعريف مضبوطاً على السماح التلقائي).

المهارات معزولة (sandboxed) — يمكنها الوصول فقط لما يعلنه بيانها. مهارة المستندات لا يمكنها تنفيذ أوامر shell ما لم يُمنح ذلك صراحة. هذا يضمن الأمان حتى مع مهارات الطرف الثالث من السوق.

🔧 استخدام المهارات

تُستخدم المهارات تلقائياً عند تفاعلك مع الوكيل. على سبيل المثال:

• "أنشئ تقرير PDF" ← يستخدم الوكيل مهارة aura-pdf
• "حلّل هذا الجدول" ← يستخدم الوكيل مهارة aura-spreadsheets
• "تصفح هذا الموقع واستخرج البيانات" ← يستخدم الوكيل مهارة aura-browser-assistant
• "حوّل هذه الصورة إلى WebP" ← يستخدم الوكيل مهارة aura-file-converter

يمكنك أيضاً طلب مهارة باسمها صراحة: "استخدم مهارة البحث للعثور على معلومات حول..."

📋 صيغة بيان المهارة

تُعرَّف كل مهارة في ملف JSON بهذا الهيكل:

{
  "id": "aura-documents",
  "name": "Documents",
  "version": "1.0.0",
  "summary": "إنشاء وتحرير وتنسيق المستندات",
  "description": "معالجة مستندات كاملة تشمل...",
  "publisher": "aura-work",
  "categories": ["documents", "productivity"],
  "risk": "low",
  "permissions": [
    { "category": "file", "action": "write", "target": "*.md" }
  ],
  "tools": [
    {
      "name": "create_document",
      "description": "إنشاء مستند جديد",
      "parameters": {
        "title": { "type": "string", "required": true },
        "format": { "type": "string", "enum": ["md", "txt", "docx"] }
      }
    }
  ],
  "install": {
    "command": "npm install",
    "workingDir": "skills/documents"
  }
}

🏗️ إنشاء مهارات مخصصة

يمكنك إنشاء مهاراتك الخاصة باتباع هذه الخطوات:

1. 1. أنشئ ملف JSON جديد في registry/skills/
2. 2. عرّف هوية المهارة (معرّف، اسم، إصدار، ناشر)
3. 3. أضف الفئات وحدد مستوى المخاطرة
4. 4. صرّح بالأذونات المطلوبة (ملفات، shell، متصفح، إلخ)
5. 5. عرّف الأدوات مع معاملاتها وأوصافها
6. 6. أضف تعليمات التثبيت إذا لزم
7. 7. تحقق باستخدام node scripts/validate-marketplace-manifests.js
8. 8. أرسل طلب سحب (PR) إلى السجل

راجع registry/skills/aura-documents.json كمثال كامل.

📊 شرح مستويات المخاطرة

كل مهارة لها مستوى مخاطرة حسب الأذونات المطلوبة:

المهارات عالية المخاطرة تتطلب موافقة صريحة في وضع ask-first. يمكنك ضبط الموافقة التلقائية لفئات معينة من الإعدادات ← الأذونات.

🏪 السوق (Marketplace)

يجمّع السوق (registry/marketplace.json) المهارات وخوادم MCP والإضافات. كل إدخال يشمل:

• أوصاف مترجمة — متوفرة بـ 20 لغة
• أيقونات وصور غلاف — أصول SVG في registry/assets/
• سجل الإصدارات — للتحديثات والتراجع
• توثيق الناشر — مهارات رسمية مقابل مهارات مجتمعية
• معلومات التوافق — الحد الأدنى لإصدار Aura Work المطلوب

ثبّت المهارات من لوحة الإضافات في تطبيق سطح المكتب أو استخدم CLI: aura skill install <skill-id>

web-search

يبحث في الويب ويستخرج معلومات حديثة مع روابط المصادر. يدعم محركات بحث متعددة.