مراجعة الكود في Claude Code: /code-review والمهارات وeffort
كيف يعمل أمر /code-review المدمج: وجّهه نحو فرع أو طلب دمج، واقرأ الملاحظات المصنّفة بالدليل والأثر، واضبط effort و--max-findings، ثم اجعل المراجعة على كل طلب دمج.
الخلاصة السريعة
- مراجعة الكود مدمجة أصلًا — /code-review (أو اسمها البديل /review) تفحص كوميتات فرعك المتقدِّمة على upstream بالإضافة إلى التغييرات غير المثبَّتة، وتعمل في الخلفية.
- تعود الملاحظات مصنَّفة — Important وNit وPre-existing — كل واحدة بدليل ملموس وأثر وإصلاح يمكنك تطبيقه بـ --fix.
- العمق مقبض يُدار: effort على low وmedium وhigh وmax يُحفظ بين الجلسات، وultra يصعّد إلى ultrareview سحابية، و--max-findings (v2.1.288+) يحدّ التقرير أو يرفع سقفه.
- على GitHub، يراجع تطبيق Claude طلبات الدمج وفق المُشغِّل الذي تختاره ويعلّق داخل السطور؛ وتنتهي الـ check run دائمًا بنتيجة محايدة، فلا يُسدَّد أي دمج على الإطلاق.
Introducing Code Review
القناة: Anthropic · Claude0:45
Anthropic's NEW Claude Code Review Agent
القناة: Patrick Ellis29:56
Claude Code release notes — v2.1.288
ملاحظات الإصدار: github.com/anthropics/claude-code
Review pull requests with Claude Code — official docs
الوثائق: code.claude.com/docs
قيم هذه الصفحة متحقَّق منها ضد وثائق مراجعة الكود الرسمية وسجل تغييرات v2.1.288؛ والإطارات مأخوذة من الفيديوهين أعلاه ومُدقَّقة واحدة واحدة. السلوك الموصوف يطابق Claude Code v2.1.288 (أكتوبر 2026).
اللقطات إطارات من «Introducing Code Review» من Anthropic و«Anthropic's NEW Claude Code Review Agent» من Patrick Ellis، مستخدمة مع نسب المصدر وبإعادة ربط كل خطوة بالطابع الزمني الأصلي.
مراجعة الكود خطوة بخطوة
شغِّل المراجعة
- 1
حدِّث Claude Code وشغِّل الأمر
مراجعة الكود مدمجة — لا إضافة لتثبيتها. حدِّث إلى v2.1.288 أو أحدث لأجل الرايات الجديدة، واكتب /code-review (الصيغة الأقدم /review أصبحت اسمًا بديلًا)، واضغط enter. تبدأ المراجعة في الخلفية فتُكمل عملك.
أعلنت Anthropic عن المراجع المدمج ببطاقة عنوان خاصة به.شاهد عند 0:07 - 2
وجِّه المراجعة إلى الفرق الصحيح
بلا وسائط، تفحص /code-review كوميتات فرعك المتقدِّمة على upstream بالإضافة إلى تغييراتك غير المثبَّتة. ولتوجيهها لغير ذلك، مرِّر مسار ملف أو رقم طلب دمج أو اسم فرع أو مدى مثل main...my-feature.
اختر المستودع ووصف المهمة قبل أن تبدأ جلسة المراجعة.شاهد عند 0:08 - 3
اتركها تعمل في الخلفية
المراجعة وكيل مستقل، فيبقى محثّك حرًّا بينما تقرأ قاعدة الكود. أعد تشغيل /code-review لإعادة مراجعة جارية إلى المقدمة، أو أجبر وضع المقدمة بطباعة print أو بـ CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1.
ظهور حالة Starting Claude Code يعني أن المراجعة انطلقت فعلًا.شاهد عند 0:12 - 4
اقرأ الملاحظات مصنَّفة بالدليل والأثر
كل ملاحظة موسومة Important أو Nit أو Pre-existing وتعرض دليلًا ملموسًا وأثرًا وإصلاحًا مقترحًا — في العرض الرسمي يُكتشف خطأ IDOR مقيَّم بـ CVSS 9.1 Critical في طلب دمج حقيقي.
الدليل والأثر والإصلاح لملاحظة واحدة، كما ينشرها البوت تمامًا.شاهد عند 0:23
حوِّل الملاحظات إلى إصلاحات
- 5
أوصل الملاحظات إلى طلب الدمج
أضف --comment لتنشر كل ملاحظة كتعليق داخل سطر PR على GitHub (طلبات دمج GitLab تمر عبر glab من v2.1.257). ويهبط تطبيق Claude لـ GitHub بالملاحظات بالطريقة نفسها حين تعمل المراجعة على github.com.
بوت Claude يعلّق تحت الفرق مع زر حل لكل نقاش.شاهد عند 0:18 - 6
طبِّق الإصلاحات بـ --fix أو بلصقة واحدة
شغِّل /code-review --fix فتُطبَّق الملاحظات المقبولة على شجرة عملك. أو ألصق اقتراحًا عائدًا إلى جلستك — في العرض التجريبي تعدِّل الجلسة الملف وتشطب المهام دون من يحرّكها.
الجلسة تمضي في قائمة الإصلاح مهمةً مهمة وأنت تشاهد.شاهد عند 0:14 - 7
أعِد المراجعة حتى يتقارب الفرق
إعادة تشغيل /code-review بعد الإصلاحات تعيد فحص ما تغيّر فقط، فالجولة الثانية رخيصة — المراجعات المكرَّمة مُوصاة بالتقارب لا بإعادة الجدل. حين تُشطب كل المهام، ادفع وافتح طلب الدمج من الجلسة نفسها.
كل المهام مكتملة والجلسة جاهزة لإنشاء طلب الدمج.شاهد عند 0:24 - 8
حدِّد الملاحظات أو وسِّعها بـ --max-findings
جديد v2.1.288: /code-review --max-findings 5 أو --max-findings all تتجاوز الحد المعتاد، ويُعاد استخدام اختيارك في المراجعات اللاحقة حتى تمرِّر --max-findings default لاستعادة الحد.
ملاحظة حرجة واحدة منشورة بالدرجة والدليل والإصلاح المقترح.شاهد عند 0:20
اضبط العمق والأتمتة والقواعد
- 9
ارفع effort إلى الحد الأقصى أو انتقل إلى ultra
تقبل المراجعات effort على low وmedium وhigh وmax — وتتذكر خيارك الأخير بين الجلسات، فاكتبه مرة واحدة. و/code-review ultra يصعّد إلى ultrareview سحابية؛ ادمجهما بـ /code-review ultra --fix أو شغِّلها من CI عبر claude ultrareview.
عمق المراجعة مقبض يقع بجوار مُنتقي النموذج مباشرة.شاهد عند 0:04 - 10
ثبِّت تطبيق Claude لـ GitHub لكل طلب دمج
بوسع المالك تمكين Code Review من إعدادات المشرف، وهذا يثبّت تطبيق Claude لـ GitHub. اختر مُشغِّلًا لكل مستودع — مرة بعد إنشاء طلب الدمج، أو بعد كل دفعة، أو يدويًا — ثم علِّق @claude review على أي طلب دمج مفتوح.
نقرة Setup واحدة تمنح تطبيق Claude لـ GitHub صلاحية قراءة الكود.شاهد عند 0:02 - 11
علِّمه قواعد بيتك
كل CLAUDE.md على المسار يُتَّبع، والانتهاكات الجديدة تُعلَّم كـ nits. وتقرأ المراجعة المستضافة أيضًا REVIEW.md في جذر المستودع — إعادة تعريف الدرجات وسقف الـ nits وقواعد التخطي ومعيار التحقق — وskillOverrides يمكن أن تقيّد المهارة بالتشغيلات اليدوية.
معيار مراجعة أمنية بصيغة markdown، من مستودع Anthropic مباشرة.شاهد عند 18:30
/code-review مقابل /review مقابل /security-review مقابل /simplify مقابل ultra
يأتي Claude Code بعائلة صغيرة من أوامر المراجعة ويسهل الخلط بينها. هذا متى تكون كلٌّ منها الإجابة الصحيحة.
- 1/code-review — مطاردة الأخطاء الافتراضية. تفحص كوميتات الفرع المتقدِّمة على upstream بالإضافة إلى التغييرات غير المثبَّتة، وترتب الملاحظات بالدرجة، وتعمل في الخلفية بينما تواصل عملك.
- 2/review — الأمر نفسه. منذ v2.1.223 صار /review اسمًا بديلًا لـ /code-review؛ وقبل ذلك كانت مراجعة PR منفصلة بتمريرة واحدة وقراءة فقط، ولهذا تصفها الشروح القديمة بطريقة مختلفة.
- 3/security-review — التمريرة الموجهة أمنيًا والمبنية على دفتر أساليب Anthropic المفتوح. تطارد الثغرات فقط — في عرض Patrick Ellis التقطت مفتاح API مزيَّفًا مزروعًا — وهي أيضًا مرفقة مع Claude Code نفسه.
- 4/simplify — تنظيف لا مطاردة أخطاء. تطبِّق إعادة هيكلة مباشرة وتنسيقًا دون الحكم على الصحة. إن كانت لديك سكربتة قديمة تستخدم /simplify لإيجاد الأخطاء فوجِّهها إلى /code-review --fix.
- 5ultra — التصعيد السحابي. يرسل /code-review ultra فرق الفرع كاملًا مقابل الفرع الافتراضي إلى مراجعة سحابية أعمق؛ اربطه بـ --fix لتطبيق النتائج محليًا، أو شغِّل claude ultrareview من CI.
التقسيم العملي: /code-review حلقتك الداخلية الافتراضية أثناء الكتابة، و/security-review تثبّ قيمتها في المصادقة والمدفوعات وكل ما يلامس التوكنات، وultra للترحيلات الخطرة التي كنت لتطلب من زميل مراجعتها إضافيًا. أما التنظيف الشكلي البحت فهو عمل /simplify — وليس مراجعة أصلًا.
المراجعة صامتة أو ثرثارة أو غائبة على GitHub؟ إسعاف أولي
معظم مشكلات مراجعة الكود يُصلحها سطر واحد. امشِ في هذه القائمة قبل أن تلمس الإعدادات.
- 1«Unknown command» أو سلوك يطابق الشروح القديمة — حدِّث Claude Code. تحتاج --max-findings إلى v2.1.288+، وجاء الاسم البديل /review مع v2.1.223، وتتطلب --comment على MR في GitLab الإصدار v2.1.257+.
- 2انتهت المراجعة و«لم تجد شيئًا» — الحد الافتراضي يجعل التقارير قصيرة. أعد التشغيل بـ --max-findings all لرفعه، وتمشَّ على وسوم Nit وPre-existing بدل انتظار Critical.
- 3تلاشت في الخلفية — هذا مقصود. أعد تشغيل /code-review لتلتصق بالمراجعة الجارية، أو اجعل CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 إن أردتها في المقدمة دائمًا.
- 4يبدو أن قواعدك مُهمَلة — المراجعة المحلية /code-review تتبع CLAUDE.md لكنها لا تقرأ REVIEW.md أبدًا، فهي ملك المراجعة المستضافة على GitHub. ضع قوائم التحقق الخاصة بالمستودع في REVIEW.md والأسلوب الشخصي أو الخاص بالمشروع في CLAUDE.md.
- 5طلبات الدمج بلا مراجعة على GitHub — افحص مُشغِّل المستودع (مرة بعد الإنشاء، كل دفعة، يدوي)، وتأكد أن من علِّق يملك صلاحية write فأعلى، وتذكَّر أن طلبات الفروع المنشقا لا تُراجَع إلا بعد تعليق @claude review صريح.
فخ إضافي: تُسمّى فحوص الـ check run دائمًا Claude Code Review وتنتهي دائمًا باستنتاج محايد، فلن تحجب حماية الفرع أي دمج بسببها أبدًا. تريد بوابة إجبارية؟ حلِّل سطر الملخص bughunter-severity من الفحص في مهمة CI الخاصة بك وأفشل البناء عند ملاحظات Important.