📄️ خطافات الوكلاء
لا تفعل خطافات دورة الحياة المُودَعة في المستودع سوى تنسيق ملفات JavaScript/TypeScript التي عُدّلت بنجاح، عبر oxfmt المثبَّت. ويوجد المنطق المشترك في scripts/agent-hooks/format.mjs؛ ويفوّض كل غلاف أصلي العمل إليه.
📄️ المهارات والأدوات
توجد المهارات المشتركة في .agents/skills/. عدّل هذه المصادر، ثم شغّل yarn ai-workflow:sync لتوليد .claude/skills/ من أجل Claude Code. يكتشف Codex وCursor المجلد .agents/skills/ مباشرةً؛ فلا تُعِد الجذرين المكرَّرين .codex/skills/ أو .cursor/skills/.
📄️ سير عمل التحقيق في الأخطاء
استخدم هذا عندما يتم الإبلاغ عن خطأ في كتلة ملف/سطر/رمز محدد.
📄️ الترجمات
يستخدم موقع about ملفات JSON الخاصة بـ i18next في about/public/translations//default.json. أما ترجمات مصادر Docusaurus فتوجد بشكل منفصل في docs/i18n/.
📄️ الالتزام وشكل الإصدار
استخدم هذا عند اقتراح أو تنفيذ تغييرات ذات معنى في التعليمات البرمجية.
📄️ عمل الوكلاء طويل الأمد
استخدم حالة مهمة دائمة عندما يحتاج العمل إلى استئناف أو تسليم، أو عندما يطول التشغيل الواحد بما يكفي لأن يؤدي ضغط السياق إلى فقدان تتبّع العمل المتبقي. ولا تحتاج المهام الصغيرة إلى لوحة أو ملف تقدّم. وفي العمل المشترك، احتفظ بملفي feature-list.json وprogress.md موجزين في مجلد docs/agent-runs// خاص بالمهمة، مستعينًا بالقوالب الموجودة حيثما يفيد ذلك.
📄️ مفاجآت معروفة
يوثّق هذا الملف نقاط الالتباس الخاصة بهذا المستودع والتي تسببت في أخطاء لدى الوكلاء.
🗃️ قوالب
2 مواد