Code Review Specialist

---
name: code-review-specialist
description: بازبینی جامع کد با تحلیل امنیت، کارایی و کیفیت. زمانی استفاده شود که کاربر درخواست بازبینی کد، تحلیل کیفیت کد، ارزیابی pull request می‌کند یا به بازبینی کد، تحلیل امنیت یا بهینه‌سازی کارایی اشاره می‌کند.
---

# مهارت بازبینی کد

این مهارت قابلیت‌های بازبینی جامع کد را با تمرکز بر موارد زیر فراهم می‌کند:

1. **تحلیل امنیت**
   - مسائل احراز هویت/مجوزدهی
   - ریسک‌های افشای داده
   - آسیب‌پذیری‌های تزریق
   - ضعف‌های رمزنگاری
   - ثبت داده‌های حساس

2. **بازبینی کارایی**
   - کارآمدی الگوریتم (تحلیل Big O)
   - بهینه‌سازی حافظه
   - بهینه‌سازی پرس‌وجوی پایگاه داده
   - فرصت‌های کش کردن
   - مسائل هم‌روندی

3. **کیفیت کد**
   - اصول SOLID
   - الگوهای طراحی
   - قراردادهای نام‌گذاری
   - مستندسازی
   - پوشش تست

4. **قابلیت نگهداری**
   - خوانایی کد
   - اندازه تابع (باید کمتر از ۵۰ خط باشد)
   - پیچیدگی سیکلوماتیک
   - مدیریت وابستگی
   - ایمنی نوع

## فایل‌های مرجع

این مهارت شامل فایل‌های پشتیبانی است که باید هنگام بازبینی بخوانید:

- **`templates/review-checklist.md`** — چک‌لیست ساختاریافته شامل امنیت، کارایی، کیفیت و تست. این فایل را بخوانید و از آن به‌عنوان راهنما استفاده کنید تا هیچ دسته‌ای در بازبینی از قلم نیفتد.
- **`templates/finding-template.md`** — قالب استاندارد برای مستندسازی یافته‌های فردی با شدت، مکان، نمونه‌های کد و تحلیل تأثیر. این فایل را بخوانید و هنگام گزارش مسائل از قالب آن استفاده کنید.
- **`scripts/analyze-metrics.py`** — اسکریپت پایتونی که سنجه‌های کد (تعداد تابع، تعداد کلاس، میانگین طول خط، امتیاز پیچیدگی) را محاسبه می‌کند. آن را روی فایل تحت بازبینی اجرا کنید تا داده‌های کمی گردآوری شود.
- **`scripts/compare-complexity.py`** — اسکریپت پایتونی که پیچیدگی سیکلوماتیک و شناختی بین دو نسخه از یک فایل را مقایسه می‌کند. هنگام بازبینی تغییرات ری‌فاکتور، آن را با نسخه‌های قبل و بعد اجرا کنید.

## قالب بازبینی

برای هر قطعه کد بازبینی‌شده، ارائه دهید:

### خلاصه
- ارزیابی کلی کیفیت (۱ تا ۵)
- تعداد یافته‌های کلیدی
- حوزه‌های اولویت‌دار توصیه‌شده

### مسائل حیاتی (در صورت وجود)
- **مسئله**: توصیف شفاف
- **مکان**: فایل و شماره خط
- **تأثیر**: چرا این مهم است
- **شدت**: حیاتی/بالا/متوسط
- **رفع**: نمونه کد

### یافته‌ها بر اساس دسته

#### امنیت (در صورت یافتن مسئله)
آسیب‌پذیری‌های امنیتی را با مثال فهرست کنید

#### کارایی (در صورت یافتن مسئله)
مشکلات کارایی را با تحلیل پیچیدگی فهرست کنید

#### کیفیت (در صورت یافتن مسئله)
مسائل کیفیت کد را با پیشنهادهای ری‌فاکتور فهرست کنید

#### قابلیت نگهداری (در صورت یافتن مسئله)
مشکلات قابلیت نگهداری را با بهبودها فهرست کنید

## تاریخچه نسخه

- v1.0.0 (2024-12-10): انتشار اولیه با تحلیل امنیت، کارایی، کیفیت و قابلیت نگهداری

---

**آخرین به‌روزرسانی**: ۴ اوت ۲۰۲۶
**نسخه Claude Code**: 2.1.220
**منابع**:
- https://code.claude.com/docs/en/skills
**مدل‌های سازگار**: Claude Fable 5.2, Claude Fable 5.1, Claude Fable 5, Claude Opus 5.5, Claude Opus 5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 5.5, Claude Haiku 4.5