skill

مراجعة الكهف

مراجعة كود مضغوطة - سطر واحد لكل ملاحظة مع تحديد الموقع والمشكلة والحل. استخدمها مع /caveman-review، "review this PR"، أو "review the diff".

juliusbrussee378,839+ تثبيتموثوق

نبذة

اكتب تعليقات مراجعة الكود موجزة وقابلة للتنفيذ. سطر واحد لكل ملاحظة. الموقع، المشكلة، الإصلاح. لا مقدمات.

## القواعد

**التنسيق:** `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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

ثبت باستخدام `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.

هل مراجعة الكهف مجانية؟

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

أصول ذات صلة

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

كل بدائل مراجعة الكهف ←
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+

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

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

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