المهارات caveman-review
📦

caveman-review

آمن

مراجعة التعليمات البرمجية بتعليقات مضغوطة في سطر واحد

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

يدعم: Claude Codex Code(CC)
🥉 74 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "caveman-review". Review a function that fetches user data without error handling

النتيجة المتوقعة:

  • L12: 🔴 bug: fetchUser returns null on miss. Add null check before .email access.
  • L15: 🟡 risk: no timeout on fetch call. Add AbortController with 5s deadline.
  • L8-22: 🔵 nit: 15-line fn could extract error handler. Reduce duplication.

استخدام "caveman-review". Review a multi-file pull request adding a new API endpoint

النتيجة المتوقعة:

  • routes/user.js:L34: 🔴 bug: req.params.id passed directly to query. Use parameterized query.
  • routes/user.js:L41: 🟡 risk: no rate limit on POST /users. Add express-rate-limit middleware.
  • tests/user.test.js:L5: ❓ q: test covers happy path only. Should 400 and 500 cases be added?

التدقيق الأمني

آمن
v1 • 4/15/2026

All 13 static analysis findings are false positives. The static scanner misidentified markdown backtick inline code formatting as Ruby/shell command execution across 11 locations. The network and weak-crypto detections at lines 3 and 7 are also incorrect — those lines contain YAML frontmatter metadata and trigger descriptions, not actual network calls or cryptographic operations. This skill is a pure markdown instruction file that defines code review formatting behavior for AI agents. It contains no executable code, no network requests, no command execution, and no file system operations. Safe for publication.

1
الملفات التي تم فحصها
55
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

مراجعة سريعة لطلبات السحب للفرق المشغولة

راجع طلبات السحب بتعليقات موجزة من سطر واحد تبرز الأخطاء والمخاطر والاقتراحات دون شروح مطولة.

تعليقات مراجعة موحدة عبر الفرق

تطبيق تنسيق متسق على جميع ملاحظات مراجعة التعليمات البرمجية بحيث تتبع كل ملاحظة نمط الموقع-المشكلة-الإصلاح نفسه.

المراجعة الذاتية قبل تقديم طلب السحب

اطلب من الذكاء الاصطناعي مراجعة فرق التعليمات البرمجية الخاص بك قبل فتح طلب سحب، لاكتشاف المشكلات مبكراً بأقل ضوضاء.

جرّب هذه الموجهات

مبتدئ: طلب مراجعة بسيط
Review this code and tell me what to fix.
متوسط: مراجعة بمستويات شدة
Review this diff and use severity prefixes for each finding.
متقدم: مراجعة فرق متعدد الملفات
Review this multi-file diff. Include file names with line references for each finding.
خبير: مراجعة تركز على الأمان
Review this code for security vulnerabilities. Use full explanations for any security findings.

أفضل الممارسات

  • قدم التعليمات البرمجية أو الفرق مباشرة في طلبك حتى تتمتع المراجعة بمواد ملموسة لتحليلها
  • استخدم بادئات الشدة لإيصال مستوى الاستعجال بنظرة سريعة: bug للكود المعطوب، وrisk للأنماط الهشة، وnit لاقتراحات الأسلوب
  • اطلب شروحات كاملة لاكتشافات الأمان بالاعتماد على قاعدة التوضيح التلقائي المدمجة التي توسع تلك الاكتشافات تلقائياً

تجنب

  • طلب المهارة لكتابة الإصلاح الفعلي — فهي تنتج تعليقات مراجعة فقط وليس تصحيحات
  • توقع إجراءات الاعتماد أو طلب التغيير — المهكرة تنتج تعليقات جاهزة للصقها في طلب سحب لكنها لا تتفاعل مع المنصة
  • استخدام التنسيق المضغوط لإعداد المطورين الجدد الذين يحتاجون إلى مزيد من السياق والأساس المنطقي لكل اقتراح

الأسئلة المتكررة

ما التنسيق الذي تستخدمه كل تعليق مراجعة؟
كل تعليق يتكون من سطر واحد: L متبوعاً برقم السطر، ثم بادئة الشدة، ثم وصف المشكلة، ثم اقتراح إصلاح محدد.
كيف أُفعّل وضع caveman-review؟
قل "review this PR" أو "code review" أو "review the diff" أو استخدم "/review" أو استدعِ /caveman-review. يستمر الوضع حتى تعطله.
هل يمكن لهذه المهارة كتابة الإصلاح الفعلي للكود نيابةً عني؟
لا. يكتفي Caveman-review بإخراج تعليقات المراجعة فقط. لا يكتب إصلاحات برمجية ولا يعتمد تغييرات ولا يشغل أدوات التدقيق.
ماذا تعني بادئات الشدة؟
تعني bug سلوكاً معطوباً سيسبب حادثاً. وتعني risk أن الكود يعمل لكنه هش. وتعني nit اقتراح أسلوب أو تسمية يمكن تجاهله. وتعني q سؤالاً حقيقياً وليس اقتراحاً.
هل ستحصل اكتشافات الأمان على شروحات مفصلة؟
نعم. تطبق قاعدة التوضيح التلقائي وضع الشرح الكامل تلقائياً لاكتشافات الأمان وتوفر شروحات كاملة مع مراجع.
كيف أُعطّل وضع caveman-review؟
قل "stop caveman-review" أو "normal mode" للعودة إلى أسلوب المراجعة المطول القياسي.

تفاصيل المطور

المؤلف

juliusbrussee

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md