ChatGPT وCodex: من الفكرة إلى الشيفرة دون تخطّي المراجعة
سير عمل عملي: صِغ الفكرة والموجز في ChatGPT، وأعطِ Codex تغييراً واحداً محدوداً، ثم راجع التعديلات قبل الدمج. مع تعليمات جاهزة للنسخ.

الحكم السريع
استخدم ChatGPT لتقرّر ماذا تبني، وCodex ليبنيه، واجعل شخصاً يراجع النتيجة بين الخطوتين. حين يتعثّر مشروع يُبنى بمساعدة الذكاء الاصطناعي، يكون الخلل غالباً عند الانتقال من مرحلة إلى أخرى. تصل الفكرة إلى وكيل البرمجة قبل أن يكتب أحد ما معنى «انتهى العمل»، أو يدمج أحدهم تعديلات تبدو واثقة لمجرد أنّ الاختبارات نجحت.
- ChatGPT (صفحة الأداة): اختبر الفكرة، وقلّص النطاق، واكتب موجزاً من صفحة واحدة فيه معايير قبول.
- Codex (صفحة الأداة): يستكشف المستودع، وينفّذ تغييراً واحداً محدوداً، ويشغّل الفحوص، ويذكر ما لم يستطع التحقق منه.
- أنت أو المطوّر لديك: وافق على الخطة قبل كتابة الشيفرة، وراجع التعديلات والأدلة قبل دمج أي شيء.
يتناول باقي الدليل هذه الخطوات بالترتيب. كل التعليمات قابلة للنسخ: املأ ما بين القوسين المعقوفين، وعدّل الأسماء لتناسب مشروعك، ثم شغّلها. التعليمات هنا بالعربية، ولك أن تكتبها بالإنجليزية إن كان فريقك يعمل بها.
لماذا تقسّم العمل بين أداتين؟
الأداتان من OpenAI، ويستطيع ChatGPT أيضاً قراءة الشيفرة وكتابتها، لكنّ كلاً منهما يناسب مرحلة مختلفة من العمل. ChatGPT محادثة: تأتي بهدف وبعض السياق، ثم تشكّل الجواب بمناقشته والاعتراض عليه. أمّا Codex فوكيل برمجة، أي أداة ذكاء اصطناعي تنفّذ العمل بنفسها داخل مستودع الشيفرة: تقرأ الملفات، وتعدّل الشيفرة، وتشغّل الأوامر والاختبارات، وتواصل حين يفشل شيء.
يهمّ هذا التقسيم المؤسسين غير التقنيين والفرق الصغيرة أكثر من غيرهم. فالقرارات التي يكلّف الخطأ فيها كثيراً، مثل لمن المنتج، وماذا تتضمن نسخته الأولى، ومتى يُعدّ العمل منتهياً، مكانها وثيقة يقرؤها شخص ويناقشها. ووكيل البرمجة يستلم هذه الوثيقة موجزاً لعمله، ولا يكتبها بنفسه.
الخطوة 1: اختبر الفكرة في ChatGPT
الفكرة التي ما زالت إحساساً لا تصلح موجزاً. قبل أي تخطيط، اطلب من ChatGPT أن يسرد الافتراضات التي تقوم عليها الفكرة، واطلب منه ألّا يجاملك:
أفكّر في [الفكرة] لـ[الجمهور].
قبل أن تقترح أي شيء، اسألني حتى خمسة أسئلة عن العميل والمشكلة.
ثم أعطني:
- الافتراضات التي تقوم عليها الفكرة، مرتّبة من الأرجح خطأً إلى الأقل؛
- الدليل الذي يختبر كل افتراض؛
- أصغر تجربة أستطيع إجراءها هذا الأسبوع دون أن أبني شيئاً.
ناقش الفكرة بنقد، ولا تجاملني.
وإن كانت الفكرة تعتمد على سوق لا تعرفه جيداً، فارسم صورتها قبل أن تنفق المال على بحث حقيقي:
أبحث في سوق [المنتج أو الخدمة] في [الدولة أو المدينة].
أعطني:
- الشرائح الرئيسية من العملاء، وما تستخدمه كل شريحة اليوم بدلاً من ذلك؛
- ما يشتكي منه الناس علناً في الخيارات الحالية؛
- الأسئلة الخمسة التي يجب أن أجيب عنها ببحث حقيقي قبل أن أنفق المال.
لكل سؤال، اقترح أين أجد الجواب.
افصل ما تعرفه عمّا تستنتجه.
تعامل مع الجوابين على أنهما قائمة أمور تتحقق منها، لا نتائج. يستطيع ChatGPT البحث في الويب وتلخيص المصادر، لكنه قد يخطئ أو يعتمد على مصادر ضعيفة. وكل رقم تنوي أن تبني عليه قراراً يحتاج إلى مصدر قرأته بنفسك.
الخطوة 2: اكتب موجز النسخة الأولى مع معايير القبول
حين تصمد الفكرة، تأتي مشكلة النطاق. تحوّل هذه التعليمات فقرةً واحدة إلى خطة يمكن أن تحاسب عليها المطوّر، أو وكيل البرمجة:
هذه الفكرة في فقرة واحدة: [الوصف].
حوّلها إلى خطة للنسخة الأولى:
- رحلة المستخدم الوحيدة التي يجب أن تعمل من أولها إلى آخرها؛
- الميزات التي تحتاجها هذه الرحلة، مرتّبة حسب الأولوية؛
- ما تتركه النسخة الأولى عمداً، ولماذا؛
- معايير قبول أستطيع التحقق منها لكل ميزة.
في صفحة واحدة. نبّهني إلى أي شيء يحتاج إلى قرار تقني قبل بدء التطوير.
خمس عادات تجعل هذه الخطوة، وكل محادثة مع ChatGPT، أكثر فائدة:
- ابدأ بالهدف، لا بالمهمة. «أحاول استعادة العملاء الذين توقفوا عن الشراء» تأتيك بجواب أفضل من «اكتب رسالة بريد».
- أعطه السياق المهم: الجمهور، وقيودك، وما جرّبته من قبل، وشكل النتيجة الجيدة. والصق المادة نفسها بدلاً من وصفها.
- صِف ما تريد أن تستلمه. اطلب «خطة من صفحة واحدة مع معايير قبول»، وستحصل عليها.
- اعتبر الجواب الأول مسودة. اطلب بدائل، واطلب منه أن يعترض على اقتراحه هو.
- تحقّق قبل أن يخرج النص من يدك. راجع الأسماء والأرقام والادعاءات. القرار فيما يُنشر قرارك.
توقّف حين يصير لديك موجز توافق عليه. ويجب أن يكون كل معيار قبول شيئاً يستطيع شخص اختباره، مثل «النتيجة الفارغة تنزّل ملفاً فيه رؤوس الأعمدة فقط». أمّا «التصدير يعمل جيداً» فلا يمكن اختباره.
الخطوة 3: جهّز المستودع قبل أن يعمل فيه Codex
يعمل Codex في أكثر من مكان، وكلها تستخدم الوكيل نفسه، فاختر ما يناسب طريقة عملك أو عمل المطوّر لديك:
- Codex CLI يعمل في الطرفية (Terminal) من مجلد مشروعك، ويستخدم الأدوات المثبّتة على جهازك.
- إضافة المحرّر (IDE) تعمل في VS Code والمحرّرات المتوافقة معه، ومنها Cursor وWindsurf. ولـXcode وبيئات JetBrains تكاملات خاصة بها.
- تطبيق ChatGPT لسطح المكتب يتيح لك اختيار Codex حين تبدأ محادثة، ويجمع المشاريع والأعمال الطويلة في مكان واحد.
- Codex Cloud ينفّذ المهام عن بُعد على مستودع مرتبط في GitHub أو GitLab. لكل مهمة مساحة عمل خاصة بها، وتستمر المهمة في العمل وحاسوبك في وضع السكون.
قبل المهمة الأولى، جهّز أربعة أشياء:
- مكان آمن للعمل. استخدم فرعاً (branch) أو نسخة عمل منفصلة (worktree)، فتبقى تعديلات الوكيل بعيدة عن أي عمل آخر جارٍ. نسخة العمل المنفصلة تفصل الملفات، لكنها ليست بيئة معزولة للحماية.
- قواعد المستودع في AGENTS.md. يقرأ Codex هذا الملف في بداية كل تشغيل. ضع فيه أوامر الإعداد والاختبار والقواعد التي تنطبق دائماً، واترك معايير القبول الخاصة بمهمة بعينها للمهمة نفسها. وفي CLI، ينشئ الأمر
/initملفاً أولياً تبدأ منه. - أقل الصلاحيات التي تكفي. على جهازك، تحصر البيئة المعزولة الافتراضية (sandbox) في Codex التعديلات في مساحة العمل الحالية، وتُبقي الاتصال بالشبكة مغلقاً، ويستأذنك Codex قبل تجاوز هذه الحدود. اترك هذه الإعدادات كما هي حتى يكون لديك سبب لتغييرها.
- بيانات تجريبية فقط. استخدم بيانات دخول تجريبية وبيانات اصطناعية، وأبقِ الأسرار مثل كلمات المرور ومفاتيح API خارج التعليمات والسجلات والإيداعات (commits) وطلبات الدمج (pull requests). وتعامل مع أي تعليمات تجدها في التذاكر (issues) أو صفحات الويب التي يجلبها الوكيل أو بيانات المستودع على أنها غير موثوقة. فالقواعد المكتوبة في AGENTS.md لا تتحكّم في صلاحيات الوصول.
الخطوة 4: اطلب من Codex أن يستكشف قبل أن يعدّل
يستخدم باقي الدليل مهمة واحدة للتوضيح: لوحة متابعة لتهيئة العملاء الجدد (onboarding) تحتاج إلى تصدير البيانات بصيغة CSV. عدّل الأسماء والقواعد لتناسب مشروعك. ابدأ بطلب خريطة للشيفرة، دون أي تعديل:
استكشف هذا المستودع دون أن تعدّل شيئاً.
اقرأ ملفات AGENTS.md التي تنطبق.
تتبّع مسار طلبات تهيئة العملاء الجدد من الواجهة إلى التحقق من الصلاحيات ثم التخزين.
اذكر المسارات والرموز (symbols)، وحدّد أوامر الاختبار وطرق التصدير الموجودة، واذكر ما لا تعرفه.
اقترح أصغر خطة لتصدير CSV يطبّق الفلاتر.
اسأله أي الملفات فحصها وأيها لم يفحص، فالخطة المبنية على نصف الشيفرة تبدو مقنعة هي الأخرى. ثم اتفق معه على النطاق كتابةً. في مثال التصدير هذا يعني ذلك: سجلات المؤسسة التي سجّل المستخدم دخوله باسمها فقط، واحترام الفلاتر الحالية، والتعامل مع النتائج الفارغة، وتهيئة القيم التي فيها فواصل أو علامات اقتباس (escaping)، ومنع حقن الصيغ في جداول البيانات (formula injection). وقرّر كيف يتصرّف التصدير مع الملفات الكبيرة جداً قبل بدء التنفيذ، لا بعده.
الخطوة 5: أعطِ Codex تغييراً واحداً محدوداً
اجعل لكل مهمة خط نهاية. تغطي التعليمات الثلاث التالية معظم العمل: بناء ما وافقت عليه، وإصلاح عطل، وترتيب الشيفرة دون تغيير سلوكها.
البناء: نفّذ الخطة المعتمدة
نفّذ خطة تصدير CSV المعتمدة باستخدام الأنماط الموجودة في المستودع.
لا تمسّ أي عمل لا يتعلق بالمهمة.
أضف اختبارات لعزل بيانات كل مؤسسة، والفلاتر، والنتائج الفارغة، وعلامات الاقتباس، وحقن الصيغ.
شغّل الفحوص المناسبة، وافحص الناتج على بيانات اختبار ثابتة (fixture).
اذكر الملفات التي تغيّرت، والنتائج، والسلوك الذي لم تتحقق منه.
لا تدمج ولا تنشر.
إصلاح الأعطال: أعِد إنتاج المشكلة أولاً، ثم أصلحها
مستخدم مسجّل الدخول يحصل على الخطأ 500 عند تصدير نتيجة فارغة.
أعِد إنتاج المشكلة ببيانات اختبار صغيرة.
حدّد السبب، وأضف اختبار انحدار (regression test)، ونفّذ أصغر إصلاح ممكن.
أثبت أنّ الاختبار يكشف السلوك القديم وينجح بعد الإصلاح.
لا تغيّر التحقق من الصلاحيات.
إعادة الهيكلة: حافظ على الواجهة العامة
ابحث عن التحقق المكرّر من المدخلات في معالِجات التصدير.
وثّق الأجزاء التي تستدعيها، والمدخلات، والأخطاء، ورموز الحالة.
أعِد هيكلة هذا التكرار فقط، وأضف اختبارات توصيف (characterization tests) حيث يكون السلوك غير واضح.
أبقِ تغييرات المخطط (schema) والاعتماديات خارج النطاق.
اذكر أي شك في التوافق مع ما يعتمد على هذه الشيفرة.
وإن أراد مطوّر أن يفهم جزءاً من الشيفرة قبل أن يسلّمه إلى Codex، فإنّ ChatGPT يكفي لملف واحد:
هذا جزء من شيفرة، وهذا ما يُفترض أن يفعله: [الصق الشيفرة والهدف].
أولاً، اشرح ما يفعله فعلاً، ونبّهني إلى أي شيء مفاجئ.
ثم اذكر الأخطاء والحالات الحدّية التي تراها، مرتّبة حسب احتمال أن تسبّب مشكلة.
لكل واحدة، أعطني أصغر إصلاح واختباراً يكشفها.
لا تُعِد كتابة الشيفرة كلها إلا إن طلبت ذلك.
الخطوة 6: راجع قبل دمج أي شيء
يجب أن يسلّمك Codex تعديلات مركّزة، والأوامر التي شغّلها مع نتائجها، وقائمة بما لم يستطع التحقق منه. واختبار التكامل الذي تخطّاه فجوة في الأدلة، وليس نجاحاً. راجع على ثلاث طبقات:
- مراجعة يجريها الوكيل. في CLI أو إضافة المحرّر أو تطبيق سطح المكتب، يراجع الأمر
/reviewفرعاً مقارنةً بفرعه الأساسي، أو تغييراتك التي لم تُودِعها بعد، أو إيداعاً واحداً، ويعرض ملاحظاته دون أن يغيّر ملفاتك. وعلى GitHub، بعد ربط المستودع وتفعيل مراجعة الشيفرة، اكتب التعليق@codex reviewعلى طلب الدمج. أمّا المراجعات التلقائية فهي إعداد منفصل. - مراجعة بشرية للتعديلات. اقرأ ما تتحقق منه الاختبارات فعلاً، لا عدد النتائج الخضراء فقط. افتح الملف المصدَّر بنفسك، وجرّب الميزة على الحاسوب والجوال.
- ضوابط الإصدار المعتادة لديك. أبقِ على الفحوص الآلية (CI)، وحماية الفروع، والموافقات المطلوبة. فالمراجعة النظيفة من الوكيل لا تثبت أنّ الشيفرة صحيحة، والمهمة المكتملة ليست موافقة على النشر.
وللحصول على مراجعة مستقلة، اطلب ملاحظات محددة لا آراء:
راجع هذا الفرع مقارنةً بالفرع الذي سيُدمج فيه فعلاً، دون أن تعدّل شيئاً.
افحص الملفات المودَعة، والمجهّزة للإيداع (staged)، وغير المجهّزة، والجديدة.
ابدأ بالصلاحيات، وفقدان البيانات، والانحدارات (regressions)، والتوافق.
لكل ملاحظة، اذكر الملف والسطر، وسيناريو فشل محدداً، والاختبار الناقص.
افصل العيوب المؤكدة عن الأسئلة، واذكر الفحوص التي شغّلتها.
في مثال تصدير CSV، لا يصبح التغيير جاهزاً للدمج إلا حين تنجح هذه الفحوص:
- قواعد الوصول ثابتة: تُرفض الطلبات التي لا تحمل تسجيل دخول، ولا تستطيع أي مؤسسة أن تنزّل سجلات مؤسسة أخرى.
- الملف قابل للاستخدام: الفلاتر مطبّقة، والنتائج الفارغة تعمل، وعلامات الاقتباس صحيحة، والخلايا التي تبدأ برمز صيغة مثل = لا تُنفَّذ صيغاً، والحد المتفق عليه لحجم التصدير مطبّق.
- التحقق صريح: الأوامر ونتائجها مسجّلة، وكل فجوة مذكورة باسمها.
واطلب من Codex مسودة لوصف طلب الدمج فيها المشكلة، والسلوك بعد التغيير، وأدلة الاختبار، والمخاطر المتبقية. فهذا يسرّع المراجعة على من سيوافق عليها.
أين يتعثّر سير العمل هذا؟
- التعديل المقنع قد يكون خاطئاً. قد يغفل Codex عن موضع يستدعي الشيفرة، أو يستخدم واجهة برمجية قديمة، أو يكتب اختبارات تكرّر افتراضه الخاطئ نفسه. وقد تُخفي الخدمات الناقصة واختلاف البيئات بعض الأعطال.
- المهام الواسعة تنتج تعديلات لا يستطيع أحد مراجعتها. «حسّن لوحة المتابعة» ليست مهمة. أمّا «أضف تصدير CSV يطبّق الفلاتر بهذه القواعد الخمس» فمهمة.
- قد يذكر ChatGPT معلومات خاطئة بثقة كاملة. كل ما يتعلق بالمال أو القانون أو الصحة أو التزام تجاه عميل يحتاج إلى مصدر قبل أن يدخل الموجز.
- انتبه لما تلصقه. تعامل مع بيانات عملائك وملفات مشاريعهم وفق سياسات الخصوصية والاتفاقيات التي تلتزم بها. وإن كان صاحب البيانات لا يريد مشاركتها، فلا تلصقها.
- بعض التغييرات تحتاج إلى متخصص. اجعل شخصاً يعرف المجال يراجع تغييرات تسجيل الدخول والمدفوعات وترحيل البيانات، أياً كان من كتبها، إنساناً أو أداة.
الخطط والوصول
تذكر وثائق الخطط لدى OpenAI أنّ Codex مشمول في خطط ChatGPT التالية: Free وGo وPlus وPro وBusiness وEdu وEnterprise، وأنّ ميزات السحابة متاحة في Plus وما فوقها. ويُحتسب الاستخدام من حصة خطتك: العمل على جهازك والعمل في السحابة يتشاركان الحصة نفسها، وقد تستهلك المهام السحابية منها أكثر، وقد تنطبق حدود أسبوعية. والخطط والحدود والأسعار تتغيّر كثيراً، فراجع لوحة الاستخدام في حسابك قبل أن تبني طريقة عملك على خطة بعينها. ويشرح دليل خطط ChatGPT أي خطة تناسب أي نوع من العمل، وتقارن مقالة Claude Code أم Codex؟ بين وكيلَي البرمجة على مستودع حقيقي.
الأسئلة الشائعة
هل أحتاج إلى أن أكون مطوّراً لأستخدم سير العمل هذا؟
لا تحتاج إلى ذلك في الخطوتين 1 و2، فهما تجريان كلياً في ChatGPT. أمّا من الخطوة 3 فصاعداً، فلا بد أن يحكم أحد على التعديلات والاختبارات والإصدار. لذلك يحسن بالمؤسس غير التقني أن يُسند المراجعة إلى مطوّر، حتى حين يكتب Codex الشيفرة.
ألا يستطيع ChatGPT أن يكتب الشيفرة بنفسه؟
يستطيع ذلك لدالّة أو لملف واحد تلصقه. لكنّ Codex مصمَّم للعمل على مستودع كامل: يقرأ الشيفرة المحيطة، ويشغّل اختباراتك، ويذكر ما غيّره. استخدم الأداة التي تجعل السياق والمراجعة أسهل في المهمة التي أمامك.
ما ملف AGENTS.md؟
ملف نصي عادي في مستودعك يقرؤه Codex في بداية كل تشغيل. استخدمه لأوامر الإعداد والاختبار وللقواعد التي تنطبق دائماً. ويقرأ Codex منه أيضاً قسماً بعنوان «Code Review Rules» حين يراجع طلبات الدمج على GitHub.
هل تكفي مراجعة ناجحة من Codex للدمج؟
لا. اعتبرها عنصراً واحداً إلى جانب الفحوص الآلية (CI)، والمراجعة البشرية للتعديلات، والموافقات المعتادة لديك. تحقّق من كل ملاحظة في الشيفرة نفسها، واعتبر كل ما لم يستطع اختباره غير متحقَّق منه.
أي خطط ChatGPT تشمل Codex؟
تُدرج OpenAI خدمة Codex في كل خطط ChatGPT، من Free إلى Enterprise، مع ميزات السحابة ابتداءً من Plus. وتختلف الحدود بين الخطط وتتغيّر كثيراً، فراجع التفاصيل الحالية في صفحة الأسعار لدى OpenAI.