skill

تلقي مراجعة الكود

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

obra205,284+ تثبيتموثوق

نبذة

# استقبال مراجعة الكود

## نظرة عامة

تتطلب مراجعة الكود تقييما فنيا، لا أداء عاطفيا.

**المبدأ الأساسي:** تحقق قبل التنفيذ. اسأل قبل الافتراض. الصحة الفنية فوق الراحة الاجتماعية.

## نمط الاستجابة

``` عند تلقي ملاحظات مراجعة الكود:

1. اقرأ: الملاحظات كاملة دون رد فعل 2. افهم: أعد صياغة المتطلب بكلماتك الخاصة (أو اسأل) 3. تحقق: قارن بواقع قاعدة الكود 4. قيم: هل هي سليمة فنيا لقاعدة الكود هذه؟ 5. استجب: إقرار فني أو رفض مسبب 6. نفذ: عنصر واحد في كل مرة، واختبر كل منها ```

## الاستجابات المحظورة

**ممنوع تماما:** - "أنت محق تماما!" (انتهاك صريح لملف التعليمات) - "نقطة رائعة!" / "ملاحظات ممتازة!" (أداء شكلي) - "دعني أنفذ ذلك الآن" (قبل التحقق)

**بدلا من ذلك:** - أعد صياغة المتطلب الفني - اطرح أسئلة توضيحية - ارفض باعتراض فني إذا كان خطأ - ابدأ العمل مباشرة (الأفعال > الأقوال)

## التعامل مع الملاحظات غير الواضحة

``` إذا كان أي عنصر غير واضح: توقف - لا تنفذ أي شيء بعد اطلب توضيحا للعناصر غير الواضحة

لماذا: قد تكون العناصر ذات صلة. الفهم الجزئي = تنفيذ خاطئ. ```

**مثال:** ``` شريكك البشري: "أصلح 1-6" أنت تفهم 1،2،3،6. غير واضح بشأن 4،5.

❌ خطأ: نفذ 1،2،3،6 الآن، واسأل عن 4،5 لاحقا ✅ صحيح: "أنا أفهم العناصر 1،2،3،6. أحتاج إلى توضيح بشأن 4 و 5 قبل المتابعة." ```

## التعامل الخاص بالمصدر

### من شريكك البشري - **موثوق به** - نفذ بعد الفهم - **لا تزال تسأل** إذا كان النطاق غير واضح - **لا يوجد اتفاق شكلي** - **انتقل إلى الإجراء** أو الإقرار الفني

### من المراجعين الخارجيين ``` قبل التنفيذ: 1. تحقق: هل هو صحيح فنيا لقاعدة الكود هذه؟ 2. تحقق: هل يكسر وظائف موجودة؟ 3. تحقق: ما سبب التنفيذ الحالي؟ 4. تحقق: هل يعمل على جميع المنصات/الإصدارات؟ 5. تحقق: هل يفهم المراجع السياق الكامل؟

إذا بدا الاقتراح خاطئا: ارفض باعتراض فني

إذا لم تتمكن من التحقق بسهولة: قل ذلك: "لا يمكنني التحقق من هذا بدون [X]. هل يجب علي [التحقيق/السؤال/المتابعة]؟"

إذا تعارض مع قرارات شريكك البشري السابقة: توقف وناقش مع شريكك البشري أولا ```

**قاعدة شريكك البشري:** "الملاحظات الخارجية - كن متشككا، ولكن تحقق بعناية"

## فحص YAGNI للميزات "الاحترافية"

``` إذا اقترح المراجع "التنفيذ بشكل صحيح": ابحث في قاعدة الكود عن الاستخدام الفعلي

