كيف تستخدم Codex بأمان داخل مشروع برمجي قائم؟
مسار عملي يستخدم الفروع وAGENTS.md وأقل الصلاحيات وتغييرات محددة واختبارات وحماية الأسرار والمراجعة البشرية عند استخدام Codex.
راجع المقال الأصلي وثائق تطبيق Codex وسطر الأوامر وبيئة التطوير والأمان وحالات الاستخدام والخطط في 25 أغسطس 2026. هذا دليل ضوابط مستودع، وليس ادعاء بأن الموقع شغّل Codex على مستودع اختبار أو شاهد تطبيق العزل والموافقة والتراجع فعليًا.
حدد درجة الخطر قبل طلب الكود
تتبع الدرجة العملية الأعلى أثرًا، لا حجم الطلب الظاهر. تعديل صلاحية بسطر واحد قد يدخل الدرجة الثالثة.
- الدرجة 0 — فحص: قراءة وشرح سلوك واقتراح اختبارات دون تعديل.
- الدرجة 1 — تعديل محدود: ملفات مسماة دون تغيير تبعيات برمجية أو مخطط بيانات أو إعدادات.
- الدرجة 2 — تغيير مشترك: مكونات مشتركة أو تبعيات برمجية أو إعدادات بناء أو ترحيلات بيانات.
- الدرجة 3 — حالة خارجية: نشر أو استبدال بيانات اعتماد أو تغيير حساب أو كتابة إنتاجية أو إرسال رسائل.
دليل الفروع والموافقة والاختبار والتراجع
- سجل نقطة البداية: مسار المستودع والفرع والملفات المعدلة والاختبارات الحالية والنتيجة المطلوبة. المخرج حالة تحفظ عمل المستخدم. توقف إذا غمضت نسخة العمل المقصودة أو ملكية التعديلات.
- اعزل المهمة: أنشئ فرعًا أو worktree معتمدًا وحدد الملفات المسموحة والعمليات المحظورة. المخرج مساحة محدودة يمكن استعادتها.
- راجع الخطة: افحص الملفات والأوامر والتبعيات البرمجية والآثار الخارجية قبل التنفيذ. المخرج خطة بنقاط موافقة منفصلة للمخاطر الأعلى. توقف إذا أدخلت كتابة إنتاجية أو أسرارًا أو إعادة هيكلة غير مرتبطة.
- تحقق من التغيير: شغّل الاختبارات المحددة وفحص الأنواع والبناء والمتصفح أو المنصة بما يناسب الخطر. المخرج أدلة مرتبطة بالتغيير والبيئة المحددين.
- جهز التراجع: وضح إعادة الكود واستعادة أي حالة خارجية قبل موافقة الإصدار. المخرج تسليم يفصل ما تحقق وما ينتظر وما لم يُختبر.
اضبط الفروع ومساحات العمل
لا تخفِ وجود تعديلات سابقة في نسخة العمل. احفظ غير المرتبط منها ولا تعزل العمل الجديد إلا بعد تأكيد أساس الفرع. يفيد worktree المهام المتوازية عندما تكون المسارات معروفة، لكنه لا يجعل تعديل وكيلين للملف نفسه آمنًا.
اجعل كل commit محددًا بما يستطيع المراجع تفسيره. لا تخلط تغيير مدير الحزم أو تنسيقًا شاملًا أو ترحيل مسارات بإصلاح ميزة إلا إذا تطلبت المهمة ذلك.
الموافقة صلاحية محددة النطاق
يجب أن تسمي الموافقة العملية والهدف. السماح بالاختبارات لا يسمح بتثبيت حزمة، وتعديل الموقع لا يسمح بلمس غلاف التطبيق الأصلي، وتجهيز الإصدار لا يسمح بالدفع إلى Git أو النشر.
راجع الأوامر التي تحتوي أنماط مسارات أو متغيرات بيئة أو عمليات تشمل المجلدات الفرعية أو تركيب أوامر shell. افحص سكربت الطرف الثالث قبل التشغيل. لا تكشف محتويات البيئة في السجلات لإثبات الإعداد.
اختبر على مستوى الادعاء
قد يثبت اختبار وحدة قاعدة مستقلة، لكنه لا يثبت عرض صفحة أو استجابة خادم HTTP أو تحميل CSS في WebView أو انتشار مسار إنتاجي. اربط كل ادعاء إتمام بدليل من مستواه واذكر ما تعذر فحصه.
في إصلاح العطل أعد إنتاجه أولًا ثم أضف اختبار منع رجوعه. في الواجهة اختبر عروضًا ممثلة ونصًا طويلًا. في المسارات والبيانات الوصفية افحص المخرجات المبنية واستجابة HTTP الفعلية.
احفظ دليل التراجع
قبل الإصدار سجل commit واتجاه الترحيل وفروق الإعداد والعمليات الخارجية التي لا يتراجع عنها Git. إذا حذفت عملية بيانات أو استبدلت مفتاحًا، اطلب صلاحية جديدة ووثق الاستعادة قبل التنفيذ.
اختر واجهة الإشراف المناسبة عبر دليل واجهات Codex. يبقى إنفاذ المنتج غير مثبت هنا؛ لم نراقب عزل Codex أو طلب موافقة أو تراجعًا في جلسة حية، لذلك يحتاج الإعداد المحلي إلى تجربة محدودة.
مصادر المعلومات
هذه المصادر الرسمية للمقال الأصلي. كثير من صفحاتها باللغة الإنجليزية.