التخطي إلى المحتوى
AIupick

دليل الفئة: المطورون · عدد المهام: 18

الذكاء الاصطناعي للمطورين: وكلاء البرمجة والتكاليف وتسليم المهام بأمان

إذا كنت تستخدم بالفعل الإكمال التلقائي والدردشة، فالخطوة التالية هي الوكلاء الذين يقرؤون المستودع وينفذون الأوامر ويفتحون طلبات الدمج (pull requests). وتوفير الوقت هنا يعتمد على طريقة الإعداد أكثر مما يعتمد على النموذج. الجزء الأول يصلح لأي وكيل برمجة؛ أما جزءا Claude Code وCodex فيتناولان أوامر كل منهما وملفاته وإعداداته، استنادًا إلى وثائقهما الرسمية.

  1. أي وكيل برمجة

    01

    أعط الوكيل مهمة يستطيع إثبات أنه أنجزها

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

    مثال

    «أصلح محلل التواريخ لتواريخ أسابيع ISO. تعتبر المهمة منجزة عندما ينجح npm test -- dates، بما في ذلك الاختبار الجديد لـ 2026-W01. لا تغير الاختبارات.» يشغّل الوكيل الاختبار حتى ينجح ويلصق المخرجات؛ وتراجع أنت تغييرات (diff) من 30 سطرًا بدل تخمين.

    طريقة التنفيذ

    1. 1قبل أن تسلمه المهمة، اكتب الفحص أو أشر إليه: الاختبار الفاشل، أو الأمر ومخرجاته المتوقعة.
    2. 2أعطه المهمة بالموجه المعروض في هذه الصفحة، مع الملفات التي يجوز له تغييرها والتي لا يجوز.
    3. 3دعه يشغّل الفحص بنفسه ويلصق المخرجات النهائية.
    4. 4راجع التغييرات (diff) كما تراجع طلب دمج (pull request) من زميل؛ نجاح الفحص يبدأ المراجعة ولا ينهيها.

    مدمج

    موجه للنسخ

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

    مواضع الخطأ

    • يجعل الوكلاء الاختبار ينجح أحيانًا بإضعافه. امنع تغيير الاختبارات، وابحث عن ذلك في التغييرات (diff).
    • المهمة الأكبر من أن يغطيها فحص واحد أكبر من أن تسلمها دفعة واحدة. قسّمها.
  2. 02

    شغّل المهام في السحابة بينما تعمل على شيء آخر

    يعمل الوكلاء السحابيون على مستودعك في بيئتهم الخاصة ويعودون بتغييرات لتراجعها، فتجري عدة مهام بينما تفعل شيئًا آخر. لكن هذا لا يفيد إلا مع المهام المحددة جيدًا؛ أما المهام المبهمة فتعود بتغييرات كبيرة عليك تفكيكها.

    مثال

    ثلاث مهام صغيرة قبل الغداء: ترقية إحدى التبعيات، وإضافة فهرس ناقص في قاعدة البيانات، وإصلاح اختبار متقلب. تذهب كل منها إلى وكيل سحابي مع فحصها الخاص، وبعد الظهر تراجع ثلاثة طلبات دمج بدل أن تنتقل بين ثلاثة سياقات.

    طريقة التنفيذ

    1. 1اختر الأقرب إلى مكان كودك: Codex Cloud، أو وكيل Copilot السحابي على GitHub، أو Claude Code على الويب.
    2. 2تأكد أن بيئته تستطيع تثبيت تبعياتك وتشغيل اختباراتك؛ فبدونها يعمل الوكيل بالتخمين.
    3. 3أرسل مهام صغيرة ومستقلة، لكل منها فحصها الخاص، كما في المهمة السابقة.
    4. 4دع أداة مراجعة آلية تقرأ كل طلب دمج أولًا، ثم راجعه بنفسك.

    مدمج

    موجه للنسخ

    في هذا المستودع: [المهمة].
    السياق: [مكانها في الكود، والمشكلة (issue) المرتبطة].
    تعتبر منجزة عندما: ينجح [الاختبار أو الأمر] في بيئتك؛ ضع مخرجاته في وصف طلب الدمج.
    اجعل طلب الدمج أقل من [عدد] سطرًا متغيرًا. إذا احتاج إلى أكثر، فتوقف واقترح طريقة لتقسيمه.

    مواضع الخطأ

    • الاختبارات التي تحتاج إلى بيانات سرية أو خدمات لم تجهزها يتم تخطيها أو تفشل. والتشغيل الناجح بدونها لا يثبت الكثير.
    • عدة وكلاء يعملون على كود مترابط ينتجون طلبات دمج متعارضة. اجعل المهام المتوازية في أجزاء منفصلة من الكود.
  3. 03

    اجعل الفحوص تعمل دونك

    لا تضيع وقت المراجعة على ما يمكن للآلة فحصه. تشغل الخطافات (hooks) أداة التنسيق وأداة الفحص (linter) والاختبارات بعد كل تغيير يجريه الوكيل، ويقرأ روبوت مراجعة كل طلب دمج قبلك. فتصبح مراجعتك عن التصميم، لا عن الأخطاء المطبعية.

    مثال

    يشغل خطاف (hook) أداة التنسيق واختبارات الوحدات بعد كل تعديل. يكسر تغيير الوكيل اختبارين؛ فيرى الفشل في مخرجات الخطاف ويصلحه قبل أن تنظر. ثم ينبه روبوت المراجعة إلى حالة خطأ واحدة غير معالجة، وهذه تقرر فيها أنت.

    طريقة التنفيذ

    1. 1ضع أوامر البناء والاختبار والفحص (lint) في ملف التعليمات الذي يقرؤه وكيلك في بداية كل جلسة؛ وتذكر وثائق كل وكيل اسم هذا الملف.
    2. 2في Claude Code، أضف خطافات (hooks) تشغل أداة التنسيق والاختبارات بعد كل تعديل، ليرى الوكيل حالات الفشل ويصلحها.
    3. 3اجعل روبوتًا يراجع كل طلب دمج: فعّل «Automatic review» في Codex، أو اطلب Copilot كمراجع.
    4. 4عندما يكرر الوكيل خطأ مرتين، حوّله إلى اختبار أو قاعدة في ملف التعليمات.

    مدمج

    موجه للنسخ

    اقرأ هذا المستودع واكتب ملف التعليمات لوكلاء البرمجة:
    1. الأوامر الدقيقة للتثبيت والبناء والاختبار والفحص (lint) والتنسيق.
    2. بنية المشروع في 10 أسطر أو أقل.
    3. الأعراف التي يخطئ فيها القادمون الجدد هنا، مع مثال واحد لكل منها.
    4. ما يجب ألا يفعله أي وكيل هنا أبدًا، مثل تغيير ملفات الترحيل (migrations) أو تعديل الملفات المولدة.
    لا تذكر إلا الأوامر التي شغلتها بنجاح؛ وضع على البقية علامة «غير متحقق منه».

    مواضع الخطأ

    • ملف التعليمات الذي يحتوي على أوامر لم تعد تعمل يعلّم الوكيل أن يتجاهله. أعد تشغيلها عندما يتغير الإعداد.
    • روبوتات المراجعة أيضًا تخطئ بثقة. تعامل مع تعليقاتها كاقتراحات.
  4. 04

    اربط الوكيل بأدواتك بأقل قدر من الصلاحيات

    الوكيل لا يكون أفضل مما يستطيع رؤيته: المشكلات (issues)، والوثائق، والسجلات، ومخطط قاعدة البيانات. يربط MCP هذه كلها، لكن كل اتصال يعني صلاحية وصول، والنص الذي يقرؤه من الخارج قد يحمل تعليمات. ابدأ بصلاحية القراءة فقط، ولا توسعها إلا عندما تحتاجها مهمة.

    مثال

    يقرأ الوكيل المشكلة 482 من نظام التتبع، ويجد تتبع المكدس (stack trace) في السجلات، ويراجع وثائق المكتبة، ثم يحدد الملف المسؤول عن الخطأ، وكل ذلك عبر رموز وصول (tokens) للقراءة فقط. أما الإصلاح فيكتبه في مستودعك، حيث تراجعه كالمعتاد.

    طريقة التنفيذ

    1. 1اكتب قائمة بما تلصقه في المحادثات أكثر من غيره، مثل المشكلات (issues) أو سجلات الأخطاء أو الوثائق أو المخطط. واربط هذه أولًا.
    2. 2أضف خادم MCP الرسمي لكل منها، برمز وصول (token) يسمح بالقراءة فقط. في Gemini CLI، يمكن لإضافة (extension) أن تجمع خادم MCP وإعداده معًا.
    3. 3أعطه مهمة تحتاج إليها وتحقق من أنه استدعى الخادم الصحيح.
    4. 4كل بضعة أسابيع، احذف الخوادم التي لم تعد تستخدمها.

    مدمج

    موجه للنسخ

    قبل أن تغير أي شيء: اقرأ المشكلة (issue) [رقمها] في نظام التتبع، وابحث عن الخطأ في السجلات، وراجع وثائق [المكتبة].
    اذكر ما أخبرك به كل منها، وأي ملف تظن أنه سبب الخطأ.
    لا تكتب في أي أداة متصلة.

    مواضع الخطأ

    • قد تحتوي صفحة ويب أو مشكلة (issue) أو مستند على نص مكتوب لتوجيه الوكيل. لا تمنح صلاحية الكتابة لأدوات تقرأ محتوى من الخارج.
    • رموز الوصول (tokens) في ملفات الإعداد تتسرب. استخدم مخزن الأسرار في العميل أو متغيرات البيئة، ولا تضعها أبدًا في المستودع.
  5. 05

    اختر بين الاشتراك والدفع لكل رمز (token)

    جلسات الوكلاء تقرأ الملفات وتنفذ خطوات كثيرة، لذلك تستهلك رموزًا أكثر بكثير من الدردشة. احسب تكلفة أسبوع نموذجي من استخدامك قبل أن تختار: الاشتراك يضع حدًا للاستخدام المباشر، أما الدفع لكل رمز فيتيح لك وضع حد لكل تشغيل آلي.

    مثال

    أسبوع من الاستخدام اليومي للوكيل يصل إلى نحو 40 مليون رمز إدخال و3 ملايين رمز إخراج. احسب تكلفتها في صفحة أسعار API بسعر النموذج الذي تستخدمه، وقارنها بشهر من الاشتراك. إذا كان الاشتراك أقل وحدوده تناسب أسبوعك، فاختره، واحتفظ بمفتاح API محدود الإنفاق لـ CI.

    طريقة التنفيذ

    1. 1تحقق مما تدفع مقابله بالفعل: خطط ChatGPT تشمل Codex، وخطط Claude المدفوعة تشمل Claude Code.
    2. 2سجّل استهلاك الرموز في بضع جلسات نموذجية، حيث يعرضه وكيلك.
    3. 3احسب تكلفة هذا الاستخدام في صفحة أسعار API لدينا وقارنها بالاشتراك.
    4. 4للأتمتة وCI، استخدم مفاتيح API بحد للإنفاق حتى لا تتسبب حلقة متكررة في فاتورة ضخمة.

    مدمج

    موجه للنسخ

    هذا استخدامي في [عدد] جلسات نموذجية: [الرموز الداخلة والخارجة]. أعمل نحو [عدد الأيام] أيام في الأسبوع.
    قدّر تكلفتي الشهرية بالدفع لكل رمز بهذه الأسعار: [الصقها من صفحة أسعار API].
    قارنها باشتراك سعره [السعر] شهريًا. اعرض الحساب خطوة بخطوة لأتمكن من التحقق منه.

    مواضع الخطأ

    • للاشتراكات أيضًا حدود استخدام. الوصول إلى أحدها في منتصف المهمة يكلفك وقتًا؛ فتحقق من الحد، لا من السعر فقط.
    • النموذج يغير الفاتورة أكثر من أي شيء آخر. قارن بسعر النموذج الذي تستخدمه فعلًا.
  6. Claude Code

    06

    امنح كل جلسة البداية نفسها باستخدام CLAUDE.md

    إذا كنت تشرح أوامر البناء والأعراف في بداية كل جلسة، فأنت تقوم بالمهمة التي يؤديها CLAUDE.md. يقرؤه Claude في بداية كل جلسة؛ اجعله قصيرًا وصحيحًا، فتتوقف الأخطاء نفسها عن التكرار.

    مثال

    مستودع ظل فيه Claude يشغل npm test بدل أمر المشروع pnpm test:unit، ويعدل الملفات المولدة. سطران في CLAUDE.md، الأمر الصحيح و«لا تعدل src/gen/ أبدًا»، فيتوقف الخطآن كلاهما.

    طريقة التنفيذ

    1. 1شغّل /init في المستودع: يحلل قاعدة الكود ويكتب ملف CLAUDE.md أوليًا، أو يقترح تحسينات على الملف الموجود لديك.
    2. 2ضع قواعد الفريق، مثل أوامر البناء والاختبار ومعايير كتابة الكود، في ./CLAUDE.md وأودعه في المستودع (commit). أما تفضيلاتك الشخصية فمكانها ~/.claude/CLAUDE.md لكل المشاريع، أو CLAUDE.local.md لهذا المشروع وحده.
    3. 3أشر إلى المستندات الأطول بدل لصقها: @path/to/file يستورد ملفًا آخر عند بدء التشغيل.
    4. 4في كل مرة يخطئ فيها Claude في الشيء نفسه مرتين، أضف السطر الواحد الذي كان سيمنع ذلك.

    موجه للنسخ

    اقرأ هذا المستودع وحسّن CLAUDE.md. اجعله أقل من 60 سطرًا:
    1. الأوامر الدقيقة للبناء والاختبار والفحص (lint).
    2. البنية في بضعة أسطر.
    3. الأعراف التي يخطئ فيها القادم الجديد هنا.
    4. الملفات والمجلدات التي يجب ألا يعدلها أحد أبدًا.
    احذف كل ما لم يعد صحيحًا. ضع على الأوامر التي لم تشغلها علامة «غير متحقق منه».

    مواضع الخطأ

    • كل ما في CLAUDE.md يتم تحميله في كل جلسة ويشغل مساحة من السياق. انقل التفاصيل إلى ملفات يستوردها.
    • التعليمات التي لم تعد صحيحة أسوأ من عدم وجود تعليمات. تحقق من الأوامر مجددًا عندما يتغير الإعداد.

    من الوثائق الرسمية: Claude Code docs: How Claude remembers your project

  7. 07

    خطط أولًا، ثم دعه يعدل

    في تغيير يمتد عبر ملفات كثيرة، الخطأ المكلف هو النهج الخاطئ، لا السطر الخاطئ. في وضع التخطيط (plan mode) يبحث Claude ويكتب خطة دون تعديل ملفات الكود المصدري؛ فتصحح الخطة ثم توافق عليها.

    مثال

    نقل المصادقة من ملفات تعريف الارتباط (cookies) إلى الرموز المميزة (tokens) عبر 14 ملفًا. تنسى الخطة الأولى تطبيق الهاتف المحمول؛ فتنبه إلى ذلك، فتضاف إلى الخطة خطوة، وعندها فقط يعدل Claude شيئًا.

    طريقة التنفيذ

    1. 1اضغط Shift+Tab حتى يعرض شريط الحالة «plan mode on»، أو ابدأ موجهك بـ /plan.
    2. 2صف التغيير وما يجب ألا يتغير. قد يظل Claude يشغل أوامر للاستكشاف، لكنه لا يعدل الملفات أثناء التخطيط.
    3. 3اقرأ الخطة كما تقرأ مذكرة تصميم: ملف خاطئ، حالة ناقصة، تغيير أكبر من اللازم. اطلب تعديلات حتى تصبح صحيحة، ثم وافق عليها.
    4. 4قبل المهمة التالية غير المرتبطة، ابدأ من جديد بـ /clear.

    موجه للنسخ

    /plan غيّر [ماذا] بحيث [الهدف]. القيود: [ما يجب ألا يتغير].
    اذكر الملفات التي ستلمسها، وترتيب التغييرات، والاختبار الذي يثبت كل خطوة، وكل ما لست متأكدًا منه. لا تعدل أي شيء حتى أوافق.

    مواضع الخطأ

    • الخطة التي تلمس ملفات أكثر مما توقعت هي علامة التحذير. اسأل عن السبب قبل أن توافق.
    • وضع التخطيط يظل يشغل أوامر للاستكشاف. فهو لا يجعل تشغيل مستودع لا تعرفه آمنًا.

    من الوثائق الرسمية: Claude Code docs: Choose a permission mode · Claude Code docs: Commands · Claude Code docs: Best practices

  8. 08

    توقف عن الموافقة على الأمر نفسه خمسين مرة

    الموافقة يدويًا على كل تشغيل للاختبارات تجعلك تعتاد النقر على «Yes» دون قراءة. اسمح بالأوامر الآمنة المتكررة مرة واحدة في إعدادات المشروع، وامنع الأوامر الخطرة، وأبق طلبات الإذن لكل ما عدا ذلك.

    مثال

    يسمح فريق بأوامر الاختبار والفحص (lint) ويمنع قراءة ملفات .env في إعدادات المشروع المشتركة. فتنخفض طلبات الإذن إلى الأوامر القليلة التي تستحق القراءة، ولا تستطيع جلسة أي شخص فتح المفاتيح.

    طريقة التنفيذ

    1. 1افتح /permissions لترى كل قاعدة وملف الإعدادات الذي جاءت منه.
    2. 2ضع قواعد الفريق في .claude/settings.json وأودعه في المستودع (commit). أما القواعد الشخصية فمكانها ~/.claude/settings.json أو .claude/settings.local.json.
    3. 3يفحص Claude Code القواعد بهذا الترتيب: deny أولًا، ثم ask، ثم allow، لذا فإن قاعدة deny واحدة تتغلب على أي allow.
    4. 4بدّل الأوضاع بـ Shift+Tab: يوافق acceptEdits على تعديلات الملفات في مجلد العمل. ويوقف bypassPermissions طلبات الإذن وفحوص الأمان؛ وتقول الوثائق ألا تستخدمه إلا في حاويات معزولة أو أجهزة افتراضية (VMs) بلا اتصال بالإنترنت.

    موجه للنسخ

    انظر إلى الأوامر التي شغلتها في هذه الجلسة. اقترح قواعد صلاحيات لملف .claude/settings.json: اسمح بأوامر القراءة فقط وأوامر الاختبار التي نستخدمها كل يوم، وامنع كل ما يقرأ الأسرار أو يحذف خارج المشروع، واترك كل ما عدا ذلك ليطلب الإذن. اشرح كل قاعدة في سطر واحد.

    مواضع الخطأ

    • قاعدة allow تطابق أي أمر تساوي إلغاء طلبات الإذن. اسمح بأوامر محددة بدقة.
    • القواعد في .claude/settings.json تسري على الفريق كله بمجرد إيداعها في المستودع. راجعها كما تراجع الكود.

    من الوثائق الرسمية: Claude Code docs: Configure permissions · Claude Code docs: Settings files and precedence · Claude Code docs: Choose a permission mode

  9. 09

    اجعل كل جلسة مركزة

    الجلسة التي حملت ثلاث مهام غير مترابطة تظل المهام الثلاث كلها في سياقها، ويظهر ذلك في عملها. امسح السياق بين المهام، واضغط المهام الطويلة مع تحديد ما تركز عليه، ودع الوكلاء الفرعيين (subagents) يجرون عمليات البحث الواسعة في سياقهم الخاص.

    مثال

    بعد إصلاح خلل، تطلب إعادة هيكلة في الجلسة نفسها فيظل يتبع الحل الالتفافي القديم لذلك الخلل. مع /clear وجملة واحدة من السياق، يتوقف عن ذلك.

    طريقة التنفيذ

    1. 1بين المهام غير المترابطة، يبدأ /clear محادثة جديدة بسياق فارغ.
    2. 2في المهمة الطويلة، يلخص /compact مع تحديد التركيز ما سبق، مثل «/compact احتفظ بالخطة والاختبار الفاشل».
    3. 3أوكل عمليات البحث الواسعة إلى وكيل فرعي (subagent): يعمل كل منها في نافذة السياق الخاصة به، فلا يعود إلى جلستك إلا جوابه.
    4. 4يضغط Claude Code السياق تلقائيًا أيضًا عند الاقتراب من الحد؛ لكن الضغط بنفسك في لحظة مناسبة يحتفظ بما تختاره أنت.

    مدمج

    موجه للنسخ

    /compact احتفظ بـ: الهدف، والخطة، والملفات التي تغيرت حتى الآن، والاختبار الذي لا يزال يفشل. أسقط الاستكشاف.

    مواضع الخطأ

    • ينسى /clear المحادثة. كل ما ستحتاجه مرة أخرى ضعه في CLAUDE.md قبل ذلك.
    • جواب الوكيل الفرعي هو كل ما يعود إليك. اطلب منه مسارات الملفات وأرقام الأسطر، لا الاستنتاجات فقط.

    من الوثائق الرسمية: Claude Code docs: Commands · Claude Code docs: Best practices · Claude Code docs: Create custom subagents

  10. 10

    شغّل مهمتين في وقت واحد دون تصادم

    جلستان في نسخة عمل (checkout) واحدة تعدلان الملفات نفسها فتفسد كل منهما عمل الأخرى. يمنح claude --worktree كل جلسة نسختها الخاصة على فرعها الخاص، فيمكن لإعادة هيكلة وإصلاح خلل أن يجريا جنبًا إلى جنب.

    مثال

    ترقية تبعية في worktree وإصلاح في الواجهة في worktree آخر، وكلاهما يعمل بينما تراجع طلب دمج ثالثًا. لا ترى أي جلسة الملفات نصف المنجزة في الأخرى.

    طريقة التنفيذ

    1. 1ابدأ كل جلسة بـ claude --worktree <name> (أو -w). ينشئ ذلك git worktree في .claude/worktrees/<name>/ على الفرع worktree-<name>.
    2. 2أضف .claude/worktrees/ إلى .gitignore، كما توصي الوثائق.
    3. 3أعط كل جلسة مهمة واحدة لها فحصها الخاص، لتراجعها واحدة تلو الأخرى.
    4. 4راجع كل فرع وادمجه مثل أي طلب دمج آخر.

    موجه للنسخ

    أنت تعمل في worktree على الفرع worktree-[الاسم]. المهمة: [تغيير واحد]. تعتبر منجزة عندما: ينجح [الاختبار أو الأمر]. أنشئ commits على هذا الفرع فقط؛ لا تدمج فروعًا أخرى ولا تنفذ عليها rebase.

    مواضع الخطأ

    • كل worktree مجلد مستقل، فلا تشترك في التبعيات ولا في مخرجات البناء. ثبّت التبعيات في كل منها.
    • المهمتان اللتان تلمسان الملفات نفسها تتعارضان عند الدمج، سواء استخدمت worktree أم لا.

    من الوثائق الرسمية: Claude Code docs: Run parallel sessions with worktrees

  11. 11

    تراجع عن مسار خاطئ باستخدام rewind

    عندما تسوء الجلسة، فإن طلبك من Claude التراجع عن تغييراته كثيرًا ما يضيف فوضى ثانية. تعيد ميزة rewind المحادثة أو الكود أو كليهما إلى نقطة قبل الخطأ. لكنها لا تستطيع التراجع عما فعلته أوامر shell، لذا أنشئ commit قبل الخطوات الخطرة.

    مثال

    إعادة هيكلة اتجهت في الاتجاه الخطأ قبل ثلاثة موجهات. الرجوع إلى ما قبلها يستعيد الملفات والمحادثة، فتعيد صياغة طلبك بدل أن تجادل لاستعادة الكود.

    طريقة التنفيذ

    1. 1اضغط Esc مرتين وحقل الإدخال فارغ، أو اكتب /rewind (يعمل أيضًا /checkpoint و/undo).
    2. 2اختر النقطة التي تسبق الخطأ واستعد المحادثة أو الكود أو كليهما.
    3. 3اعرف الحدود: الملفات التي غيرتها أوامر shell مثل rm أو mv أو cp لا يستعيدها rewind، ولا يستعيد التعديلات التي أجريتها خارج Claude Code أو في جلسة أخرى.
    4. 4أنشئ commit قبل الخطوات الخطرة. نقاط الاستعادة (checkpoints) للاسترجاع السريع داخل الجلسة، وليست بديلًا عن git.

    موجه للنسخ

    قبل أن تبدأ، أنشئ commit للحالة الحالية برسالة «نقطة استعادة قبل [المهمة]». ثم [المهمة]. اسألني قبل أي أمر يحذف ملفات أو ينقلها.

    مواضع الخطأ

    • لا تعيد rewind ملفًا حذفه أمر ما. git وحده يستطيع ذلك.
    • التعديلات التي أجريتها يدويًا في الأثناء لا يلتقطها rewind أيضًا. أنشئ لها commit قبل أن تستخدم rewind.

    من الوثائق الرسمية: Claude Code docs: Checkpointing · Claude Code docs: Commands

  12. 12

    شغّله من السكربتات وCI

    يعمل الوكيل نفسه دون دردشة: يأخذ claude -p موجهًا، وينجز العمل، ثم ينتهي برمز حالة يستطيع السكربت فحصه. في CI، يتخطى --bare الخطافات (hooks) والمهارات (skills) وخوادم MCP وCLAUDE.md المحلية لديك، فيتصرف التشغيل بالطريقة نفسها في كل مكان.

    مثال

    مهمة ليلية تشغل claude -p مع «حدّث سجل التغييرات من طلبات الدمج المدمجة اليوم» و--output-format json، وتفشل البناء عندما لا يكون رمز الخروج 0، فتلاحظ أنت التشغيل المعطل صباح اليوم التالي.

    طريقة التنفيذ

    1. 1يعمل claude -p "..." دون تفاعل. ويعطي --output-format json أو stream-json مخرجات يستطيع السكربت تحليلها.
    2. 2ينتهي برمز 0 عند النجاح وبرمز غير 0 عند الفشل، فيستطيع CI أن يتخذ مسارًا بناءً عليه.
    3. 3أضف --bare في CI لعمليات التشغيل التي لا تعتمد على الإعداد المحلي.
    4. 4لطلبات الدمج، يجهز /install-github-app إعداد Claude Code GitHub Actions (لمستودعات github.com فقط)؛ ثم اذكر @claude في تعليق على طلب دمج أو مشكلة (issue).

    موجه للنسخ

    claude -p "اقرأ الفروقات (diff) مقارنة بـ main. اذكر كل تغيير يضيف تبعية، أو يمس المصادقة، أو يغير ترحيلًا لقاعدة البيانات (migration)، بصيغة JSON: {\"files\": [], \"reason\": \"\"}. أعد قائمة فارغة إن لم يوجد شيء." --output-format json

    مواضع الخطأ

    • يعمل السكربت بالصلاحيات التي تمنحها له. امنح CI أقل ما يحتاجه.
    • لا يعمل /install-github-app إلا مع المستودعات على github.com.

    من الوثائق الرسمية: Claude Code docs: Run Claude Code programmatically · Claude Code docs: GitHub Actions

  13. Codex

    13

    AGENTS.md: التعليمات التي تبدأ منها كل مهمة في Codex

    يقرأ Codex ملفات AGENTS.md قبل أن يبدأ أي عمل، من ملفك العام نزولًا إلى المجلد الذي يعمل فيه. اكتب الأوامر والقواعد مرة واحدة، قريبًا من الكود الذي تنطبق عليه، والملف الأقرب هو الذي يسري.

    مثال

    مستودع فيه تطبيق ويب وخدمة مدفوعات. يضم ملف AGENTS.md في الجذر الأوامر المشتركة؛ ويضيف payments/AGENTS.md «لا تغير تقريب العملات أبدًا دون اختبار». العمل في payments/ يتبع الاثنين، والملف الأقرب هو الذي يسري حيث يختلفان.

    طريقة التنفيذ

    1. 1شغّل /init في CLI لكتابة ملف AGENTS.md أولي في المجلد الحالي.
    2. 2ضع إرشاداتك الشخصية في ~/.codex/AGENTS.md وقواعد المشروع في المستودع. يمكن أن يكون لمجلد فرعي ملفه الخاص؛ والملفات الأقرب إلى مكان عمل Codex هي التي تسري.
    3. 3اجعل الملفات قصيرة: لحجمها الإجمالي حد أقصى، وهو 32 KiB افتراضيًا.
    4. 4أضف قسمًا بعنوان «## Code Review Rules»: مراجعات Codex على GitHub تتبعه.

    موجه للنسخ

    اقرأ هذا المستودع واكتب AGENTS.md:
    1. الأوامر الدقيقة للتثبيت والبناء والاختبار والفحص (lint).
    2. البنية في بضعة أسطر.
    3. الأعراف التي يخطئ فيها القادم الجديد هنا.
    4. قسمًا بعنوان «## Code Review Rules» فيه ما يجب أن ينبه إليه المراجع دائمًا.
    لا تذكر إلا الأوامر التي شغلتها بنجاح؛ وضع على البقية علامة «غير متحقق منه».

    مواضع الخطأ

    • الملفات الطويلة تعمل ضدك: الحجم الإجمالي محدود بـ 32 KiB افتراضيًا.
    • ملف المجلد الفرعي الذي يناقض ملف الجذر دون أن يصرح بذلك يربك الناس بقدر ما يربك Codex. اذكر ما الذي يتجاوزه.

    من الوثائق الرسمية: Codex docs: AGENTS.md · Codex docs: CLI commands · Codex docs: GitHub integration

  14. 14

    حدد ما يجوز لـ Codex فعله من تلقاء نفسه

    وضع الصلاحيات هو الذي يحدد ما يفعله Codex دون أن يسأل. يعمل «Ask for approval» داخل مساحة العمل ويتوقف قبل تجاوزها؛ أما «Full access» فيزيل البيئة المعزولة (sandbox) والأسئلة. اختر لكل مهمة على حدة، لا مرة واحدة وإلى الأبد.

    مثال

    قراءة مستودع لا تعرفه في وضع القراءة فقط (read-only)، ثم التبديل إلى «Ask for approval» لإصلاح خلل واحد. يعدل Codex داخل المستودع لكنه يتوقف ليسأل قبل أن يتجاوزه.

    طريقة التنفيذ

    1. 1في CLI، يبدل /permissions الوضع، ويعرض /status سياسة الموافقة السارية والمجلدات القابلة للكتابة.
    2. 2يعدل «Ask for approval»، وهو الإعداد الافتراضي الموصى به، الملفات ويشغل الأوامر داخل مساحة العمل، ويتوقف قبل تجاوزها.
    3. 3يبقي «Approve for me» البيئة المعزولة نفسها، لكنه يرسل طلبات الموافقة إلى المراجعة الآلية بدلًا منك.
    4. 4يزيل «Full access» قيود نظام الملفات والشبكة. وتضيف الوثائق تحذيرًا؛ فاحتفظ به للبيئات التي يمكنك التخلص منها.

    موجه للنسخ

    قبل أن تبدأ، شغّل /status وأخبرني بسياسة الموافقة والمجلدات القابلة للكتابة. ثم [المهمة]. اسأل قبل أي أمر يحتاج إلى الشبكة أو يكتب خارج هذا المستودع.

    مواضع الخطأ

    • مع «Approve for me»، لا يقرأ أي إنسان كل طلب. استخدمه حيث يسهل التراجع عن الإجراء الخاطئ.
    • ينطبق «Full access» على الجهاز كله، لا على المستودع فقط.

    من الوثائق الرسمية: Codex docs: Permission modes · Codex docs: Sandboxing · Codex docs: Approvals and security · Codex docs: CLI commands

  15. 15

    شغّل Codex من السكربتات وCI

    يشغل codex exec مهمة دون دردشة: يذهب التقدم إلى stderr والرسالة النهائية وحدها إلى stdout، فيستطيع السكربت استخدام الجواب. يبدأ بصلاحية القراءة فقط؛ ولا تمنحه صلاحية الكتابة إلا عندما تحتاجها المهمة.

    مثال

    سكربت إصدار يشغل codex exec مع «اكتب ملاحظات الإصدار من الـ commits منذ آخر tag» ويحفظ stdout في RELEASE.md. صلاحية القراءة فقط كافية، لأن السكربت يكتب الملف بنفسه.

    طريقة التنفيذ

    1. 1يعمل codex exec "..." دون تفاعل، وافتراضيًا في بيئة معزولة للقراءة فقط.
    2. 2أضف --sandbox workspace-write عندما يجب أن يعدل الملفات؛ أما --full-auto فقد أصبح مهملًا (deprecated).
    3. 3يخرج --json تدفقًا من الأحداث بصيغة JSON Lines للسكربتات التي تحتاج إلى كل خطوة.
    4. 4في GitHub Actions، يشغل openai/codex-action@v1 الأمر codex exec نيابة عنك.

    موجه للنسخ

    codex exec "اقرأ التغييرات منذ الـ tag [v1.2.0]. اكتب ملاحظات الإصدار مجمعة في ثلاثة أقسام، الإضافات والتغييرات والإصلاحات: سطر واحد لكل تغيير، بكلمات يفهمها المستخدم، دون معرفات الـ commits (hashes)."

    مواضع الخطأ

    • لا تزال الأدلة القديمة تستخدم --full-auto. لقد أصبح مهملًا؛ استخدم --sandbox workspace-write.
    • المهمة التي تقرأ فقط يجب أن تبقى بصلاحية القراءة فقط، في CI أيضًا.

    من الوثائق الرسمية: Codex docs: Non-interactive mode · Codex docs: GitHub Action

  16. 16

    احصل على مراجعة قبل أن تنفذ push

    يراجع Codex شجرة العمل لديك، أو فرعًا، أو طلب دمج. وعلى GitHub لا ينبه إلا إلى أخطر المشكلات، P0 وP1، لذا تستحق تعليقاته القراءة. شغّله قبل push، ودعه يراجع كل طلب دمج.

    مثال

    قبل push لترحيل (migration)، ينبه /review إلى أن العمود الجديد ليس له قيمة افتراضية، فتفشل الصفوف الموجودة. دقيقة واحدة قبل push بدل نشر فاشل.

    طريقة التنفيذ

    1. 1يراجع /review في CLI شجرة العمل لديك. ويفعل codex review الشيء نفسه دون دردشة، مقارنة بفرع أساسي أو commit أو تغييرات لم تودع بعد.
    2. 2على GitHub، اكتب التعليق @codex review على طلب دمج.
    3. 3فعّل المراجعات التلقائية تحت «Personal preferences» في إعدادات Codex؛ فلا تحتاج بعدها إلى أي تعليق.
    4. 4اكتب قواعد فريقك في قسم «## Code Review Rules» من AGENTS.md.

    مدمج

    موجه للنسخ

    ## Code Review Rules
    - نبّه إلى أي تغيير في المصادقة أو الصلاحيات.
    - نبّه إلى ترحيلات قاعدة البيانات (migrations) التي لا طريق للرجوع عنها.
    - نبّه إلى التبعيات الجديدة واذكر ما إذا كانت ضرورية.
    - تجاهل التنسيق؛ أداة الفحص (linter) تتولاه.

    مواضع الخطأ

    • مراجعات GitHub لا تنبه إلا إلى مشكلات P0 وP1. وغياب التعليقات لا يعني أن التصميم صحيح.
    • المراجعة رأي ثان، لا تشغيل للاختبارات. حافظ على الاختبارات.

    من الوثائق الرسمية: Codex docs: CLI commands · Codex docs: GitHub integration

  17. 17

    أوكل المهام إلى Codex Cloud

    يواصل Codex Cloud العمل بينما حاسوبك في وضع السكون، كل مهمة في مساحة عمل خاصة بها تنشأ من بيئة تعدها مرة واحدة. مع بيئة مناسبة يستطيع التثبيت والبناء والاختبار؛ ومن دونها يخمن.

    مثال

    أربع عمليات إعادة هيكلة صغيرة ترسلها بـ codex cloud exec قبل اجتماع، كل منها في مساحة عمل خاصة من البيئة نفسها. لأصعبها طلبت ثلاث محاولات وتحتفظ بأفضلها؛ وبعد ذلك تراجع أربع مجموعات من التغييرات (diffs).

    طريقة التنفيذ

    1. 1أنشئ بيئة فيها المستودعات والتبعيات والأدوات وإعدادات الوصول التي تحتاجها المهام. تسجل البيئات الجديدة سكربت تثبيت ومهارة بدء (start skill).
    2. 2حدد الوصول إلى الإنترنت لكل بيئة: مديرو الحزم فقط، أو نطاقات تختارها، أو كل شيء.
    3. 3ابدأ المهام من ChatGPT، أو من إضافة IDE للمهام الأطول، أو من الطرفية بـ codex cloud exec؛ ويطلب --attempts 1-4 عدة محاولات للمقارنة بينها.
    4. 4لا تزال Code Review وتكاملات GitHub وLinear تعمل على النسخة الأقدم Codex Cloud (Legacy)، التي تخطط OpenAI لإيقافها.

    مدمج

    موجه للنسخ

    codex cloud exec --attempts 3 "المهمة: [التغيير]. السياق: [الملفات]. تعتبر منجزة عندما ينجح [الاختبار] في هذه البيئة. اجعل التغييرات (diff) أقل من [عدد] سطر."

    مواضع الخطأ

    • الوصول غير المقيد إلى الإنترنت يتيح للمهمة بلوغ أي موقع، بما في ذلك صفحات مكتوبة لتوجيهها. لا تسمح إلا بما تحتاجه المهمة.
    • إذا لم يوجد سكربت التثبيت، فربما لم تعمل الاختبارات. تحقق من أن المهمة شغلتها فعلًا.

    من الوثائق الرسمية: Codex docs: Cloud environments · Codex docs: CLI commands · Codex docs: IDE extension

  18. 18

    اضبط Codex مرة واحدة: الإعدادات وملفات التعريف (profiles) وMCP

    إذا كنت تغير النموذج والإعدادات يدويًا في كل جلسة، فضعها في config.toml. يقرأ Codex ملف ~/.codex/config.toml في كل مرة، وإعدادات المشروع في المشاريع الموثوقة، ويبدل ملف التعريف (profile) مجموعة كاملة من الإعدادات دفعة واحدة.

    مثال

    ملف تعريف باسم «deep» بجهد استدلال مرتفع لأسئلة التصميم، والإعداد الافتراضي للإصلاحات السريعة. codex --profile deep قبل سؤال عن البنية المعمارية؛ وcodex وحده لكل ما عدا ذلك.

    طريقة التنفيذ

    1. 1حدد النموذج الافتراضي وجهد الاستدلال في ~/.codex/config.toml (model وmodel_reasoning_effort). يشترك فيه CLI وإضافة IDE.
    2. 2أنشئ ملف التعريف كملف مستقل، ~/.codex/<name>.config.toml، وابدأ بـ --profile <name>.
    3. 3أضف خوادم MCP بـ codex mcp add <name> -- <command>؛ يصبح كل منها جدولًا [mcp_servers.<name>]، ويعرض /mcp الخوادم النشطة.
    4. 4يعرض /status الإعدادات السارية، ويستأنف codex resume --last أحدث جلسة في هذا المجلد.

    موجه للنسخ

    اقرأ ~/.codex/config.toml وملف .codex/config.toml الخاص بهذا المشروع. أخبرني بالنموذج وجهد الاستدلال والبيئة المعزولة (sandbox) وخوادم MCP السارية، ومن أي ملف يأتي كل منها، وأي تعارض بينها.

    مواضع الخطأ

    • لا يحمّل Codex إعدادات المشروع إلا في المشاريع الموثوقة. إذا بدا أنه يتجاهل أحدها، فتحقق من ذلك أولًا.
    • أصبحت ملفات التعريف ملفات مستقلة الآن. الأدلة التي تضع [profiles.name] داخل config.toml قديمة.

    من الوثائق الرسمية: Codex docs: MCP · Codex docs: Config basics · Codex docs: Advanced config · Codex docs: CLI commands

قواعد الفئة: المطورون

  • لا تلصق أبدًا كلمات سر أو مفاتيح أو بيانات عملاء في موجه؛ وأبقها خارج المجلدات المفهرسة.
  • شغّل الوكلاء على فرع مستقل بصلاحيات تطلب الإذن قبل تنفيذ الأوامر؛ وراجع كل التغييرات (diff).
  • شغّل الاختبارات بنفسك قبل دمج ما كتبه الوكيل.
  • ضع حدًا للإنفاق على أي مفتاح API يستخدمه وكيل.

للتعمق أكثر

Esc
↑ ↓ للتنقلEnter للفتح