skill
مراجعة الكهف
مراجعة كود مضغوطة - سطر واحد لكل ملاحظة مع تحديد الموقع والمشكلة والحل. استخدمها مع /caveman-review، "review this PR"، أو "review the diff".
نبذة
اكتب تعليقات مراجعة الكود موجزة وقابلة للتنفيذ. سطر واحد لكل ملاحظة. الموقع، المشكلة، الإصلاح. لا مقدمات.
## القواعد
**التنسيق:** `L<line>: <problem>. <fix>.` — أو `<file>:L<line>: ...` عند مراجعة فروقات متعددة الملفات.
**بادئة الخطورة (اختياري، عند الخلط):** - `🔴 bug:` — سلوك معطل، سيسبب حادثة - `🟡 risk:` — يعمل ولكنه هش (سباق، فحص null مفقود، خطأ تم تجاهله) - `🔵 nit:` — أسلوب، تسمية، تحسين دقيق. يمكن للمؤلف تجاهله - `❓ q:` — سؤال حقيقي، ليس اقتراحا
**تجاهل:** - "لاحظت أن..."، "يبدو أن..."، "قد ترغب في التفكير في..." - "هذا مجرد اقتراح ولكن..." — استخدم `nit:` بدلا من ذلك - "عمل رائع!"، "يبدو جيدا بشكل عام ولكن..." — قلها مرة واحدة في الأعلى، وليس لكل تعليق - إعادة صياغة ما يفعله السطر — يمكن للمراجع قراءة الفرق - التحوط ("ربما"، "قد"، "أعتقد") — إذا كنت غير متأكد استخدم `q:`
**احتفظ ب:** - أرقام الأسطر الدقيقة - أسماء الرموز/الدوال/المتغيرات الدقيقة بين علامتي الاقتباس الخلفية - إصلاح ملموس، وليس "فكر في إعادة هيكلة هذا" - *السبب* إذا لم يكن الإصلاح واضحا من بيان المشكلة
## أمثلة
❌ "لاحظت أنه في السطر 42، لا تتحقق مما إذا كان كائن المستخدم null قبل الوصول إلى خاصية البريد الإلكتروني. قد يتسبب هذا في تعطل محتمل إذا لم يتم العثور على المستخدم في قاعدة البيانات. قد ترغب في إضافة فحص null هنا."
✅ `L42: 🔴 bug: يمكن أن يكون user null بعد .find(). أضف حماية قبل .email.`
❌ "يبدو أن هذه الدالة تقوم بالعديد من الأشياء وقد تستفيد من تقسيمها إلى دوال أصغر لسهولة القراءة."
✅ `L88-140: 🔵 nit: دالة من 50 سطرا تقوم ب 4 أشياء. استخرج validate/normalize/persist.`
❌ "هل فكرت فيما يحدث إذا أعادت ال API رمز 429؟ أعتقد أنه يجب علينا على الأرجح التعامل مع هذه الحالة."
✅ `L23: 🟡 risk: لا توجد إعادة محاولة عند 429. قم بتضمينها في withBackoff(3).`
## الوضوح التلقائي
تجاهل الوضع الموجز ل: ملاحظات الأمان (تتطلب أخطاء فئة CVE شرحا كاملا + مرجعا)، خلافات معمارية (تتطلب مبررا، وليس مجرد سطر واحد)، وسياقات الإعداد حيث يكون المؤلف جديدا ويحتاج إلى "السبب". في تلك الحالات، اكتب فقرة عادية، ثم استأنف الوضع الموجز للبقية.
## الحدود
مراجعات فقط — لا تكتب إصلاح الكود، ولا توافق/تطلب تغييرات، ولا تشغل أدوات فحص الأكواد. أخرج التعليق (التعليقات) جاهزا للصق في طلب السحب (PR). "stop caveman-review" أو "normal mode": العودة إلى أسلوب المراجعة المطول.
التثبيت
شغل هذا الأمر
npx skills add juliusbrussee/cavemanيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add juliusbrussee/caveman`، أو استنسخ المستودع وانسخ مجلد `skills/caveman-review` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة مراجعة الكهف؟
مراجعة كود مضغوطة - سطر واحد لكل ملاحظة مع تحديد الموقع والمشكلة والحل. استخدمها مع /caveman-review، "review this PR"، أو "review the diff".
كيف أثبت مراجعة الكهف؟
شغل هذا الأمر في الطرفية:
npx skills add juliusbrussee/cavemanمع أي أدوات ذكاء اصطناعي تعمل مراجعة الكهف؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور مراجعة الكهف؟
طورها juliusbrussee.
هل مراجعة الكهف مجانية؟
نعم، يمكنك استخدامها مجانا.
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
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى