SPINE و Triggers

يستخدم Triggerfish ملفين markdown لتحديد سلوك وكيلك: SPINE.md يتحكم في من هو وكيلك، و TRIGGER.md يتحكم في ما يفعله وكيلك بشكل استباقي. كلاهما markdown حر الشكل -- تكتبهما بلغة عادية.

SPINE.md -- هوية الوكيل

SPINE.md هو أساس prompt النظام لوكيلك. يحدد اسم الوكيل وشخصيته ومهمته ومجالات معرفته وحدوده. يُحمّل Triggerfish هذا الملف في كل مرة يعالج فيها رسالة، لذا تسري التغييرات فوراً.

موقع الملف

~/.triggerfish/SPINE.md

لإعدادات متعددة الوكلاء، كل وكيل لديه SPINE.md خاص:

~/.triggerfish/workspace/<agent-id>/SPINE.md

البدء

يُنشئ معالج الإعداد (triggerfish dive) SPINE.md بدائي بناءً على إجاباتك. يمكنك تحريره بحرية في أي وقت -- إنه مجرد markdown.

كتابة SPINE.md فعال

SPINE.md الجيد محدد. كلما كنت أكثر تحديداً حول دور وكيلك، كان أداؤه أفضل:

# الهوية

أنت Reef، مساعد ذكاء اصطناعي شخصي لسارة.

# المهمة

ساعد سارة على البقاء منظمة ومُطلعة ومنتجة. أعطِ الأولوية لإدارة التقويم
وفرز البريد الإلكتروني وتتبع المهام.

# أسلوب التواصل

- كن مختصراً ومباشراً. بدون حشو.
- استخدم النقاط للقوائم من 3+ عناصر.
- عند عدم اليقين، قل ذلك بدلاً من التخمين.
- طابق رسمية القناة: عفوي على WhatsApp، مهني على Slack.

# المعرفة المجالية

- سارة مديرة منتجات في شركة Acme Corp.
- الأدوات الرئيسية: Linear للمهام، Google Calendar، Gmail، Slack.
- جهات اتصال VIP: @boss (ديفيد تشن)، @skip (ماريا لوبيز).
- الأولويات الحالية: خارطة طريق Q2، إطلاق تطبيق الجوال.

# الحدود

- لا ترسل أبداً رسائل لجهات اتصال خارجية بدون موافقة صريحة.
- لا تقم أبداً بمعاملات مالية.
- تأكد دائماً قبل حذف أو تعديل أحداث التقويم.
- عند مناقشة مواضيع العمل على القنوات الشخصية، ذكّر سارة بحدود التصنيف.

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

كن محدداً حول الشخصية. بدلاً من "كن مفيداً"، اكتب "كن مختصراً

ومباشراً واستخدم النقاط للوضوح." :::

أضف سياقاً عن المالك. يؤدي الوكيل بشكل أفضل عندما يعرف دورك

وأدواتك وأولوياتك. :::

تعليمات SPINE.md توجه سلوك LLM لكنها ليست ضوابط أمنية. للقيود

القابلة للتنفيذ، استخدم محرك السياسات في triggerfish.yaml. محرك السياسات حتمي ولا يمكن تجاوزه -- تعليمات SPINE.md يمكن تجاوزها. :::

TRIGGER.md -- السلوك الاستباقي

TRIGGER.md يحدد ما يجب على وكيلك فحصه ومراقبته والعمل عليه أثناء عمليات الإيقاظ الدورية.

موقع الملف

~/.triggerfish/TRIGGER.md

كيف تعمل Triggers

1. تُوقظ حلقة trigger الوكيل على فترات مُكوّنة (مُعينة في triggerfish.yaml)
2. يُحمّل Triggerfish TRIGGER.md ويقدمه للوكيل
3. يُقيّم الوكيل كل عنصر ويتخذ إجراءً إذا لزم الأمر
4. جميع إجراءات trigger تمر عبر hooks السياسات العادية
5. جلسة trigger تعمل بسقف تصنيف (مُكوّن أيضاً في YAML)
6. ساعات الهدوء محترمة -- لا triggers تُطلق خلالها

تكوين Trigger في YAML

trigger:
  interval: 30m
  classification: INTERNAL
  quiet_hours: "22:00-07:00"

كتابة TRIGGER.md

نظّم triggers حسب الأولوية. كن محدداً حول ما يُعتبر قابلاً للعمل وماذا يجب على الوكيل فعله حياله.

# فحوصات الأولوية

- رسائل غير مقروءة عبر جميع القنوات أقدم من ساعة -- لخص وأخطر على القناة
  الرئيسية.
- تعارضات التقويم في الـ 24 ساعة القادمة -- أشر واقترح حلاً.
- مهام متأخرة في Linear -- اذكرها مع أيام التأخر.

# المراقبة

- GitHub: طلبات سحب تنتظر مراجعتي -- أخطر إذا أقدم من 4 ساعات.
- البريد: أي شيء من جهات VIP -- أشر للإخطار الفوري.
- Slack: الإشارات في قناة #incidents -- لخص وصعّد إذا لم تُحل.

# استباقي

- إذا صباح (7-9 صباحاً)، أعد تقريراً يومياً بالتقويم والطقس وأهم 3 أولويات.
- إذا عصر الجمعة، صغ ملخصاً أسبوعياً للمهام المكتملة والعناصر المفتوحة.

Triggers ومحرك السياسات

جميع إجراءات trigger تخضع لنفس تنفيذ السياسات كالمحادثات التفاعلية:

• كل إيقاظ trigger يُنشئ جلسة معزولة بتتبع taint خاص بها
• سقف التصنيف في تكوين YAML يحد من البيانات التي يمكن لـ trigger الوصول إليها
• قاعدة منع الكتابة للأسفل تنطبق
• جميع إجراءات trigger تُسجل في مسار التدقيق

SPINE.md مقابل TRIGGER.md

الجانب	SPINE.md	TRIGGER.md
الغرض	تحديد من هو الوكيل	تحديد ما يراقبه الوكيل
يُحمّل	كل رسالة	كل إيقاظ trigger
النطاق	جميع المحادثات	جلسات trigger فقط
يؤثر على	الشخصية، المعرفة، الحدود	الفحوصات والإجراءات الاستباقية
مطلوب	نعم (يُنشأ بواسطة معالج dive)	لا (لكن مُوصى)

الخطوات التالية

• كوّن توقيت trigger ومهام cron في triggerfish.yaml
• تعلم جميع أوامر CLI المتاحة في مرجع الأوامر