Skip to content

فحص القبول: كيف تفحص الكود الذي كتبه الذكاء الاصطناعي قبل الإطلاق ​

الجواب أولًا: ** مراجعة كود الذكاء الاصطناعي ليست مضغ الكود سطرًا بسطر، بل السير في قائمة من أربع خطوات — النظر إلى diff، وتشغيل الاختبارات، ومراجعة خطوط الأمان الحمراء، والقدرة على الشرح. ** بعد إتمام هذه الخطوات الأربع، يتحول «يبدو سليمًا» إلى «تم فحصه».

لماذا هذه الخطوة ضرورية؟ أعد النظر إلى ما وصفته تلك التغريدة الشهيرة لكارباتي: «I "Accept All" always, I don't read the diffs anymore» — أنا أقبل كل شيء دائمًا، ولم أعد أقرأ diff. واعترف أيضًا: «The code grows beyond my usual comprehension» — أصبح الكود يتجاوز قدرتي المعتادة على الفهم. وتعريف سايمون ويليسون لـ vibe coding مباشر جدًا أيضًا: «building software with an LLM without reviewing the code it writes» — بناء برمجيات باستخدام LLM دون مراجعة الكود الذي يكتبه.

إذن «المراجعة من عدمها» هي الخط الفاصل بين vibe coding وتطوير البرمجيات الجاد: لعبة صغيرة للتسلية في عطلة الأسبوع، يمكن عدم قراءة diff فيها؛ أما ما سيُطلق، فالمراجعة خيار إلزامي. هذا الدرس هو القاعدة الرابعة التي أرساها دليل سير العمل وهي «القبول قبل الإطلاق» — تشغيل اختبارات ذات نتيجة ناجح/فاشل، والقدرة على شرح ما يفعله الكود.

يصلح لأربع أدوات (Claude Code و Codex و OpenCode و WorkBuddy)، ويمكن إنجازه في 10 دقيقة حتى للمبتدئين من الصفر.

ماذا ستستطيع أن تفعل بعد التعلم ​

  • فحص الكود الذي سلّمه الذكاء الاصطناعي بقائمة قبول من أربع خطوات: النظر إلى diff، وتشغيل الاختبارات مع طلب الأدلة، ومراجعة خطوط الأمان الحمراء، والقدرة على الشرح — لتحويل «يبدو سليمًا» إلى «تم فحصه»
  • أن تعرف ما تركز عليه مراجعة كود الذكاء الاصطناعي: المناطق عالية التكرار من الأخطاء المنطقية وأخطاء الإعدادات والثغرات الأمنية التي أشارت إليها الدراسات الكمية، ومطابقتها بندًا ببند
  • استخدام ميزات المراجعة المدمجة في الأدوات ليجعلك «ذكاء اصطناعي لم يكتب هذا الكود» يساعدك في التدقيق: Claude Code و /code-review و /security-review، والمراجعة المتخصصة في Codex، وأمر review-diff في OpenCode
  • التمييز بين متى يمكنك اتباع أسلوب «عدم قراءة diff» الأصلي ومتى يجب القبول والفحص — ما سيستخدمه الآخرون، اعرضه قبل النشر على شخص ذي خبرة لمراجعته

مأزقك الحالي ​

  • يقول الذكاء الاصطناعي «اكتمل، وجميع الوظائف تعمل بشكل طبيعي»، تفتح فتجد الصفحة تعمل فعلًا — لكنه عدّل في طريقه ثلاثة ملفات لم تطلب منه لمسها، وأنت لا تعرف ذلك أصلًا
  • سمعت أن الثغرات الأمنية في الكود الذي يكتبه الذكاء الاصطناعي أكثر بـ 2.74 مرة مما يكتبه البشر، وتريد الفحص لكنك لا تعرف من أين تبدأ: الكود غير مفهوم، فماذا تفحص مراجعة كود الذكاء الاصطناعي تحديدًا وبأي ترتيب؟
  • الشيء على وشك أن يستخدمه الآخرون (أصدقاء، عملاء، نشر في المتجر)، وأنت غير مطمئن: إن كان فيه ثغرة خفية، فمن يكتشفها أولًا — المستخدم أم المهاجم؟

