آموزش / شروع کار / درس ۳ از ۱۵
پرامپتنویسی برای برنامهنویسها
یک الگوی چهاربخشی برای درخواستهای کدنویسی، چند الگوی پرکاربرد و اشتباههایی که خروجی را خراب میکنند؛ با نمونهی قبل و بعد.
مقدماتی، ۸ دقیقه مطالعه
در این آموزش
کیفیت پاسخ مدل بیش از هر چیز به زمینهای که میدهید بستگی دارد. ترفندهای عجیب لازم نیست؛ کافی است مثل وقتی که کاری را به یک همکار تازهوارد میسپارید، کامل و روشن توضیح دهید.
الگوی چهاربخشی
- زمینه: پروژه چیست، با چه زبان و نسخهای، و کد مرتبط کجاست.
- هدف: دقیقاً چه چیزی باید تغییر کند یا ساخته شود.
- محدودیتها: چه چیزهایی نباید عوض شود؛ کتابخانهی مجاز، سبک کد، سازگاری.
- معیار پذیرش: از کجا بفهمیم کار درست انجام شده؛ معمولاً یک تست.
نمونهی قبل و بعد
درخواست مبهم:
text
فرم ثبتنام را درست کن.درخواست خوب:
text
پروژه: Laravel 11 با PHP 8.3. کنترلر ثبتنام در app/Http/Controllers/RegisterController.php است.
مشکل: اگر شماره موبایل با ارقام فارسی وارد شود (۰۹۱۲...)، اعتبارسنجی رد میکند.
خواسته: پیش از اعتبارسنجی، ارقام فارسی و عربی را به لاتین تبدیل کن.
محدودیت: بستهی جدید نصب نکن؛ قانون اعتبارسنجی فعلی را عوض نکن.
پذیرش: یک تست Feature بنویس که با «۰۹۱۲۳۴۵۶۷۸۹» ثبتنام موفق شود و تستهای فعلی هم سبز بمانند.الگوهای پرکاربرد
- «اول بپرس»: در پایان درخواست بنویسید «اگر چیزی مبهم است، پیش از نوشتن کد بپرس». مدلها در غیر این صورت حدس میزنند.
- «اول برنامه»: برای کارهای بزرگ بنویسید «فقط برنامهی تغییرات را فهرست کن و منتظر تأیید بمان».
- «با مثال»: چند ورودی و خروجی نمونه بدهید. برای تبدیل داده و Regex فوقالعاده مؤثر است.
- «نقش بازبین»: کد خودتان را بدهید و بخواهید «مثل یک بازبین سختگیر، فقط اشکالهای واقعی را با دلیل بگو».
- «فقط تغییرات»: برای فایلهای بزرگ بخواهید فقط بخش تغییرکرده یا diff را برگرداند تا خروجی کوتاه بماند.
اشتباههای رایج
- کار بزرگ در یک درخواست. «کل بخش پرداخت را بازنویسی کن» تقریباً همیشه خراب میشود. به چند گام کوچک و قابلتست بشکنید.
- نگفتن نسخهها. «React» کافی نیست؛ نسخه و کتابخانهی مدیریت وضعیت را بگویید.
- ادامه دادن گفتوگوی خراب. اگر مدل سه بار پشت سر هم اشتباه کرد، گفتوگوی تازه باز کنید و درخواست را با زمینهی بهتر از نو بنویسید. تاریخچهی اشتباه، اشتباه بیشتر میسازد.
- پذیرفتن بدون اجرا. کد را اجرا و تست کنید؛ ظاهر درست، دلیل درستی نیست.
فارسی یا انگلیسی؟
مدلهای امروزی فارسی را خوب میفهمند و میتوانید به فارسی بنویسید. فقط نامهای فنی، پیامهای خطا و نام فایلها را همانطور که هست (انگلیسی) بیاورید. متن انگلیسی معمولاً توکن کمتری مصرف میکند؛ اگر هزینه برایتان مهم است، دستورالعملهای ثابت و طولانی را انگلیسی بنویسید (توکن و هزینه).
یک الگوی آماده برای کپی
text
زمینه: [زبان/فریمورک و نسخه]، [فایلهای مرتبط]
هدف: [تغییر دقیق]
محدودیتها: [چه چیزی نباید عوض شود]
پذیرش: [تست یا رفتار قابلسنجش]
اگر ابهامی هست، پیش از نوشتن کد بپرس.