AGENT.md
AGENT.md ملف Markdown بسيط. ابدأه بمقدمة تسمّي الموظف وتقدّم وصفًا من سطر واحد، ويستخدم المتجر وقوى المالك العاملة كليهما. ثم اكتب الشخصية بصيغة المخاطَب: مسؤوليات الموظف، وكيف يعمل، وقواعده.
--- name: Collections Specialist description: Follows up on every overdue invoice until it is paid, disputed, or handed to the owner. --- # Collections Specialist You keep receivables moving. Every overdue invoice gets a follow-up on schedule, in a tone that protects the customer relationship. ## How you work - Check the aging report before any follow-up so you never chase a paid invoice. - Escalate to the owner when a customer disputes an amount. ## Rules - Never threaten, and never mention collections agencies. - Never agree to a payment plan; propose it to the owner.
يعطي Nebo الموظف شخصيته في بداية كل جلسة، مع اسمه ووصفه وأي مُشغِّلات من المقدمة، والإعدادات التي يعطيه إياها المالك في Nebo: شخصيته وقواعده وروحه. الشخصية خاصة بالموظف، ولا تُضاف أبدًا إلى موجّه يتشاركه موظفون آخرون.
اكتب ما يتولاه الدور من مسؤوليات وكيف يتخذ قراراته. واترك أسماء الأدوات والمنتجات: فأدوات الموظف تأتي من قدراته واتصالاته، ويجب أن تعمل الشخصية نفسها في كل شركة توظّفه.
الذاكرة
يقرأ كل موظف حقائق المالك الخاصة ولا يكتب إلا في ذاكرته هو. ويتعامل مع الذاكرة عبر الأدوات remember وrecall وforget. اختر كيف تُحفظ محادثاته وذاكرته عبر memory.mode في agent.json.
| الوضع | السلوك | استخدمه في |
|---|---|---|
single | محادثة واحدة مستمرة وذاكرة واحدة. الوضع الافتراضي. | معظم الأدوار. |
separate | تتشارك محادثات كثيرة ذاكرة الموظف الخاصة. والمحادثة مع شخص غير المالك، مثل متصل أو زائر، تحتفظ بذاكرتها المختومة الخاصة. | الأدوار التي تتحدث إلى كثير من الناس. |
confidential | كل محادثة قضية مختومة. لا شيء يُتعلَّم في واحدة يظهر في أخرى، بما في ذلك محادثات المالك. | شؤون العملاء التي يجب أن تبقى منفصلة. |
"memory": {
"mode": "separate",
"topics": [
{ "slug": "account", "description": "A customer account: balance, promises to pay, contacts, disputes" }
],
"write_bar": ["web", "external-email"],
"share_with": []
} | الحقل | المعنى |
|---|---|
mode | single أو separate أو confidential. تُقرأ القيمة القديمة context_isolated: true على أنها separate. |
topics | ما يصل إلى 8 أزواج {slug, description} تخبر الموظف بأنواع الأشياء التي يتذكرها. تكون الأسماء المختصرة بأحرف صغيرة مع شرطات، والأوصاف من 1 إلى 120 حرفًا. الأسماء المحجوزة: tacit، entity، daily، project، memory، style، artifact. |
write_bar | التشغيل الذي استوعب محتوى من أحد هذه المصادر لا يمكنه الكتابة في الذاكرة: web، external-email، channel، document، phone، coworker. وعند الحذف، يُحظر channel وphone في الوضعين separate وconfidential. والقائمة الفارغة تُلغي الحظر. |
share_with | معرّفات الموظفين، أو *، المسموح لهم بتلقي ذاكرة هذا الموظف في الردود الموجّهة إليهم. فارغ افتراضيًا، أي لا مشاركة لأي شيء. |
طبقة الشركة
طبقة الشركة معرفة يتشاركها كل الموظفين: مفردات الشركة، والأطراف التي تتعامل معها، وقواعدها، والقوانين والمعايير، والمواد المرجعية. وتوجد في حزم على البوت. الحزمة مجلد فيه ملف علامة واحد بالضبط، INDUSTRY.md أو FRANCHISE.md أو COMPANY.md، ومجلدات مصنّفة بجانبه. وعند تعارض الطبقات، تتقدّم الشركة على الامتياز التجاري، والامتياز على القطاع.
<data>/packs/example-co/ ├── COMPANY.md ├── vocabulary/ ├── parties/ ├── rules/ ├── laws/ │ └── refunds.md ├── standards/ ├── workflows/ └── reference/
كل ملف في المجلد ملف Markdown مع مقدمة اختيارية. تحمل المقدمة البنية، مثل always الخاصة بالقاعدة، أو id وvalue الخاصين بالمعيار، أو ceiling الخاص بالقانون، ويحمل المتن النثر. تحتوي الحزمة على المعرفة لا الإجراءات أبدًا، لذا تُرفض الحزمة التي تحتوي على مهارة.
القوانين
يسرد ceiling الخاص بالقانون العمليات التي لا يجوز لأي موظف تنفيذها. وفي طبقة الشركة، يغيّر reserved_to: owner ذلك: تبقى العمليات ممكنة، لكن بموافقة المالك نفسه فقط، ولا يمكن التنازل عن تلك الموافقة لأحد أبدًا.
--- ceiling: [ledger.refund.create] reserved_to: owner --- Refunds are issued only by the owner. Employees may prepare a refund and send it to the owner for approval.
كيف يتعلم الموظفون الطبقة
لا يبحث الموظفون في الطبقة أثناء عملهم. فعندما تتغير طبقة، يقرأ كل موظف التغيير مرة واحدة ويعيد كتابة قواعده الخاصة. ويستطيع المالك دائمًا تعديل COMPANY.md وكل مجلد من مجلدات الشركة، وحفظ التغيير هو الطريقة التي يقرّر بها المالك ما هو صحيح.