متى تستخدم هذه الطريقة ​

عندما تحتاج إلى:

  • ترقية «الذكاء الاصطناعي يقول إنه انتهى» إلى «تم فحصه، يمكن إطلاقه»
  • ما سيستخدمه الآخرون، اعترض المخاطر قبل النشر لتظل في يدك
  • قائمة فحص لكود الذكاء الاصطناعي يمكن تنفيذها حتى دون فهم الكود

ولا تريد:

  • مضغ كل سطر من الكود الذي أنتجه الذكاء الاصطناعي سطرًا بسطر (هذا الدرس لا يتطلب منك فهمه كله)
  • الاعتماد على تقارير المستخدمين عن الأخطاء بعد الإطلاق لاكتشاف الثغرات
  • نقل أسلوب «Accept All» الخاص بلعبة عطلة الأسبوع مباشرة إلى منتج جاد

🎒 التحضير قبل البدء ​

  • قراءة حلقة الأخطاء: أعد تغذية رسالة الخطأ كما هي — المشكلات التي يكشفها القبول يجب في النهاية أن تعود إلى حلقة الإصلاح في ذلك الدرس
  • تثبيت واستخدام أداة واحدة على الأقل: Claude Code أو Codex أو OpenCode أو WorkBuddy
  • وجود مشروع صغير «يعمل» سلّمه الذكاء الاصطناعي للتو بين يديك — التدرب على تسليم حقيقي يثبت في الذاكرة أكثر من مشاهدة الأمثلة
  • 10 دقيقة وكوب من الماء ☕

الفكرة الأساسية ​

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

فلماذا لا يكفي الاعتماد على «تشغيله ومعاينته»؟ لأن الدراسات الكمية وضعت مشكلات جودة كود الذكاء الاصطناعي على الطاولة:

الدراسةالنتائجماذا تعني للقبول
CodeRabbit (2025-12، تحليل 470 طلب دمج مفتوح المصدر على GitHub)الكود الذي يشارك فيه الذكاء الاصطناعي يحتوي على مشكلات «كبرى» أكثر بنحو 1.7 مرة من الكود البشري؛ وأخطاء الإعدادات أكثر بـ 75%؛ والثغرات الأمنية أكثر بـ 2.74 مرةلا يكفي النظر إلى نجاح الوظائف في التشغيل، بل يجب الفحص وفق المناطق عالية التكرار
Veracode (2025-10، تتبع لمدة ثلاث سنوات)تقدم ملحوظ في قدرة النماذج على توليد كود قابل للتشغيل، لكن أمان الكود المولّد لم يتحسن إجمالًا«النموذج تحدّث فينبغي أن يكون أكثر أمانًا» افتراض غير صحيح، وكل دفعة كود يجب فحصها
حادثة Lovable (2025-05)من بين 1,645 تطبيق ويب أنشأتها منصة تطبيقات الذكاء الاصطناعي Lovable، كان 170 منها يحتوي على عيب أمني يتمثل في «أي شخص يمكنه الوصول إلى بيانات المستخدمين»الإطلاق دون قبول يعني ظهور الثغرات على دفعات

السياق الكامل لهذه الأرقام مفصَّل في Vibe Coding هل هو موثوق: المخاطر والجدل والحالات الواقعية. نأخذ من هذا الدرس أمرًا واحدًا فقط: مشكلات جودة كود الذكاء الاصطناعي ليست عشوائية، بل لها مناطق عالية التكرار — الأخطاء المنطقية وأخطاء الإعدادات والثغرات الأمنية. قائمة القبول مصممة وفق هذه المناطق عالية التكرار.

إليك نظرة سريعة على قائمة الخطوات الأربع، كل خطوة تعترض نوعًا من الفخاخ:

الخطوةالإجراءما الذي يعترضه
1. راجع الـ diffافحص كل تعديل قام به الذكاء الاصطناعي واحدًا واحدًاأن يغيّر أشياء لم تطلبها منه
2. شغّل الفحوصاتفحوصات نجاح/فشل + الأوامر والمخرجات كدليلإنجاز زائف يبدو «مكتملًا»
3. افحص الخطوط الحمراءمطابقة المفاتيح والصلاحيات والإعدادات والمنطق بندًا بندًامناطق انتشار الثغرات الأمنية وأخطاء الإعدادات
4. القدرة على الشرحأن تستطيع شرح ما يفعله الكود لشخص آخر، وطلب مراجعة من غيرك عند الحاجةإطلاق كود لم تفهمه حتى أنت