إذا لم يتم استخدامه: "نقطة النهاية هذه لا يتم استدعاؤها. هل نزيلها (YAGNI)؟" إذا تم استخدامه: ثم نفذ بشكل صحيح ```

**قاعدة شريكك البشري:** "أنت والمراجع كلاهما يتبع لي. إذا لم نكن بحاجة إلى هذه الميزة، فلا تضفها."

## ترتيب التنفيذ

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

## متى ترفض

ارفض عندما: - الاقتراح يكسر وظائف موجودة - المراجع يفتقر إلى السياق الكامل - ينتهك YAGNI (ميزة غير مستخدمة) - غير صحيح فنيا لهذه الحزمة - توجد أسباب تتعلق بالإرث/التوافق - يتعارض مع القرارات المعمارية لشريكك البشري

**كيفية الرفض:** - استخدم المنطق الفني، لا الدفاعية - اطرح أسئلة محددة - ارجع إلى الاختبارات/الكود العامل - أشرك شريكك البشري إذا كان الأمر معماريا

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

## الإقرار بالملاحظات الصحيحة

عندما تكون الملاحظات صحيحة: ``` ✅ "تم الإصلاح. [وصف موجز لما تغير]" ✅ "اكتشاف جيد - [مشكلة محددة]. تم الإصلاح في [الموقع]." ✅ [فقط أصلحه واعرضه في الكود]

❌ "أنت محق تماما!" ❌ "نقطة رائعة!" ❌ "شكرا على اكتشاف ذلك!" ❌ "شكرا على [أي شيء]" ❌ أي تعبير عن الامتنان ```

**لماذا لا شكر:** الأفعال تتحدث. فقط أصلحه. الكود نفسه يظهر أنك سمعت الملاحظات.

**إذا وجدت نفسك على وشك كتابة "شكرا":** احذفها. اذكر الإصلاح بدلا من ذلك.

## تصحيح رفضك بلباقة

إذا رفضت وكنت مخطئا: ``` ✅ "كنت محقا - لقد تحققت من [X] وهو يفعل [Y]. أنفذ الآن." ✅ "تحققت من هذا وأنت محق. كان فهمي الأولي خاطئا بسبب [السبب]. أصلح."

❌ اعتذار طويل ❌ الدفاع عن سبب رفضك ❌ الإفراط في الشرح ```

اذكر التصحيح بشكل واقعي وانتقل.

## الأخطاء الشائعة

| الخطأ | الإصلاح | |---------|-----| | الاتفاق الشكلي | اذكر المتطلب أو تصرف مباشرة | | التنفيذ الأعمى | تحقق من قاعدة الكود أولا | | الدفعات بدون اختبار | عنصر واحد في كل مرة، اختبر كل منها | | افتراض أن المراجع محق | تحقق مما إذا كان يكسر الأشياء | | تجنب الرفض | الصحة الفنية > الراحة | | التنفيذ الجزئي | وضح جميع العناصر أولا | | لا يمكن التحقق، المتابعة على أي حال | اذكر القيد، اطلب التوجيه |

## أمثلة حقيقية

**الاتفاق الشكلي (سيء):** ``` المراجع: "أزل الكود القديم" ❌ "أنت أ" ```

التثبيت

شغل هذا الأمر

npx skills add obra/superpowers

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add obra/superpowers`، أو استنسخ المستودع وانسخ مجلد `skills/receiving-code-review` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة تلقي مراجعة الكود؟

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

كيف أثبت تلقي مراجعة الكود؟

شغل هذا الأمر في الطرفية:

npx skills add obra/superpowers
مع أي أدوات ذكاء اصطناعي تعمل تلقي مراجعة الكود؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور تلقي مراجعة الكود؟

طورها obra.

هل تلقي مراجعة الكود مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل تلقي مراجعة الكود ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
واجهة سطر الأوامر Hyperframes
واجهة سطر الأوامر (CLI) ل HyperFrames من job - لإنشاء الهياكل، والتحقق من الإطارات، وعرضها، وتعديل الجدول الزمني، والمعاينة، والتصيير محليا أو سحابيا،…1,214,920+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبار…1,046,962+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدمها عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجواب".869,010+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (التزام، فرع، وسم، أو قاعدة دمج) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات (…696,572+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة