حزمة OpenAI المتقدمة

تحتوي هذه المجلد على شكل المستودع الأكثر توجيهاً الموصوف في مقال OpenAI "Harness engineering: leveraging Codex in an agent-first world" كملفات بداية جاهزة للنسخ.

استخدم هذه الحزمة عندما لا يكفي harness البسيط بعد ومستودعك يحتاج الآن إلى:

• ملف AGENTS.md قصير بنمط التوجيه
• وثائق نظام السجل الدائم داخل المستودع
• خطط تنفيذ نشطة ومكتملة
• ملفات سياسة صريحة للمنتج والموثوقية والأمان والواجهة الأمامية
• تسجيل الجودة حسب مجال المنتج والطبقة المعمارية
• مجلدات مراجع صديقة للنماذج
• إجراءات تشغيل قياسية للهندسة المعمارية والتقاط المعرفة والتحقق في وقت التشغيل

كيفية التبني

1. ابدأ بالحزمة البسيطة إذا كان مستودعك لا يزال صغيراً.
2. انسخ الملفات في repo-template/ إلى مستودعك الخاص عندما تحتاج هيكلاً أقوى.
3. أبقِ AGENTS.md قصيراً. تعامل معه كموّجه إلى الوثائق الأعمق، لا كموسوعة.
4. حدّث وثائق الجودة والموثوقية والخطط كجزء من العمل العادي، لا كيوم تنظيف منفصل.
5. أبقِ المنتجات المُنشأة والمراجع الخارجية صريحة حتى يتمكن الوكلاء من إيجادها بدون الاعتماد على سجل المحادثة.

مبادئ التصميم

• نقطة دخول قصيرة، وثائق أعمق مرتبطة
• المستودع كسجل للنظام
• الفحوصات الميكانيكية أفضل من القواعد المحفوظة
• الخطط وتاريخ الجودة بجانب الكود
• التنظيف والتبسيط مسؤوليات من الدرجة الأولى

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