منصة المهارات

المهارات هي آلية التوسيع الأساسية في Triggerfish. المهارة هي مجلد يحتوي على ملف SKILL.md -- تعليمات وبيانات وصفية تمنح الوكيل قدرات جديدة بدون الحاجة لكتابة إضافة أو بناء كود مخصص.

المهارات هي كيف يتعلم الوكيل فعل أشياء جديدة: التحقق من تقويمك، إعداد ملخصات صباحية، فرز مشكلات GitHub، صياغة ملخصات أسبوعية. يمكن تثبيتها من سوق، أو كتابتها يدوياً، أو تأليفها من قبل الوكيل نفسه.

ما هي المهارة؟

المهارة هي مجلد يحتوي على ملف SKILL.md في جذره. يحتوي الملف على بيانات وصفية YAML (frontmatter) ومتن markdown (تعليمات للوكيل). ملفات داعمة اختيارية -- سكربتات، قوالب، تكوين -- يمكن أن تعيش بجانبه.

morning-briefing/
  SKILL.md
  briefing.ts        # كود داعم اختياري
  template.md        # قالب اختياري

بيانات SKILL.md الوصفية تعلن ما تفعله المهارة، وما تحتاجه، وما قيود الأمان التي تنطبق:

---
name: morning-briefing
description: Prepare a daily morning briefing with calendar, email, and weather
version: 1.0.0
category: productivity
tags:
  - calendar
  - email
  - daily
triggers:
  - cron: "0 7 * * *"
metadata:
  triggerfish:
    classification_ceiling: INTERNAL
    requires_tools:
      - browser
      - exec
    network_domains:
      - api.openweathermap.org
      - www.googleapis.com
---

## التعليمات

عند التشغيل (يومياً الساعة 7 صباحاً) أو عند استدعاء المستخدم:

1. جلب أحداث التقويم اليوم من Google Calendar
2. تلخيص الرسائل غير المقروءة من آخر 12 ساعة
3. الحصول على توقعات الطقس لموقع المستخدم
4. تجميع ملخص موجز وتسليمه إلى القناة المُعدّة

تنسيق الملخص مع أقسام للتقويم والبريد الإلكتروني والطقس.
اجعله قابلاً للمسح -- نقاط بدلاً من فقرات.

حقول البيانات الوصفية

الحقل	مطلوب	الوصف
name	نعم	معرّف المهارة الفريد
description	نعم	وصف مقروء لما تفعله المهارة
version	نعم	إصدار دلالي
category	لا	فئة التجميع (إنتاجية، تطوير، تواصل، إلخ)
tags	لا	علامات قابلة للبحث للاكتشاف
triggers	لا	قواعد الاستدعاء التلقائي (جداول cron، أنماط أحداث)
metadata.triggerfish.classification_ceiling	لا	أقصى مستوى تلوث يمكن أن تصله المهارة (الافتراضي: PUBLIC)
metadata.triggerfish.requires_tools	لا	الأدوات التي تعتمد عليها المهارة (browser، exec، إلخ)
metadata.triggerfish.network_domains	لا	نقاط نهاية الشبكة المسموح بها للمهارة

أنواع المهارات

يدعم Triggerfish ثلاثة أنواع من المهارات، مع ترتيب أولوية واضح عند تعارض الأسماء.

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

تُشحن مع Triggerfish في مجلد skills/bundled/. تُصان من قبل المشروع. متاحة دائماً.

يتضمن Triggerfish عشر مهارات مدمجة تجعل الوكيل مكتفياً ذاتياً من اليوم الأول:

