آموزش برنامه‌نویسی با هوش مصنوعی؛ از مسئله تا تست

با یک تغییر کوچک شروع کن و نتیجه را در پروژهٔ خودت بسنج. این راهنما برای اولین کار عملی با یک دستیار کدنویسی است.

برنامه‌نویسی با هوش مصنوعی می‌تواند از توضیح یک تابع تا تغییر چند فایل و اجرای تست پیش برود. نتیجه وقتی قابل اتکاست که مسئله روشن باشد، ابزار به فایل‌های مرتبط دسترسی داشته باشد و رفتار کد بعد از تغییر بررسی شود. در این راهنما یک نمونه را دنبال می‌کنیم: دکمهٔ ثبت فرم با دو بار کلیک، دو درخواست می‌فرستد و باید فقط یک درخواست در جریان بماند.

۱. کار اول را کوچک و قابل سنجش انتخاب کن

برای شروع، رفع یک خطای مشخص یا اضافه‌کردن یک اعتبارسنجی مناسب‌تر از «کل برنامه را بساز» است. بنویس الان چه اتفاقی می‌افتد، انتظار داری چه اتفاقی بیفتد و چه چیزهایی باید ثابت بمانند. در مثال فرم، غیرفعال‌شدن دکمه هنگام ارسال و فعال‌شدن دوبارهٔ آن بعد از خطا، هر دو بخشی از نتیجه‌اند.

در فرم ثبت سفارش، با دو بار کلیک سریع دو درخواست ارسال می‌شود. تا وقتی درخواست قبلی تمام نشده، ارسال دوباره ممکن نباشد. اگر درخواست خطا داد، کاربر بتواند دوباره تلاش کند. ظاهر فرم و قرارداد API را تغییر نده.

۲. پروژه و روش اجرای آن را مشخص کن

آیرا کد داخل ترمینال اجرا می‌شود و با مجوزهای نشست می‌تواند فایل بخواند، ویرایش کند و فرمان اجرا کند. اگر هنوز نصبش نکرده‌ای، از راهنمای نصب برای سیستم‌عامل خودت شروع کن. بعد وارد پوشهٔ پروژه شو و نشست را باز کن:

cd path/to/project
git status
aira

تغییرات قبلی خودت را بشناس و نام فایل فرم، فرمان اجرای پروژه و فرمان تست را بده. اگر نمی‌دانی کدام فایل مسئول فرم است، ابتدا از دستیار بخواه مسیرش را در پروژه پیدا کند. متن خطا و مراحل بازتولید کمک می‌کنند؛ کلید API، رمز یا اطلاعات مشتری را از نمونهٔ لاگ حذف کن.

۳. قبل از ویرایش، علت و مسیر تغییر را بررسی کن

ابتدا فایل فرم و مسیر ارسال درخواست را بخوان. توضیح بده ارسال دوباره از کجا اتفاق می‌افتد و چه فایل‌هایی لازم است تغییر کنند. فعلاً چیزی را ویرایش نکن. اگر برای تشخیص علت اطلاعات کم است، همان اطلاعات را مشخص کن.

برای شروع نشست در حالت برنامه‌ریزی می‌توانی از فرمان زیر استفاده کنی. جزئیات مجوزها در راهنمای ابزارها و دسترسی‌ها آمده است.

aira --permission-mode plan

پیشنهاد «دکمه را غیرفعال کن» هنوز اثبات رفع خطا نیست. باید معلوم شود وضعیت ارسال چه زمانی فعال و چه زمانی آزاد می‌شود. اگر جلوگیری از ثبت تکراری در سمت سرور هم لازم باشد، آن را به‌عنوان کار جدا با قرارداد مشخص بررسی کن؛ تغییر رابط به‌تنهایی چنین تضمینی نمی‌دهد.

۴. تغییر را با محدودهٔ روشن انجام بده

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

همین مشکل ارسال دوباره را در فایل‌های لازم اصلاح کن. هنگام درخواست، دکمه غیرفعال باشد و پس از موفقیت یا خطا وضعیت ارسال آزاد شود. تغییرات قبلی من را نگه دار و در پایان فایل‌های تغییرکرده و دلیل هر تغییر را توضیح بده.

تغییرات را در ویرایشگر یا با git diff مرور کن. برای دیدن فایل و اختلاف نسخه کنار نشست، اتصال به VS Code و Cursor را ببین.

۵. نتیجه را با رفتار واقعی بسنج

  • یک کلیک باید یک درخواست ایجاد کند.
  • دو کلیک سریع هنگام ارسال نباید درخواست دوم بسازند.
  • پس از خطا، دکمه باید دوباره قابل استفاده باشد.
  • پیام خطا و مسیر موفقیت قبلی باید همچنان کار کنند.
با ابزار تست موجود پروژه، این رفتارها را بررسی کن. تست خطای اصلی باید روی نسخهٔ قبل از اصلاح شکست بخورد و پس از اصلاح پاس شود. فرمان‌های اجراشده، نتیجه و هر موردی را که نتوانستی بررسی کنی بنویس.

پاس‌شدن تست واحد را با کارکرد فرم در مرورگر یکی ندان. خودت هم مسیر موفقیت و خطا را اجرا کن. اگر محیط یا سرویس لازم در دسترس نیست، نتیجهٔ آن بخش هنوز مشخص نیست. برای مثال‌های بیشتر، راهنمای تست‌نویسی و دیباگ با هوش مصنوعی را بخوان.

۶. زمینهٔ پروژه و مصرف اعتبار را مدیریت کن

فرمان تست، قراردادهای مهم و تصمیم‌های ماندگار را در راهنمای پروژه ثبت کن.حافظهٔ آیرا کد کمک می‌کند این زمینه در نشست‌های بعدی در دسترس باشد؛ همچنان تغییرات جدید مخزن و اطلاعات ذخیره‌شده را بررسی کن.

برای هر کار، کل پروژه و همهٔ لاگ‌ها را دوباره به گفتگو اضافه نکن. از فایل و خطای مرتبط شروع کن، مصرف را با /usage و موجودی را با /balance ببین. هزینه به مدل و مصرف بستگی دارد؛ انتخاب مدل و راهنمای اعتبار و شارژ ریالی را پیش از کار طولانی مرور کن.

پرسش‌های رایج

بدون دانش برنامه‌نویسی می‌شود شروع کرد؟

می‌توانی با توضیح کد و تمرین‌های کوچک شروع کنی. برای انتشار یک برنامه، باید بتوانی نتیجه، خطاها و دسترسی‌های آن را بررسی کنی یا از یک توسعه‌دهنده کمک بگیری. تولید کد به‌تنهایی نشانهٔ آماده‌بودن برنامه نیست.

می‌توانم درخواست را فارسی بنویسم؟

بله. مسئله و نتیجهٔ مورد انتظار را فارسی توضیح بده، اما نام فایل، فرمان، شناسه و متن خطا را دقیق نگه دار. پرامپت‌های همین صفحه نقطهٔ شروع‌اند؛ آن‌ها را با رفتار پروژهٔ خودت کامل کن.

از کجا شروع کنم؟

آیرا کد را نصب کن، یک پروژهٔ کوچک باز کن و ابتدا فقط توضیح یک فایل را بخواه. سپس یک تغییر قابل سنجش را با همین مراحل پیش ببر.