خلاصة هذا الدرس في جملة واحدة: راجع الـ diff، شغّل الفحوصات، تجاوز الخطوط الحمراء، ولا تُطلق إلا ما تستطيع شرحه.

نفّذ معي ​

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

الخطوة 1: مراجعة الـ diff — تبدأ مراجعة كود الذكاء الاصطناعي من «ماذا غيّر» ​

لماذا: أن يأتي ما أنتجه الذكاء الاصطناعي مختلفًا عمّا تخيلته هو الفخ الشائع الأول في قائمة الممارسات الفضلى الرسمية — فهو لا يستطيع قراءة المتطلبات من عقلك، بل يخمّنها فقط. وممارسة «قبول الكل دون مراجعة الـ diff» تُضيّع بالضبط كل فرص اكتشاف التخمين الخاطئ. لذا فالخطوة الأولى في مراجعة كود الذكاء الاصطناعي ليست قراءة الكود، بل مراجعة قائمة التغييرات: اعرف أولًا الملفات التي عدّلها، ثم تحدّث عن الفحص.

مداخل مراجعة التغييرات في كل أداة:

الأداةكيفية مراجعة الـ diff
Claude Codeشغّل /diff داخل الجلسة لعرض تغييرات مساحة العمل، بما فيها جميع تعديلات الذكاء الاصطناعي حتى الآن
Codexافحص الأوامر والـ diff لحظة ظهورها (الموقع الرسمي: Steer the active turn, inspect commands and diffs as they appear)
OpenCodeشغّل git diff --stat في الطرفية لعرض قائمة الملفات المعدّلة، و git diff لعرض المحتوى التفصيلي
WorkBuddyيُسلَّم الناتج على شكل «نتائج قابلة للفحص»، وسيناريو تطوير الكود يتضمن المراجعة أصلًا، فراجع بندًا بندًا في محادثة المهمة ما قام به

إذا كان المشروع داخل مستودع Git، فإن git status و git diff يعملان مع الأدوات الأربع — هذا هو المدخل الأساسي المضمون دائمًا.

أثناء المراجعة، اطرح ثلاثة أسئلة فقط:

  1. هل كل الملفات المعدّلة مما طلبت منه تعديله؟
  2. هل توجد ملفات زائدة أو تبعيات زائدة؟
  3. في الأسطر المحذوفة، هل يوجد ما لا يبدو «إعادة هيكلة»؟

التغييرات مجهولة المصدر، اسأله عنها مباشرة (أول قالب سحري في هذه الصفحة):

text
ما الملفات التي عدّلتها في هذا التسليم؟ اشرح واحدًا واحدًا الغرض من كل تعديل،
وأي متطلب من متطلباتي يقابله. هل توجد مواضع عدّلتها عرضًا خارج ما طلبته صراحةً؟