المهارة	الوصف
tdd	منهجية التطوير بالاختبار لـ Deno 2.x. دورة أحمر-أخضر-إعادة هيكلة، أنماط Deno.test()، استخدام @std/assert، اختبار نوع Result، مساعدي الاختبار.
mastering-typescript	أنماط TypeScript لـ Deno وTriggerfish. الوضع الصارم، Result<T, E>، الأنواع المميزة، دوال المصنع، الواجهات غير القابلة للتغيير، حاويات mod.ts.
mastering-python	أنماط Python لإضافات Pyodide WASM. بدائل المكتبة القياسية للحزم الأصلية، استخدام SDK، الأنماط غير المتزامنة، قواعد التصنيف.
skill-builder	كيفية تأليف مهارات جديدة. تنسيق SKILL.md، حقول البيانات الوصفية، سقوف التصنيف، سير عمل التأليف الذاتي، المسح الأمني.
integration-builder	كيفية بناء تكاملات Triggerfish. جميع الأنماط الستة: محوّلات القنوات، مزوّدي LLM، خوادم MCP، مزوّدي التخزين، أدوات التنفيذ، والإضافات.
git-branch-management	سير عمل فروع Git للتطوير. فروع الميزات، الإيداعات الذرية، إنشاء PR عبر gh CLI، تتبع PR، حلقة ملاحظات المراجعة عبر webhooks، الدمج والتنظيف.
deep-research	منهجية بحث متعدد الخطوات. تقييم المصادر، عمليات بحث متوازية، توليف، وتنسيق الاقتباسات.
pdf	معالجة مستندات PDF. استخراج النص، التلخيص، واستخراج البيانات المنظمة من ملفات PDF.
triggerfish	معرفة ذاتية عن بنية Triggerfish الداخلية. البنية، التكوين، استكشاف الأخطاء، وأنماط التطوير.
triggers	تأليف السلوك الاستباقي. كتابة ملفات TRIGGER.md فعّالة، أنماط المراقبة، وقواعد التصعيد.

هذه هي مهارات التمهيد -- يستخدمها الوكيل لتوسيع نفسه. skill-builder يعلّم الوكيل كيفية إنشاء مهارات جديدة، و integration-builder يعلّمه كيفية بناء محوّلات ومزوّدين جدد.

انظر بناء المهارات لدليل عملي لإنشاء مهاراتك الخاصة.

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

تُثبّت من The Reef (سوق المهارات المجتمعي). تُحمّل وتُخزّن في ~/.triggerfish/skills/.

triggerfish skill install google-cal
triggerfish skill install github-triage

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

تُنشأ من قبل المستخدم أو يؤلفها الوكيل في بيئة التنفيذ. تُخزّن في مساحة عمل الوكيل في ~/.triggerfish/workspace/<agent-id>/skills/.

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

الأولوية:  مساحة العمل  >  المُدارة  >  المدمجة

ترتيب الأولوية هذا يعني أنه يمكنك دائماً تجاوز مهارة مدمجة أو

من السوق بنسختك الخاصة. تخصيصاتك لا تُستبدل أبداً بالتحديثات. :::

اكتشاف وتحميل المهارات

عندما يبدأ الوكيل أو عندما تتغير المهارات، يشغّل Triggerfish عملية اكتشاف المهارات:

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

المهارات التي تحتوي على triggers في بياناتها الوصفية تُربط تلقائياً بالمجدول. المهارات ذات requires_tools تُفحص مقابل أدوات الوكيل المتاحة -- إذا كانت أداة مطلوبة غير متاحة، تُعلّم المهارة لكنها لا تُحظر.

التأليف الذاتي للوكيل

عامل تمييز أساسي: يمكن للوكيل كتابة مهاراته الخاصة. عندما يُطلب منه فعل شيء لا يعرف كيف يفعله، يمكن للوكيل استخدام بيئة التنفيذ لإنشاء SKILL.md وكود داعم، ثم تعبئته كمهارة مساحة عمل.

تدفق التأليف الذاتي

1. أنت:    "أحتاج أن تتحقق من Notion للمهام الجديدة كل صباح"
2. الوكيل: ينشئ مهارة في ~/.triggerfish/workspace/<agent-id>/skills/notion-tasks/
           يكتب SKILL.md مع البيانات الوصفية والتعليمات
           يكتب كود داعم (notion-tasks.ts)
           يختبر الكود في بيئة التنفيذ
