> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# نظرة عامة على القدرات

> كيف يعمل نظام القدرات في وولف فيش

# ما هي القدرة؟

القدرة هي مجلد مكتفٍ بذاته في `brain/cerebellum/` يمنح وولف فيش مهارة جديدة. القدرات هي الطريقة التي يتعلم بها وولف فيش كيف يقوم بأشياء — تنفيذ أوامر الشل، وقراءة الملفات، والتفاعل مع git، والبحث في الويب، وإرسال الرسائل.

## نوعان من القدرات

<CardGroup cols={2}>
  <Card title="المهارات النقية" icon="file-lines">
    ملف SKILL.md فقط. يحتوي متن Markdown على تعليمات يتبعها نموذج اللغة باستخدام قدراته الحالية. لا حاجة لأي كود. مثال: `git/` — يستخدم نموذج اللغة أوامر الشل لتنفيذ عمليات git بناءً على تعليمات SKILL.md.
  </Card>

  <Card title="قدرات الإضافات" icon="plug">
    ملف SKILL.md بالإضافة إلى مجلد `plugin/` يحتوي كودًا قابلًا للتنفيذ. تصدّر الإضافة أدوات يمكن لنموذج اللغة استدعاؤها مباشرة. مثال: `shell/` — تغلّف الإضافة `child_process` لتقديم أداة `shell_exec`.
  </Card>
</CardGroup>

## بنية مجلد القدرة

```
brain/cerebellum/my-capability/
├── SKILL.md              # مطلوب: واجهة YAML + تعليمات
└── plugin/               # اختياري: كود قابل للتنفيذ
    └── index.mjs         # نقطة دخول الإضافة
```

## كيف تُحمَّل القدرات

عند بدء التشغيل، يمسح `cerebellum.ts` مجلد `brain/cerebellum/` ولكل مجلد:

1. يقرأ واجهة YAML لـ SKILL.md ويحلّلها
2. يستخرج تعريفات الأدوات وأنماط الخطر وأنماط التأكيد والمشغّلات
3. إذا كان مجلد `plugin/` موجودًا، يستورد `plugin/index.mjs` ديناميكيًا
4. يستدعي `init(context)` على الإضافة، ممررًا `pluginDir` و`workspaceRoot`
5. يسجل كل الأدوات في تعريفات أدوات الوكيل

## كيف تُختار القدرات

**قدرات الإضافات** (مع أدوات) تُضمَّن دائمًا في قسم `<tools>` — يحتاج نموذج اللغة لمعرفة الأدوات المتاحة بغض النظر عن موضوع الرسالة.

**المهارات النقية** (بدون أدوات) تُحقن في قسم `<skills>` فقط عندما تتطابق رسالة المستخدم مع كلماتها المفتاحية. يُقيّم cerebellum كل مهارة بحسب عدد الكلمات المفتاحية الموجودة في الرسالة ويحقن أعلى 3 مطابقات.

المشغّل `"*"` (الرمز الشامل) يجعل المهارة النقية **دائمة التفعيل** — تُحقن في كل رسالة بدون مطابقة كلمات مفتاحية ولا تُحتسب ضمن حدّ الـ 3. استخدم هذا للمهارات التي تُحدد سلوكًا عامًا للوكيل مثل انضباط التخطيط أو تنسيق المخرجات.

## القدرات المضمَّنة

يأتي وولف فيش بهذه القدرات في مساحة العمل الافتراضية:

| القدرة       | النوع      | الوصف                                                |
| ------------ | ---------- | ---------------------------------------------------- |
| `shell`      | إضافة      | تنفيذ أوامر الشل عبر `shell_exec`                    |
| `filesystem` | إضافة      | قراءة الملفات وكتابتها وتعديلها                      |
| `git`        | مهارة نقية | عمليات git عبر أوامر الشل                            |
| `introspect` | إضافة      | الوعي الذاتي: الحالة واتصال القنوات والأداء والذاكرة |
| `ask`        | إضافة      | يسألك سؤال اختيار من متعدد وينتظر اختيارك            |
| `skills`     | إضافة      | إدارة قدرات وولف فيش وتأليفها أثناء التشغيل          |

## إضافة القدرات وإزالتها

يمكنك إضافة قدراتك الخاصة بطريقتين:

* **أفلتها على الإعدادات ← المُخيخ** — ملف `SKILL.md` واحد، أو مجلد، أو ملف `.zip`. يُتحقَّق من كل عنصر قبل كتابة أي شيء، ثم يُحمَّل في الحال. تظهر القدرات المستوردة بوسم **غير معروف** (فهي قدراتك لا قدرات مدمجة)، ويمكن إزالتها بأيقونة سلة المهملات التي تحذف مجلدها نظيفًا.
* **أنشئ المجلد يدويًا** تحت `brain/cerebellum/`، ثم انقر **إعادة المزامنة** في اللوحة (أو أعد تشغيل وولف فيش) لتحميله.

انظر [إنشاء القدرات](/ar/capabilities/creating-capabilities) للشرح الكامل، والأشكال الثلاثة للاستيراد، والقواعد التي يجب أن تستوفيها القدرة القابلة للاستيراد.

<Card title="أنشئ قدرتك الخاصة" icon="plus" href="/ar/capabilities/creating-capabilities">
  تعلّم كيف تبني قدرة جديدة من الصفر.
</Card>