::: نصيحة 💡 اجعل الذكاء الاصطناعي يُبرز المخاطر بنفسه توجد ممارسة جاهزة في سير العمل الرسمي: قبل التقديم، اطلب من الذكاء الاصطناعي إبراز المخاطر المحتملة والنقاط التي تستدعي الانتباه (Review Claude's generated PR before submitting and ask Claude to highlight potential risks or considerations). تقييمه الذاتي لا يحل محل فحصك، لكنه يرشدك — المواضع التي يعلّمها هي التي تراجعها بتركيز. :::

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

  • فحص صغير: راجعتُ قائمة الملفات المعدّلة ولا توجد تغييرات مجهولة المصدر؛ وإن وُجدت، فإن تفسير الذكاء الاصطناعي لها مقبول لديّ

الخطوة 2: شغّل فحوصات نجاح/فشل، واطلب أدلة لا «انتهيتُ» ​

لماذا: «الصفحة تفتح» لا تعني «تم الإنجاز». درس حلقة الأخطاء طبّق «فحوصات النجاح/الفشل» على إصلاح الأخطاء؛ أما عند القبول فهي البوابة الأخيرة: يجب أن يكون الناتج قد شغّل الفحوصات فعلًا، وأن ترى الدليل بعينيك. النص الرسمي: «عبارة "All tests pass" وحدها لا تعني شيئًا» — المطلوب هو الأوامر التي شغّلها ومخرجاتها الكاملة.

قد تكون الفحوصات أيًّا من هذه (القائمة الرسمية، استخدم ما يوجد في مشروعك):

الفحصمثال
الاختباراتأمر الاختبارات في المشروع، نجاح كلها
البناءرمز الخروج لأمر البناء/الترجمة يساوي 0
Lintأداة فحص الكود بلا أخطاء
سكربت المقارنةتطابق المخرجات مع الملف المتوقع سطرًا بسطر
لقطة شاشة للصفحةالشكل الفعلي عند التشغيل في المتصفح، مقارنةً بالشكل الذي تريده

انسخ موجه القبول مباشرة (القالب السحري الثاني في هذه الصفحة):

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

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

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

  • فحص صغير: كلمة «انتهيتُ» يتبعها أمر ومخرجات، وقد أعدتُ تشغيل واحد منها على الأقل بنفسي

الخطوة 3: راجع الخطوط الحمراء الأمنية — مطابقة بندًا بندًا لمناطق انتشار مشكلات جودة كود الذكاء الاصطناعي ​

لماذا: قدّمت أبحاث CodeRabbit توزيع مشكلات الكود الذي يشارك فيه الذكاء الاصطناعي — نسبة أعلى من الأخطاء المنطقية (اعتماديات خاطئة، عيوب في تدفق التحكم)، وأخطاء إعدادات أكثر بنسبة 75%، وثغرات أمنية أكثر بمقدار 2.74 مرة. لا يمكن توزيع الجهد بالتساوي في مراجعة كود الذكاء الاصطناعي، بل يجب الفحص بندًا بندًا وفق مناطق الانتشار. أربعة خطوط حمراء، ولكل منها طريقة فحص واضحة:

الخط الأحمرماذا نفحصلماذا هو منطقة انتشار
1. المفاتيحهل كُتبت مفاتيح API وكلمات المرور ورموز token بشكل ثابت في الكود أو أُرسلت إلى المستودعالبند 2 من قائمة Willison الأمنية: أي كود يتعلق بالمفاتيح يجب فهمه، وإلا سهُل تسريبه
2. الصلاحياتهل ما زالت عتبات «من يستطيع الوصول إلى ماذا» قائمة: تسجيل الدخول، التصريح، نطاق رؤية البياناتحادثة Lovable: في 170/1,645 تطبيقًا كان أي شخص يستطيع تصفّح بيانات المستخدمين — ثغرات الصلاحيات تظهر دفعة واحدة
3. الإعداداتهل قيم عناصر الإعداد صحيحة، وهل اختلطت بيئة الإنتاج ببيئة الاختبارCodeRabbit: أخطاء الإعدادات في الكود الذي يشارك فيه الذكاء الاصطناعي أكثر بنسبة 75%
4. المنطقهل تدفق التحكم في المسار الجوهري صحيح: الشروط، الحدود، معالجة الاستثناءاتCodeRabbit: نسبة أعلى من الأخطاء المنطقية (اعتماديات خاطئة، عيوب في تدفق التحكم)

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

الأداةأمر المراجعة
Claude Code/code-review يتحقق من صحة diff الحالي وأخطاء البرمجة (الاسم البديل /review، وإضافة --fix تتيح تطبيق الإصلاح مباشرة)؛ /security-review مخصص لفحص الثغرات الأمنية — الحقن، مشاكل المصادقة، كشف البيانات
Codexمراجعة مخصصة: شغّل المراجعة على التغييرات غير المُرسلة أو على commit معين أو على الفرع المرجعي، ويُعرض تقرير بالمشاكل مرتبة حسب الأولوية دون المساس بمساحة عملك
OpenCodeأمر المثال الرسمي review-diff: يُدرج تلقائيًا مخرجات git diff --stat && git diff في موجه المراجعة (انظر النصائح المتقدمة أدناه)

⚠️ تقرير المراجعة بالأدوات ليس نصًا منزّلًا

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

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

  • فحص صغير: راجعت الخطوط الحمراء الأربعة — المفاتيح والصلاحيات والإعدادات والمنطق — بندًا بندًا، وأعدت لصق المشاكل المكتشفة في حلقة الأخطاء

الخطوة 4: لا يُعتبر ناجحًا إلا ما يمكنك شرحه — ما يُعد لاستخدام الآخرين يحتاج إلى مَن يراجعه ​

لماذا: القاعدة الذهبية لويليسون: «My golden rule for production-quality AI-assisted programming is that I won't commit any code to my repository if I couldn't explain exactly what it does to somebody else» — إن لم تستطع شرح ما تفعله قطعة شيفرة بدقة لشخص آخر، فلا تُرسلها إلى المستودع. كما أعطى معيارًا للفصل: الشيفرة كتبها نموذج اللغة، لكنكراجعتها واختبرتها اختبارًا شاملًا وتستطيع شرح كيفية عملها للآخرين — فهذه ليست vibe coding، بل تطوير برمجيات حقيقي.

العملية على مستويين، اختر حسب وجهة المشروع:

المستوى الأول: اشرحه لنفسك (كل المشاريع). أعد تغذية diff أو الملفات الرئيسية إلى الذكاء الاصطناعي واطلب منه أن يشرحها لك (قالب السحر الثالث في هذه الصفحة):

text
اشرح لي بلغة بسيطة المنطق الأساسي لهذا التغيير: ماذا يفعل هذا المشروع الآن
من البداية إلى النهاية؟ من أين تأتي البيانات وإلى أين تذهب؟ ما هي أهم التغييرات ولماذا؟
افترض أنني لا أفهم الشيفرة إطلاقًا.

ما لا تفهمه أنت هو نقطة الخطر — إما أن تتابع السؤال حتى تفهم، أو أن تعلّمه لفحصه بشكل مركّز. لا تُعتبر هذه الخطوة ناجحة إلا إذا استطعت شرح المشروع بأسلوبك الخاص.

المستوى الثاني: مراجعة مستقلة (المشاريع المعدة لاستخدام الآخرين). البند 6 من قائمة ويليسون للأمان نصه: «If you're going to vibe code anything that might be used by other people, I recommend checking in with someone more experienced for a vibe check» — إذا كنت ستمارس vibe code لأي شيء قد يستخدمه آخرون، فاطلب من شخص أكثر خبرة أن يلقي نظرة. وإن لم تجد شخصًا، فدع «ذكاءً اصطناعيًا لم يشارك في كتابة هذه الشيفرة» يعمل مراجعًا مستقلًا على الأقل:

  • أمر Claude Code المسمى /code-review يقوم على هذا المبدأ بالضبط — فهو يفتح وكيلًا فرعيًا جديدًا تمامًا لمراجعة diff، وهولم يطلع أبدًا على محادثتكم ولن ينحرف بسبب الاستدلال الذي جرى أثناء كتابة الشيفرة
  • الأدوات التي لا تملك هذا الأمر: افتح جلسة ثانية للقيام بنفس الشيء — جلسة تكتب الشيفرة، وجلسة أخرى تراجع الملفات، ثم الصق النتائج في الجلسة الأولى لإصلاحها

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

  • فحص صغير: أستطيع أن أشرح لصديقي ما تفعله هذه الشيفرة؛ وللمشاريع المعدة لاستخدام الآخرين، رتبت شخصًا أو مراجعة مستقلة لضبط الجودة

نقاط التحقق ✅ ​

  • اطلعت على قائمة تغييرات الذكاء الاصطناعي (diff)، ولا توجد تغييرات مجهولة المصدر
  • «انتهيت» له دليل: أمر الفحص + المخرجات الكاملة، وأعدت تشغيل واحد منها بنفسي على الأقل
  • تمت مراجعة الخطوط الحمراء الأربعة للأمان — المفاتيح والصلاحيات والإعدادات والمنطق — بندًا بندًا
  • أستطيع شرح ما تفعله الشيفرة بأسلوبي الخاص، وعالجت ما لم أستطع شرحه
  • ما يُعد لاستخدام الآخرين، اطلع عليه شخص خبير، أو اجتاز المراجعة المستقلة (/code-review، جلسة ثانية)

تنبيهات من العثرات ​

❌ «الصفحة تفتح، إذن القبول ناجح» ​

فتح الصفحة يثبت فقط أن المسار الرئيسي لم ينقطع، ولا يثبت شيئًا آخر. النص الحرفي من أفضل الممارسات الرسمية: عند غياب فحوص قابلة للتشغيل، يصبح أساس إنهاء الذكاء الاصطناعي للعمل هو «يبدو أنه انتهى» — فأنت تصبح مجموعة اختباراته، وكل مشكلة تبقى كامنة حتى تشغلها بنفسك فتنفجر، والمهاجمون لا يسيرون في المسار الرئيسي فقط. الطريقة الصحيحة: شغّل فحوص النجاح/الفشل من الخطوة 2، واطلب الأوامر والمخرجات كأدلة؛ واستخدم Claude Code مع إضافة /verify ليقوم بنفسه بتشغيل التطبيق ورؤية النتيجة.

❌ اعتبار «الذكاء الاصطناعي قال إن جميع الاختبارات نجحت» دليلًا ​

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

❌ تقرير المراجعة يضم 15 بندًا، وسهرت الليل لأصلحها كلها ​

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

❌ أسلوب لعبة نهاية الأسبوع منقولًا كما هو إلى منتج يُعد لاستخدام الآخرين ​

حدّد كارباثي الحدود بنفسه: هذا الأسلوب «Accept All دون النظر إلى diff» جيد عند استخدامه في throwaway weekend project (مشروع صغير مؤقت لنهاية الأسبوع). أما نقله كما هو إلى ما يُعد لاستخدام الآخرين، فيعني أنك تنقل إلى المستخدمين مباشرةً معامل ثغرات أمنية أعلى بـ 2.74 مرة — وهكذا نشأت التطبيقات الـ 170 على منصة Lovable التي «يستطيع أي شخص الوصول إلى ملفات تعريف المستخدمين فيها». الطريقة الصحيحة: حدّد شدة القبول حسب «مَن سيستخدمه»: ما تستخدمه بنفسك، شغّله + ألقِ نظرة سريعة على المفاتيح؛ وما يُعد لاستخدام الآخرين، نفّذ الخطوات الأربع كاملة ثم اطلب من شخص خبير أن يراجعه.

نصائح متقدمة (اختيارية) ​

اكتب معايير القبول في دليل المشروع. تقول أفضل الممارسات الرسمية: إذا كانت هناك فحوص في المشروع بالفعل، فإن أنفع سطر في CLAUDE.md هو أمر تشغيلها. اكتب «ما الفحوص التي يجب تشغيلها قبل التسليم وكيف تُقدَّم الأدلة» في AGENTS.md / CLAUDE.md، فيحمل كل جلسة جديدة معايير القبول تلقائيًا — لطريقة الكتابة انظر AGENTS.md وCLAUDE.md: اترك للذكاء الاصطناعي دليلًا للمشروع.

أمر review-diff لمستخدمي OpenCode. تعطي الوثائق الرسمية مثالًا جاهزًا لأمر مخصص: أنشئ في المشروع .opencode/commands/review-diff.md، ومحتواه سطران — Review this diff: مع !`git diff --stat && git diff`. وبعد ذلك، في كل مرة /review-diff، سيُدرج التغييرات تلقائيًا في موجه المراجعة.

اجعل الفحوص تعترض تلقائيًا. يدعم Claude Code خاصية Stop hook: عندما يريد Claude إنهاء العمل، يُشغَّل سكربت الفحص الخاص بك أولًا (مثل فحص الأنواع)، وإذا لم ينجح يُعاد للعمل على الإصلاح — فيتحول القبول من «مراقبة بشرية» إلى «اعتراض آلي». هذه طريقة متقدمة، ومن يهتم يمكنه الاطلاع على قسم Enforce the check في وثائق best-practices الرسمية.

للقراء الذين يسلكون مسار نشر التطبيقات المصغرة أو الإضافات: مراجعة المنصة هي آخر خطوة قبول خارجية — لتطبيقات WeChat المصغرة توجد قائمة自查 رسمية قبل تقديم المراجعة (توافق الاسم، الوظائف الأساسية، أمان المحتوى)، انظر تقديم المراجعة والنشر: دليل تجنب مزالق قواعد مراجعة WeChat؛ ولمراجعة متجر Chrome والإصدار التدريجي انظر استراتيجية مراجعة المتجر والنشر.

خلاصة هذا الدرس ​

✅ لقد أكملت السلسلة الكاملة لمراجعة الكود بالذكاء الاصطناعي: مراجعة الـ diff (تصفح قائمة التغييرات بندًا بندًا) → تشغيل الفحوصات (نجاح/فشل + مخرجات الأوامر كدليل) → تجاوز الخطوط الحمراء (المفاتيح، الصلاحيات، التهيئة، المنطق — أربع مناطق عالية الخطورة) → القدرة على الشرح (أن تشرحها لغيرك، وما سيستخدمه الآخرون يحتاج مراجعة من شخص آخر).

✅ عرفت لماذا لا يمكن الاستغناء عن القبول: تقول دراسة كمية من CodeRabbit إن الثغرات الأمنية في الكود الذي يشارك فيه الذكاء الاصطناعي أكثر بـ 2.74 مرة من الكود الذي يكتبه البشر، وأخطاء التهيئة أكثر بنسبة 75%؛ وتقول متابعة Veracode على مدى ثلاث سنوات إن قدرة النماذج ترتفع لكن الأمان لا يرتفع. المشكلات لها مناطق عالية الخطورة، والقائمة صُممت وفق تلك المناطق.

✅ ميّزت حدود استخدام النمطين: النسخة الأصلية من Karpathy «بلا مراجعة diff» تُترك لمشاريع نهاية الأسبوع الترفيهية؛ أما ما سيُطلق للإنتاج فالمراجعة هي الخط الفاصل بين vibe coding وتطوير البرمجيات — يقول Willison بصراحة: إن جازت مراجعته واختباره وشرحه، فليس vibe coding، بل تطوير برمجيات.

مراجعة المفاهيم الأساسية:

المفهومبجملة واحدةأين تتعمق
مراجعة الـ diffالخطوة الأولى في القبول: اعرف أولًا ما غيّره الذكاء الاصطناعيالخطوة 1 في هذه الصفحة
اطلب الدليلأمر + مخرجات، وليس مجرد كلمة «انتهيت»الخطوة 2 في هذه الصفحة
الخطوط الحمراء الأمنيةالمفاتيح، الصلاحيات، التهيئة، المنطق — المناطق عالية الخطورة في كود الذكاء الاصطناعيالخطوة 3 في هذه الصفحة
القدرة على الشرحإن لم تستطع شرحه فلا تُرسله — القاعدة الذهبيةالخطوة 4 في هذه الصفحة
المراجعة الخارجيةما سيستخدمه الآخرون، اطلب من شخص ذي خبرة أو مراجعة مستقلة إلقاء نظرة عليهالخطوة 4 في هذه الصفحة

استعراض الدرس القادم ​

بعد إكمال قائمة القبول، يمكن إطلاق الكود بثقة — لكن مهلًا، الخطوط الحمراء في هذا الدرس فحصت فقط «هل كُتب المفتاح في الكود»، ولم تتناول بعد «كيف تُحفظ المفاتيح نفسها». الدرس القادم: التكلفة والأمان: ثلاثة خطوط دفاع — المفاتيح والفواتير وبيئة العزل.

ستتعلم:

  • كيف تُحفظ مفاتيح API: هذا الدرس يفحص التسريب، والدرس القادم يقدم لك خطة حفظ متكاملة
  • كيف تُحدد سقف الفوترة: حوادث فواتير بآلاف الدولارات ناتجة عن vibe coding على API بلا سقف فوترة، وكيف تمنعها
  • كيف تستخدم بيئة العزل (Sandbox): ارسم للذكاء الاصطناعي حدودًا لنشاطه، فأمان المبتدئين يبدأ من بيئة العزل
  • كيف تراقب خصوصية البيانات: تأكد مما إذا كانت بياناتك ستغادر جهازك أم لا
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.