آموزش ویند‌سرف برای ساخت ویژگی جدید با ایجنت؛ گام‌به‌گام
آموزش گام‌به‌گام ویند‌سرف برای ساخت ویژگی جدید با ایجنت با نکته‌های مخصوص فارسی‌زبان‌ها؛ از اولین پرامپت تا خروجی حرفه‌ای.
آموزش‌های زیادی برای Windsurf وجود دارد؛ اما بیشترشان حالت عمومی دارند. این یکی برای ساخت ویژگی جدید با ایجنت و برای کاربر فارسی‌زبان تنظیم شده است.
چرا ویند‌سرف برای ساخت ویژگی جدید با ایجنت؟
ویند‌سرف با ایجنت Cascade خود شناخته می‌شود: دستور می‌دهید و ایجنت فایل‌ها را می‌خواند، تغییرات را اعمال میکند، دستورات ترمینال اجرا میکند و نتیجه را ارزیابی میکند — همه در یک جریان روان. پلن رایگان آن سخاوتمندانه‌تر از Cursor است و پلن Pro با حدود ۱۵ دلار ارزان‌تر؛ برای توسعه‌دهنده‌ای که «ایجنت‌محور» کار میکند، انتخاب جدی محسوب می‌شود. برای این کارِ مشخص، مزیت ویند‌سرف در توسعه‌دهنده‌ای که تجربهٔ ایجنت‌محور می‌خواهد با هزینهٔ کمتر و پلن رایگان سخاوتمندانه‌تر… خلاصه می‌شود؛ در گام‌های بعدی همین مزیت را به خروجی تبدیل می‌کنیم.
قبل از شروع: حساب و نسخهٔ مناسب
پلن رایگان تعداد مشخصی اعتبار Cascade در ماه (حدود ۲۵ پرامپت) و تکمیل کد محدود می‌دهد؛ برای پروژه‌های متوسط و یادگیری ایجنت‌ها کافی است. برای تمرین این آموزش، نسخهٔ رایگان کافی است؛ در انتهای مقاله می‌گوییم چه زمانی ارتقا منطقی می‌شود.
مسیر گام‌به‌گام
گام 1: ایدهٔ ویژگی را بنویسید
در Cascade توصیف کنید: «صفحهٔ ورود با اعتبارسنجی شمارهٔ موبایل ایرانی اضافه کن» — جزئیات پروژه را از فایل‌ها می‌گیرد.
گام 2: برنامهٔ ایجنت را مرور کنید
Cascade قبل از اجرا فایل‌های مرتبط را نشان می‌دهد؛ مسیر را تأیید کنید و بگذارید اجرا شود.
گام 3: با بازخورد اصلاح کنید
خروجی را ببینید و به‌جای بازنویسی، بگویید «این بخش را با کامپوننت موجود پروژه عوض کن» — ایجنت با حافظهٔ گفتگو اصلاح میکند.
گام 4: اجرای ترمینال را بپذیرید
برای نصب پکیج و اجرای تست، دستورات ترمینال را تأیید کنید؛ گردش‌کار کامل می‌شود.
گام 5: اعتبار را هوشمند مصرف کنید
وظایف کوچک را با تکمیل و چت، و وظایف بزرگ را با Cascade انجام دهید؛ اعتبار ماهانه دوام بیشتری می‌آورد.
نکته‌های حرفه‌ای که تفاوت می‌سازند
- ایجنت را با «وظیفهٔ کوچک و قابل آزمون» شروع کنید؛ اعتماد بسازید بعد پروژه‌های بزرگ بسپارید.
- پروژه را تمیز نگه دارید (فایل‌های مرده حذف شوند)؛ ایجنت به کانتکست تمیز بهتر جواب می‌دهد.
- هر تغییر بزرگ را در شاخهٔ جدا بگیرید؛ بازگشت آسان می‌ماند.
اشتباهات رایج در همان هفتهٔ اول
- پرامپت‌های مبهم: اگر خروجی ضعیف بود، اول پرامپت را دقیق‌تر کنید؛ در بیشتر موارد مشکل از ابزار نیست از دستور است.
- پذیرش کورکورانه خروجی: اکوسیستم و آموزش‌های آن از رقیب اصلی کمتر است — خروجی را همیشه یک دور ویرایش کنید.
- شروع از کار سنگین: اول یک نمونهٔ کوچک تمام‌وکمال بسازید تا مسیر را ببینید، بعد سراغ پروژهٔ اصلی بروید.
چطور بفهمیم پیشرفت می‌کنیم؟
معیار ساده داریم: در پایان این آموزش باید بتوانید ساخت ویژگی جدید با ایجنت را بدون کمک بیرون و با کیفیت قابل انتشار انجام دهید. اگر بعد از سه تلاش هنوز به آن نقطه نرسیدید، پیش‌فرض‌های پرامپت یا نسخهٔ ابزار را بازبینی کنید — دریافت و استفاده با فیلترشکن از ایران ممکن است…
چک‌لیست خروجی نهایی
پیش از اعلام «تمام»، خروجی خودتان را با این چک‌لیست بسنجید:
- خروجی بدون ویرایشِ انسانی منتشر نشده باشد — یک دور بازخوانی و اصلاح، حداقل است.
- هدفِ کار (ساخت ویژگی جدید با ایجنت) محقق شده باشد، نه فقط «کاری انجام شده باشد».
- در صورت نیاز به تکرار، پرامپت نهایی را ذخیره کرده باشید تا دوباره از صفر ننویسید.
- خروجی برای مخاطب فارسی‌زبان روان و بی‌غلط باشد؛ یک آزمون خوب این است که بلندخوانی کنید و هر جا لحن گیر کرد، همان‌جا را ویرایش کنید.
اگر گیر کردید
سه راه‌حل سریع که در بیشتر موارد جواب می‌دهد: یکم — پرامپت را با زبان ساده‌تر و با یک مثال ملموس بازنویسی کنید؛ مدل‌ها به مثال بهتر از توضیح پاسخ می‌دهند. دوم — گفتگوی تازه‌ای شروع کنید و فقط همان تکهٔ مشکل‌دار را با زمینهٔ کوتاه بدهید؛ گفتگوهای شلوغ کیفیت را پایین می‌آورند. سوم — خروجی را از ویند‌سرف بگیرید و قطعهٔ نهایی را با ابزار مکمل ویرایش کنید؛ ترکیب ابزارها معمولاً از اصرار روی یک ابزار سریع‌تر به نتیجه می‌رسد.
برای کاربر فارسی‌زبان
دریافت و استفاده با فیلترشکن از ایران ممکن است؛ پرداخت پلن‌ها به کارت بین‌المللی نیاز دارد. برای توسعه‌دهندهٔ ایرانی با بودجهٔ محدود، پلن رایگان گسترده‌تر آن نقطهٔ شروع بهتری است.
و یک نکتهٔ آخر: ابزارها به‌روز می‌شوند، اما روشِ یادگیریِ درست همیشه همان است. مسیر این مقاله را یک بار کامل بروید؛ بعد از آن هر قابلیت جدید ویند‌سرف را در چند دقیقه یاد می‌گیرید.
سوالات متداول
Cascade برای پروژهٔ واقعی قابل اعتماد است؟
برای وظایف مشخص بله؛ همیشه نتیجه را در شاخهٔ جدا مرور و تست کنید.
افزونههای VS Code را پشتیبانی میکند؟
بله؛ مبنای آن VS Code است و بیشتر افزونهها کار میکنند.
پیوندهای مفید
این مطلب برایتان مفید بود؟
با پسندیدن، به ما کمک می‌کنید مطالب بهتری منتشر کنیم.
