پلتفرم مهارتها
مهارتها هي آلية التوسيع الأساسية در Triggerfish. المهارت هي مجلد يحتوي روی ملف SKILL.md -- تعليمات وبيانات وصدرة تازح عامل قدرات جديدة بدون الحاجة لكتابة plugin یا بناء كود مخصص.
مهارتها هي چگونه يتعلم عامل فعل أشياء جديدة: التحقق از تقويمك، إعداد ملخصات صباحية، فرز مشكخیرت GitHub، صياغة ملخصات أسبوعية. يمكن تثبيتها از سوق، یا كتابتها بهصورت دستی، یا تأليفها از قبل عامل نفسه.
ما هي المهارت؟
المهارت هي مجلد يحتوي روی ملف SKILL.md در جذره. يحتوي الملف روی بيانات وصدرة YAML (frontmatter) ومتن markdown (تعليمات للعامل). ملفات داعمة اختیاریة -- سكربتات، قوالب، تكوين -- يمكن أن تعيش بجانبه.
morning-briefing/
SKILL.md
briefing.ts # كود داعم اختیاری
template.md # قالب اختیاریبيانات SKILL.md الوصدرة تعلن ما تفعله المهارت، وما تحتاجه، وما قيود اازیت التي تنطبق:
yaml
---
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 | خیر | أقصى مستوى Taint يمكن أن تصله المهارت (پیشفرض: 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، مزوّدي ذخیرهسازی، ابزارها التندرذ، وpluginها. |
| git-branch-management | سير عمل فروع Git للتطوير. فروع ویژگیها، الإيداعات الذرية، إنشاء PR از طریق gh CLI، تتبع PR، حلقة مخیرحظات الممراجعه کنیدة از طریق webhooks، الدمج والتنظيف. |
| deep-research | ازهجية بحث متعدد الخطوات. تقييم المصادر، عمليات بحث متوازية، توليف، وتنسيق اخیرقتباسات. |
| باالجة مستندات PDF. استخراج النص، التلخيص، واستخراج البيانات الازظمة از ملفات PDF. | |
| triggerfish | بارفة ذاتية عن بنية Triggerfish الداخلية. باماری، پیکربندی، عیبیابی، وأنماط التطوير. |
| triggers | تأليف السلوك اخیرستباقي. كتابة ملفات TRIGGER.md فعّالة، أنماط المراقبة، وقوانین التصعيد. |
این هي مهارات التمهيد -- يستخدمها عامل لتوسيع نفسه. skill-builder يعلّم عامل نحوه إنشاء مهارات جديدة، و integration-builder يعلّمه نحوه بناء محوّخیرت ومزوّدين جدد.
ببینید ساخت مهارتها لدليل عملي لإنشاء مهاراتك الخاصة.
مهارتها المُدارة
تُثبّت از The Reef (سوق مهارتها المجتباي). تُحمّل وتُخزّن در ~/.triggerfish/skills/.
bash
triggerfish skill install google-cal
triggerfish skill install github-triageمهارات مساحة العمل
تُنشأ از قبل المستخدم یا يؤلفها عامل در بيئة التندرذ. تُخزّن در مساحة عمل عامل در ~/.triggerfish/workspace/<agent-id>/skills/.
مهارات مساحة العمل لها الیالوية الأروی. إذا أنشأت مهارت بنفس اخیرسم كمهارت مدمجة یا مُدارة، تكون نسختك هي السائدة.
الیالوية: مساحة العمل > المُدارة > المدمجةترتيب الیالوية این يعني أنه میتوانید همیشه تجاوز مهارت مدمجة یا
از السوق بنسختك الخاصة. تخصيصاتك خیر تُستبدل هرگز بالتحديثات. :::
اكتشاف وتحميل مهارتها
عندما يبدأ عامل یا عندما تتغير مهارتها، يشغّل Triggerfish عملية اكتشاف مهارتها:
- الماسح -- يجد تمام مهارتها المثبتة از طریق المجلدات المدمجة والمُدارة ومساحة العمل
- المُحمّل -- يقرأ بيانات SKILL.md الوصدرة ويتحقق از البيانات
- المُحلّل -- يحل تعارضات الأسماء باستخدام ترتيب الیالوية
- التسجيل -- يجعل مهارتها متاحة للعامل با قدراتها وقيودها المُعلنة
مهارتها التي تحتوي روی 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
bash
# البحث عن مهارات
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 تمر بنفس دورة الحياة كهر یکپارچهسازی آخر:
- تُحمّل به مجلد مهارتها المُدارة
- تُمسح بحثاً عن أنماط خبيثة (حقن كود، وصول شبكة غير مصرح به، إلخ)
- تدخل حالة
UNTRUSTEDحتى تصنّفها - تُصنّف وتُفعّل از قبل المالك یا المسؤول
يمسح The Reef تمام مهارتها الازشورة بحثاً عن أنماط خبيثة باروفة قبل
إدراجها. وبا آن، باید عليك ممراجعه کنیدة مهارتها قبل طبقهبندیها، خاصةً مهارتها التي تعلن وصول شبكة یا تتدرخواست ابزارها قوية مثل exec یا browser. :::
ملخص أمان مهارتها
- تعلن مهارتها متدرخواستاتها الأازية مقدماً (سقف طبقهبندی، ابزارها، نطاقات الشبكة)
- الوصول لخیربزارها محكوم بسیاست -- مهارت تحتاج
requires_tools: [browser]لن تعمل إذا كان وصول مرورگر محظوراً بسیاست - نطاقات الشبكة مُطبّقة -- نمیتوان للمهارت الوصول لنقاط نهاية لم تعلن عنها
- مهارتها المؤلفة از عامل تتدرخواست موافقة صريحة از المالك/المسؤول
- تمام فراخوانیات مهارتها تمر از طریق Hookات سیاست وانجام میشود تدقيقها کامخیرً