3. الوكيل: يعيّن المهارة كـ PENDING_APPROVAL
4. أنت:    تستقبل إشعار: "مهارة جديدة أُنشئت: notion-tasks. مراجعة وموافقة؟"
5. أنت:    توافق على المهارة
6. الوكيل: يربط المهارة بمهمة cron للتنفيذ اليومي

أمان المهارات المؤلفة من الوكيل تتطلب دائماً موافقة المالك قبل

أن تصبح نشطة. لا يمكن للوكيل الموافقة على مهاراته الخاصة. هذا يمنع الوكيل من إنشاء قدرات تتجاوز إشرافك. :::

ضوابط المؤسسات

في نشر المؤسسات، تنطبق ضوابط إضافية على المهارات المؤلفة ذاتياً:

• المهارات المؤلفة من الوكيل تتطلب دائماً موافقة المالك أو المسؤول
• لا يمكن للمهارات إعلان سقف تصنيف أعلى من صلاحية المستخدم
• إعلانات نقاط نهاية الشبكة تُدقّق
• جميع المهارات المؤلفة ذاتياً تُسجّل لمراجعة الامتثال

The Reef 🚧 Coming Soon

The Reef هو سوق المهارات المجتمعي في Triggerfish -- سجل حيث يمكنك اكتشاف وتثبيت ونشر ومشاركة المهارات.

الميزة	الوصف
البحث والتصفح	البحث عن مهارات حسب الفئة أو العلامة أو الشعبية
تثبيت بأمر واحد	triggerfish skill install <name>
النشر	مشاركة مهاراتك مع المجتمع
المسح الأمني	مسح آلي لأنماط خبيثة قبل الإدراج
الإصدارات	المهارات مُصدّرة مع إدارة التحديثات
المراجعات والتقييمات	ملاحظات المجتمع على جودة المهارة

أوامر CLI

# البحث عن مهارات
triggerfish skill search "calendar"

# تثبيت مهارة من The Reef
triggerfish skill install google-cal

# عرض المهارات المثبتة
triggerfish skill list

# تحديث جميع المهارات المُدارة
triggerfish skill update --all

# نشر مهارة إلى The Reef
triggerfish skill publish

# إزالة مهارة
triggerfish skill remove google-cal

الأمان

المهارات المثبتة من The Reef تمر بنفس دورة الحياة كأي تكامل آخر:

1. تُحمّل إلى مجلد المهارات المُدارة
2. تُمسح بحثاً عن أنماط خبيثة (حقن كود، وصول شبكة غير مصرح به، إلخ)
3. تدخل حالة UNTRUSTED حتى تصنّفها
4. تُصنّف وتُفعّل من قبل المالك أو المسؤول

يمسح The Reef جميع المهارات المنشورة بحثاً عن أنماط خبيثة معروفة قبل

إدراجها. ومع ذلك، يجب عليك مراجعة المهارات قبل تصنيفها، خاصةً المهارات التي تعلن وصول شبكة أو تتطلب أدوات قوية مثل exec أو browser. :::

ملخص أمان المهارات

• تعلن المهارات متطلباتها الأمنية مقدماً (سقف التصنيف، الأدوات، نطاقات الشبكة)
• الوصول للأدوات محكوم بالسياسة -- مهارة تحتاج requires_tools: [browser] لن تعمل إذا كان وصول المتصفح محظوراً بالسياسة
• نطاقات الشبكة مُطبّقة -- لا يمكن للمهارة الوصول لنقاط نهاية لم تعلن عنها
• المهارات المؤلفة من الوكيل تتطلب موافقة صريحة من المالك/المسؤول
• جميع استدعاءات المهارات تمر عبر خطافات السياسة ويتم تدقيقها بالكامل