‫مرور کد محلی با Docker و smollm2 پیش از ارسال به گیت

این مقاله به معرفی یک رویکرد ابتکاری برای بازبینی کد (code review) با استفاده از هوش مصنوعی (AI) به صورت محلی و پیش از ارسال تغییرات به گیت (Git) می‌پردازد. این روش، فرآیند بازبینی را به طور کامل روی ماشین توسعه‌دهنده و بدون نیاز به اتصال به اینترنت یا کلیدهای API انجام می‌دهد، که بازخورد سریع و خصوصی را تضمین می‌کند. هدف اصلی این مقاله، توانمندسازی توسعه‌دهندگان برای ادغام یک مرحله بازبینی خودکار مبتنی بر مدل‌های زبان بزرگ (LLM) در چرخه توسعه خود است.

این سیستم بر پایه یک هوک پیش از ارسال (pre-push hook) گیت ساخته شده است. این هوک، اسکریپتی را پیش از هر عملیات git push اجرا می‌کند. برای پیاده‌سازی این سیستم، پیش‌نیازهای زیر لازم است:

نخستین گام، ایجاد هوک pre-push در دایرکتوری پروژه است. این کار با ساخت پوشه scripts و فایل pre-push در مسیر .git/hooks/ انجام می‌شود. فایل pre-push باید دارای مجوز اجرایی (chmod +x) باشد و اسکریپت bash scripts/review_with_model.sh را اجرا کند. این تنظیم تضمین می‌کند که هر بار که توسعه‌دهنده تلاش به git push می‌کند، کد او از طریق فرآیند بازبینی محلی مدل عبور کند. در صورت وجود هرگونه مشکل در بازبینی، فرآیند push متوقف می‌شود و پیام خطا نمایش داده می‌شود.

بخش اصلی این سیستم، اسکریپتی به نام review_with_model.sh است که تعامل با مدل هوش مصنوعی را مدیریت می‌کند. این اسکریپت وظایف زیر را بر عهده دارد:

پس از تنظیمات، توسعه‌دهنده می‌تواند با ایجاد یک تغییر کد (مثلاً اضافه کردن print('Hello world!') به یک فایل پایتون)، مرحله‌بندی آن (git add) و سپس تلاش برای git push، سیستم را آزمایش کند. در این مرحله، هوک pre-push فعال شده و مدل شروع به بازبینی تغییرات در ترمینال می‌کند. خروجی نمونه شامل پیشنهاداتی مانند "پیچیدن دستور print در یک تابع main()"، "اضافه کردن خط shebang" یا "استفاده از logging به جای print برای کد تولید" خواهد بود.

مقاله همچنین یک قابلیت اختیاری را برای مسدود کردن فرآیند push در صورت شناسایی مسائل حیاتی توسط مدل ارائه می‌دهد. این کار با دریافت خروجی مدل (REVIEW_OUTPUT) و سپس اسکن آن برای کلمات کلیدی مانند "bug" (باگ)، "security" (امنیت) یا "vulnerability" (آسیب‌پذیری) انجام می‌شود. در صورت تشخیص چنین کلماتی، اسکریپت با کد خطا خارج شده و push را لغو می‌کند.

با وجود مزایای فراوان، این راه‌اندازی دارای محدودیت‌هایی است:

این تنظیمات، یک دستیار بازبینی کد (code review assistant) را فراهم می‌کند که حریم خصوصی را حفظ کرده، قابل تکرار است و اولویت با اجرای محلی دارد. این سیستم جایگزین بازبینی انسانی نیست، بلکه مکملی قدرتمند برای شناسایی زودهنگام مشکلات و ایجاد عادت‌های توسعه بهتر است. هسته اصلی این فرآیند ساده است: دیف گیت (Git Diff) ⬅️ پرامپت (Prompt) ⬅️ مدل (Model) ⬅️ بازخورد (Feedback) ⬅️ کد بهتر (Better Code).