Tutorial 1 Orientation fa

آموزش ۱ · آشناسازی

🌎 زبان: فارسی — مشاهدهٔ هر ۳۳ زبان

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

← بازگشت به خانه · بعدی: آموزش ۲ کد چگونه کار می‌کند

---

۱. چرا یک اپلیکیشنِ شوخی؟

یادگیریِ کار با یک عاملِ کدنویسی زمانی آسان‌ترین است که کد کوچک، واقعی و کم‌ریسک باشد. LockedIn CLI هر سه است:

• کوچک: یک فایلِ هسته، یک نقطه‌ی ورود، یک مجموعه‌ی آزمون، بدون هیچ وابستگی.
• واقعی: به‌عنوان یک فرمانِ سراسریِ lockedin نصب می‌شود و مانند یک CLI هوش مصنوعیِ اصیل رفتار می‌کند.
• کم‌ریسک: طنز است. اگر عامل شما فروتن‌فخرها را ۲۰٪ فروتن‌تر کند، هیچ‌کس فراخوانده نمی‌شود.

آن ترکیب به شما اجازه می‌دهد بر مهارتِ واقعی تمرکز کنید: خوب توصیف کردنِ یک تغییر، گذاشتنِ کار به‌عهده‌ی عامل و تأییدِ نتیجه.

۲. کد را دریافت کنید

git clone https://github.com/xjamesmorris/lockedin-cli.git
cd lockedin-cli

نسخه‌ی Node خود را بررسی کنید (به 18+ نیاز است):

node --version

چیزی برای نصب نیست — هیچ npm installی از وابستگی‌ها لازم نیست، چون هیچ وابستگی‌ای وجود ندارد. این عمدی است: قطعاتِ متحرکِ کمتر، یادگیریِ بیشتر.

۳. آن را اجرا کنید

چیزِ واقعی را امتحان کنید:

node bin/lockedin.js            # صفحهٔ آغاز + بنر
node bin/lockedin.js post       # یک پستِ تولیدشدهٔ «رهبری فکری»
node bin/lockedin.js aura       # هالهٔ حرفه‌ای شما را اسکن می‌کند
node bin/lockedin.js            # (بدون آرگومان) وارد نشست گفت‌وگو می‌شود

درون نشست /help را تایپ کنید، این‌سو و آن‌سو بگردید، سپس /exit. هر چه می‌بینید به‌صورت محلی از مخزن‌های واژه تولید می‌شود — بدون شبکه، بدون حساب. فهرست کاملِ فرمان‌ها: مرجع فرمان‌ها.

۴. دروازهٔ آزمون را اجرا کنید

این مهم‌ترین فرمان در کل آموزش است:

npm test

باید دیواری از تیک‌های سبز ببینید که به چیزی مانند pass 318 ختم می‌شود. آن مجموعه، تورِ ایمنیِ شماست. از این‌جا به بعد، جریانِ کار همیشه این است:

چیزی را تغییر بده → npm test → فقط اگر سبز بود عرضه کن.

۵. با عاملِ خود آشنا شوید

عاملِ کدنویسیِ خود را در پوشه‌ی پروژه باز کنید تا بتواند فایل‌ها را ببیند. با GitHub Copilot CLI، این‌گونه است:

copilot

سپس، برای اینکه جهت‌یابی کنید، از عامل بخواهید که شما را آشنا کند (هنوز چیزی را تغییر ندهد). اعلانی مانند این را امتحان کنید:

«یک تورِ دوپاراگرافی از این مخزن به من بده: هر فایل و پوشه‌ی سطح‌بالا برای چیست، و چگونه اپلیکیشن و آزمون‌ها را اجرا کنم. چیزی را تغییر نده.»

پاسخِ آن را در برابرِ آنچه در گام‌های ۳ تا ۴ دیدید بخوانید. راحت شدن در درخواست از عامل برای اینکه پیش از ویرایش توضیح دهد یک عادتِ بنیادی است — بسیار به آن تکیه خواهیم کرد.

---

✅ با عامل خود امتحان کن

1. از عامل بپرسید: «node bin/lockedin.js reflect 'قهوه‌ام سرد بود' چه چاپ می‌کند و کدام فایل درباره‌ی آن خروجی تصمیم می‌گیرد؟» پاسخش را با اجرای خودتانِ فرمان تأیید کنید.
2. از آن بخواهید مجموعه‌ی آزمون را اجرا کند و نتیجه را گزارش دهد: «npm test را اجرا کن و به من بگو چند بررسی سبز می‌شود.»

اکنون اپلیکیشن، آزمون‌ها و عامل را دیده‌اید. در ادامه، به این نگاه می‌کنیم که چرا این پایگاه‌کد این‌قدر دوستدارِ عامل است — طراحی‌ای که به شما اجازه می‌دهد تغییرات را با اطمینان واگذار کنید.

بعدی: آموزش ۲ کد چگونه کار می‌کند