چک‌لیست بازبینی کد تولیدشده با هوش مصنوعی

بازبینی را از نیت تغییر و محدوده diff شروع کنید، سپس رفتار، امنیت، وابستگی‌ها و امکان بازگشت را با شواهد بررسی کنید.

پاسخ کوتاه

کد تولیدشده را مانند کد یک همکار سریع اما ناآشنا بررسی کنید: اول مطمئن شوید مسئله درست حل شده، بعد diff را خط‌به‌خط بخوانید، تست و تحلیل ایستا را اجرا کنید و تنها وقتی Merge کنید که مسیر بازگشت روشن باشد.

گردش‌کار پیشنهادی

1. معیار پذیرش و فایل‌های مجاز به تغییر را کنار Issue بنویسید.
2. با git diff --stat اندازه تغییر و سپس با git diff جزئیات را ببینید.
3. مسیرهای موفق، خطا، ورودی مرزی و مجوزها را جداگانه بررسی کنید.
4. بیلد، تست مرتبط، تحلیل ایستا و اسکن وابستگی را اجرا کنید.
5. تغییر ناخواسته در API، schema، migration، logging و configuration را جست‌وجو کنید.
6. برای تغییر پرریسک، برنامه rollback و نشانه‌های مانیتورینگ را ثبت کنید.

مثال اجرایی

در یک تغییر احراز هویت، فقط پاس‌شدن تست happy path کافی نیست. بررسی کنید خطای Token منقضی، نبود نقش، ثبت نشدن Secret در log و سازگاری پاسخ API نیز پوشش داده شده باشد.

چطور نتیجه را راستی‌آزمایی کنیم؟

خروجی قابل‌قبول یک diff کوچک و قابل‌توضیح، تست سبز، هشدار امنیتی رسیدگی‌شده و تأیید بازبین انسانی است. تعداد خطوط تولیدشده معیار پذیرش نیست.

خطاهای رایج

اعتماد به توضیح عامل بدون دیدن diff، حذف تست شکست‌خورده، افزودن وابستگی بدون بررسی و Merge مستقیم به شاخه محافظت‌شده چهار علامت توقف‌اند.

جایگاه این مطلب در مسیر یادگیری

برای تعریف ورودی بازبینی، معیار پذیرش وظیفه را بخوانید و برای پوشش رفتاری از گردش‌کار تست با هوش مصنوعی استفاده کنید.

منابع و محدودیت

راهنمای رسمی GitHub نیز اجرای تست و تحلیل ایستا، تطبیق با نیت و بازبینی انسانی را توصیه می‌کند. مستند git diff مرجع دقیق محدوده مقایسه است. راهنمای GitHub برای بازبینی کد AI و مستند git diff.

جمع‌بندی

بازبینی خوب با پرسش «چه چیزی تغییر کرد؟» تمام نمی‌شود؛ باید نشان دهد چرا تغییر درست است، چگونه سنجیده شده و اگر اشتباه بود چگونه برمی‌گردد.