المهارات (Skills)

Verdent المهارات (Skills) هي حزم معرفية قابلة لإعادة الاستخدام توسّع خبرة الوكيل. تحتوي كل مهارة على prompts مخصصة للمجال، وسكربتات، ومراجع، وأفضل الممارسات. ما عليك سوى استدعاء المهارة باسمها، ليقوم الوكيل بتحميل السياق المقابل واتباع سير العمل المحدد مسبقًا.

ما هي المهارات؟

المفهوم الأساسي

المهارة هي حزمة معرفية منظمة محفوظة في مجلد. تحتوي كل مهارة على ملف SKILL.md يحدد اسمها ووصفها والـ prompt التفصيلي الخاص بها. عندما تستدعي مهارة في المحادثة، يقرأ Verdent هذا الملف ويحقن محتواه في سياق الوكيل.

كيف تختلف المهارات عن الوكلاء الفرعيين وعن MCP

باختصار: المهارات توفر المعرفة والتوجيه لسير العمل، والوكلاء الفرعيون ينفذون مهامًا مستقلة، وMCP يربط الأدوات ومصادر البيانات الخارجية.

كيفية استخدام المهارات

استدعاء مهارة

يمكنك استدعاء مهارة بطريقتين:

1. الإشارة إلى اسم المهارة في المحادثة

Use the skill-creator skill to help me create a new Skill

2. استخدام صيغة الإشارة بـ @

@skill-creator help me create a Skill for API documentation generation

عندما يتم تشغيل مهارة:

1. يستدعي الوكيل أداة skill لقراءة ملف SKILL.md الخاص بالمهارة
2. يُحقن محتوى الملف في سياق المحادثة الحالية
3. يستمر الوكيل في العمل وفقًا لتوجيه المهارة

استعراض المهارات المتاحة

يمكنك الوصول إلى لوحة المهارات من خلال الإعدادات:

1. افتح قائمة الإعدادات
2. حدد تبويب المهارات
3. استعرض المهارات المثبَّتة والمهارات المتاحة في متجر المهارات

يمكنك أيضًا كتابة @ في مربع الإدخال لتشغيل الإكمال التلقائي واختيار مهارة متاحة بسرعة.

المهارات المدمجة

يأتي Verdent مع مجموعة من المهارات المدمجة التي تغطي سير العمل الشائع:

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

يمكنك إنشاء مهارات مخصصة لتضمين خبرة فريقك في مجال معين أو سير عمل خاص بمشروعك.

بنية دليل المهارة

يبدو مجلد المهارة القياسي كما يلي:

my-custom-skill/
├── SKILL.md              # Required: Skill definition file
├── agents/
│   └── verdent.yaml      # Optional: UI configuration (icons, display name)
├── scripts/              # Optional: helper scripts
└── references/           # Optional: reference docs or examples

تنسيق SKILL.md

SKILL.md هو ملف المهارة الأساسي، ويحتوي على YAML frontmatter وجسم Markdown:

---
name: my-custom-skill
description: A concise description shown in the Skill list
metadata:
  version: "1.0.0"
  author: "Your Name"
  license: "MIT"
---

# Detailed Instructions

This is the detailed prompt content the Agent reads.

## Workflow

1. Step one
2. Step two
3. ...

## Best Practices

- Practice suggestion 1
- Practice suggestion 2

متطلبات حقول Frontmatter:

• name (مطلوب): يجب أن يتطابق مع اسم المجلد. يُسمح فقط بالحروف الصغيرة والأرقام والشرطات (a-z0-9-). الطول: من 1 إلى 64 حرفًا. بلا شرطات متتالية أو شرطات في البداية/النهاية.
• description (مطلوب): وصف مختصر، بحد أقصى 1024 حرفًا.
• metadata (اختياري): الإصدار، المؤلف، الترخيص، ومعلومات وصفية أخرى.

تثبيت المهارات المخصصة

الطريقة 1: الاستيراد عبر الإعدادات

1. افتح الإعدادات ← المهارات
2. حدد استيراد مهارة
3. اختر مجلد المهارة (أو أرشيف .zip / .skill)
4. يتحقق Verdent من صحة SKILL.md ويثبّته في ~/.verdent/skills/

الطريقة 2: النسخ اليدوي

cp -r my-custom-skill ~/.verdent/skills/

تصبح المهارة متاحة بعد إعادة تشغيل Verdent أو تحديث قائمة المهارات.

الطريقة 3: مهارة على مستوى المشروع

ضع المهارة داخل دليل مشروعك:

cp -r my-custom-skill /path/to/your/project/.verdent/skills/

تكون المهارات على مستوى المشروع مرئية فقط داخل ذلك المشروع، وتأخذ الأولوية على المهارات العامة التي تحمل الاسم نفسه.

نطاقات المهارات

يدعم Verdent ثلاثة مستويات لتحديد نطاق المهارات:

قواعد الأولوية:

عند وجود مهارات بالاسم نفسه في نطاقات متعددة:

• المشروع يتفوق على العام

متجر المهارات

يوفر Verdent متجر مهارات لاستعراض وتثبيت المهارات المجتمعية والرسمية.

استعراض متجر المهارات

1. افتح الإعدادات ← المهارات
2. انتقل إلى تبويب المتجر
3. استعرض المهارات المتاحة أو استخدم مربع البحث

التثبيت من المتجر

1. اعثر على المهارة المطلوبة في المتجر
2. حدد تثبيت
3. يتم تنزيل المهارة تلقائيًا وتثبيتها في ~/.verdent/skills/

التحقق الأمني:

تخضع المهارات المثبَّتة من المتجر لتحقق باستخدام دالة التجزئة SHA256 لضمان سلامة الملفات وأمانها.

أمثلة عملية

مثال 1: إنشاء مهارة جديدة باستخدام skill-creator

@skill-creator help me create a Skill for guiding the team on writing Go unit tests

سيقوم الوكيل بما يلي:

1. قراءة محتوى مهارة skill-creator
2. توجيهك خلال تعبئة اسم المهارة ووصفها والـ prompt الأساسي
3. توليد ملف SKILL.md قياسي
4. اقتراح مسار التثبيت وخطوات التحقق

مثال 2: تحليل البيانات باستخدام spreadsheet

@spreadsheet read sales-2025.xlsx from the project root, analyze Q1 sales trends, and generate a chart

سيقوم الوكيل بما يلي:

1. تحميل مهارة spreadsheet
2. استخدام pandas و openpyxl لقراءة ملف Excel
3. تحليل البيانات وتوليد تصورات مرئية
4. حفظ النتائج أو عرضها في المحادثة

مثال 3: إصلاح CI باستخدام gh-fix-ci

@gh-fix-ci my PR #123 GitHub Actions tests are failing, help me debug

سيقوم الوكيل بما يلي:

1. استخدام واجهة سطر الأوامر gh لاسترجاع سجلات CI لطلب السحب رقم 123
2. تحليل سبب الفشل (مثل أخطاء حالات الاختبار، مشكلات التبعيات)
3. اقتراح إصلاح
4. بعد موافقتك، تعديل الكود ودفع الإصلاح

الأسئلة الشائعة

استخدام متقدم

تضمين سكربتات في المهارات

أضف دليل scripts/ إلى مهارتك وأشِر إلى السكربتات في SKILL.md:

## Data Processing Script

Run the following command to process data:

\`\`\`bash
python scripts/process_data.py --input data.csv --output results.json
\`\`\`

يقرأ الوكيل هذا التوجيه وينفذ السكربت عند الحاجة.

الإشارة إلى الوثائق

خزّن وثائق API أو المواصفات أو نماذج الكود في دليل references/ واربطها في SKILL.md:

## Reference Documentation

See [references/api-spec.md](references/api-spec.md) for the detailed API specification.

يمكن للوكيل قراءة هذه ملفات المراجع بناءً على توجيهات المهارة.

أفضل الممارسات

راجع أيضًا