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

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

ریویو ساختاریافته: Critical، Major، Minor، نکات مثبت و چک‌لیست merge.

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

این پرامپت چه کاری انجام می‌دهد؟

PR بدون ریویو یا ریویو فقط style، باگ production و ریسک امنیت را به main می‌برد. این پرامپت {{STACK}}، {{CODE}} و {{GOAL}} را می‌گیرد و مشکلات با شدت، محل و فیکس پیشنهادی لیست می‌کند.

تمرکز روی correctness، security و maintainability نه nitpick بی‌اهمیت. برای لید فنی و دولوپر قبل merge.

جایگزین reviewer انسانی و تست خودکار نیست. context ناقص را مدل می‌گوید — diff کامل بدهید.

خود پرامپت

نسخه فعال را کپی یا اجرا کن

اجرا در Araaye AI

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

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

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

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

کد:
{{CODE}}

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

۴۰۳ کاراکتر · حدود ۱۰۱ توکن

چطور شخصی‌سازی کنی

{{GOAL}} را هدف تغییر بنویسید.
{{STACK}} را زبان، فریمورک، نسخه.
سطح production vs MVP را در GOAL بگویید.
اگر فقط بخش حساس است همان را با context بدهید.
Criticalها را قبل merge حل کنید.

جدول متغیرهای پرامپت

هر متغیر را با مثال خوب پر کنید؛ مثال بد نشان می‌دهد چه چیزی خروجی را خراب می‌کند.

متغیر	معنا	مثال خوب	مثال بد
{{STACK}}	زبان و فریمورک	Python 3.11 + FastAPI	کد
{{CODE}}	کد یا diff برای ریویو	endpoint کامل + imports	چند خط وسط فایل
{{GOAL}}	هدف تغییر	افزودن endpoint ثبت‌نام	بهبود

از کپی تا نتیجه؛ قدم‌به‌قدم

۱GOAL و STACK را قبل از کد بنویسید.
۲Criticalها را قبل از merge حل کنید.
۳پیشنهادات Minor را در backlog بگذارید.
۴برای باگ runtime، python-debug جدا بگیرید.
۵API تغییر یافته را با api-design چک کنید.

ورودی ضعیف در برابر ورودی قوی

ضعیف

کدم را ریویو کن

قوی

هدف: signup endpoint
Stack: FastAPI
کد: POST /signup با f-string SQL

بدون هدف و stack، ریویو generic است و ریسک امنیت از قلم می‌افتد.

سناریوی کامل

هدف: ریویو PR افزودن آپلود فایل

ورودی پرشده

هدف: آپلود تصویر پروفایل
Stack: Node Express
کد: multer بدون محدودیت نوع/حجم

خروجی مورد انتظار

جمع‌بندی: آپلود فایل کار می‌کند اما برای production آماده نیست. Critical: عدم محدودیت نوع/حجم فایل؛ خطر path traversal. Major: ذخیره‌سازی بدون اعتبارسنجی MIME؛ پیام خطای کاربر مبهم. Minor: نام فایل temp قابل حدس. نکات مثبت: ساختار route تمیز؛ تست happy path موجود. چک‌لیست merge: محدودیت حجم، whitelist نوع، تست فایل مخرب.

قدم بعد: Criticalها را فیکس و دوباره ریویو؛ سپس unit-test برای edge case.

نمونه ورودی

هدف: production signup
Stack: FastAPI + SQLAlchemy
کد: endpoint با plain password و بدون validation

نمونه خروجی

Critical: hashing، validation.
Major: duplicate email handling.
Minor: typing.
مثبت: ساختار route واضح.
چک‌لیست merge.

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

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

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

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

محدودیت‌ها و موارد نامناسب

بدون GOAL ریویو generic است.
کد بدون context فراخوانی ناقص تحلیل می‌شود.
«همه را بازنویسی کن» خروجی ریویو نیست.
منطق business خارج از کد را نمی‌داند.

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

این پرامپت برات مفید بود؟

این پرامپت یا پرامپت مرتبط؟

پرامپت دیباگ کد پایتون
این صفحه: ریویو ساختار و امنیت
آن پرامپت: یک خطای مشخص و traceback
پرامپت برای طراحی API
این صفحه: کد موجود
آن پرامپت: طراحی قرارداد قبل از کد