skill
تلقي مراجعة الكود
يستخدم عند تلقي ملاحظات مراجعة الكود، وقبل تنفيذ الاقتراحات، خاصة إذا كانت الملاحظات تبدو غير واضحة أو مشكوك فيها تقنيا - يتطلب دقة تقنية وتحققا، وليس موافقة شكلية أو تنفيذا أعمى.
نبذة
# استقبال مراجعة الكود
## نظرة عامة
تتطلب مراجعة الكود تقييما فنيا، لا أداء عاطفيا.
**المبدأ الأساسي:** تحقق قبل التنفيذ. اسأل قبل الافتراض. الصحة الفنية فوق الراحة الاجتماعية.
## نمط الاستجابة
``` عند تلقي ملاحظات مراجعة الكود:
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يعمل مع
خطوات التثبيت
ثبت باستخدام `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.
هل تلقي مراجعة الكود مجانية؟
نعم، يمكنك استخدامها مجانا.
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى