نشر المهارات وتسجيلها

نشر المهارات وتسجيلها

شارك المهارات بتسجيلها محليًا، وبشكل اختياري بإرسالها إلى واجهة مركز عن بُعد.

:::warning لا يوجد أمر publish لا يوجد أمر kazma hub publish. استخدم register للتثبيت المحلي من مسار، و**submit** فقط عندما تكون واجهة المركز مهيأة ويمكن الوصول إليها. :::

المتطلبات المسبقة

• مجلد يحتوي skill_manifest.yaml صالحًا
• اختياري: tools.py (شكل الأدوات الأصلية) أو وحدة نقطة دخول
• KAZMA_SECRET إذا كنت ستوقّع المهارة

التدفق الموصى به (محلي)

1. التحقق

kazma hub validate ./my-skill
# optional JSON:
kazma hub validate ./my-skill --json

2. التوقيع (سلامة الملف)

kazma hub sign ./my-skill
# or: kazma hub sign ./my-skill --secret "$KAZMA_SECRET"

يكتب البصمة (checksum) + HMAC في البيان (طالع المهارات وMCP والأدوات).

3. التسجيل محليًا

kazma hub register ./my-skill

4. التأكد

kazma hub search "my-skill"
kazma hub list
kazma hub info <skill-id>

اختياري: إرسال الاعتماد عن بُعد

إذا كنت تشغّل واجهة مركز (hub_url / الافتراضي في واجهة السطر):

kazma hub submit ./my-skill --source-url https://github.com/you/my-skill
kazma hub status <submission_id>

لا يوجد علم --level على submit. الجاهزية المحلية:

kazma hub check-certification ./my-skill

إدارة الإصدارات

استخدم الإصدارات الدلالية (semantic versioning) في البيان:

• Patch (1.0.1): إصلاحات الأخطاء
• Minor (1.1.0): ميزات متوافقة مع الإصدارات السابقة
• Major (2.0.0): تغييرات كاسرة

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

1. أبقِ الأدوات صغيرة وواعية بـ HITL (يجب أن تطابق الأدوات الخطرة القدرات الفعلية).
2. فضّل خريطة tools: الأصلية التي تستخدمها المهارات المدمجة تحت kazma-skills/.
3. وثّق متغيرات البيئة والأذونات في README المهارة.
4. شغّل validate + check-certification قبل المشاركة.