برنامه‌نویسی

پرامپت بررسی و ریویو کد

ریویو ساختاریافته برای باگ، خوانایی، امنیت و پیشنهادهای عملی.

اجرا در Araaye AI

مناسب برای: توسعه‌دهنده و لید فنی

پرامپت آماده

تو یک reviewer سخت‌گیر اما سازنده هستی. کد را ریویو کن.

خروجی:
1) جمع‌بندی کلی (۱–۲ جمله)
2) مشکلات Critical
3) مشکلات Major
4) پیشنهادهای Minor / Style
5) نکات مثبت
6) چک‌لیست قبل از merge

قوانین:
- برای هر مشکل: محل + چرا مهم است + پیشنهاد اصلاح
- حدس نزن؛ اگر context کم است بگو چه چیزی کم است
- روی امنیت، صحت، و maintainability تمرکز کن

زبان/فریمورک:
{{STACK}}

کد:
{{CODE}}

هدف تغییر:
{{GOAL}}

نمونه ورودی

هدف: افزودن endpoint ثبت‌نام
کد (ساده):
@app.post("/signup")
def signup(email, password):
    db.execute(f"INSERT INTO users(email,password) VALUES('{email}','{password}')")
    return {"ok": True}

نمونه خروجی

جمع‌بندی: endpoint کار می‌کند اما از نظر امنیت و اعتبارسنجی آماده production نیست.

Critical:
- SQL injection با f-string — از query parameterized استفاده کن
- ذخیره password به‌صورت plain text — hash با bcrypt/argon2

Major:
- اعتبارسنجی فرمت ایمیل و قدرت پسورد وجود ندارد
- پاسخ خطا و وضعیت duplicate email مشخص نیست

Minor:
- نام‌گذاری و typing را بهبود بده

نکات مثبت: مسیر ساده و خوانا است.

چک‌لیست merge: parameterized SQL، hashing، validation، تست duplicate.

چه زمانی از این پرامپت استفاده کنی

  • ریویو PR قبل از merge
  • آماده‌سازی کد برای production
  • یادگیری بهترین‌روش‌ها با مثال خودت
  • بررسی امنیتی سریع endpointها

اشتباهات رایج

  • هدف تغییر را نگفتن
  • فقط تکه کد بدون context فراخوانی
  • درخواست «همه‌چیز را بازنویسی کن» به‌جای ریویو
  • مشخص نکردن سطح حساسیت (MVP در برابر production)

پرامپت‌های مرتبط

سؤالات پرتکرار

این پرامپت جایگزین reviewer انسانی است؟+

خیر؛ کمک سریع برای پیدا کردن باگ و ریسک است. تصمیم نهایی با تیم می‌ماند.

برای چه زبان‌هایی مناسب است؟+

عمومی است؛ stack را مشخص کن (مثلاً Python/FastAPI یا JS/React).

چطور خروجی را کوتاه‌تر کنم؟+

بنویس فقط Critical و Major را بده و Minor را حذف کن.

آیا روی امنیت تمرکز دارد؟+

بله؛ injection، auth، و داده‌های حساس را اولویت می‌دهد اگر در کد دیده شوند.

چطور در Araaye AI چند مدل را مقایسه کنم؟+

همان پرامپت را در Araaye AI با حالت مقایسه مدل‌ها اجرا کن و تفاوت ریویوها را ببین.

همین پرامپت را با چند مدل تست کن

اگر می‌خواهی همین پرامپت را با چند مدل هوش مصنوعی تست کنی، آن را داخل Araaye AI اجرا کن.

یا به کتابخانه پرامپت‌های آماده برگرد.