Tutorial 1 Orientation ar

الدرس 1 · التوجيه

🌎 اللغة: العربية — شاهد كل اللغات الـ33

الهدف: شغّل المشروع، وتعرّف على وكيل الذكاء الاصطناعي لديك، وشغّل بوابة الاختبار مرة واحدة — حتى يصبح كل ما بعد ذلك عادة راسخة.

← عودة إلى الرئيسية · التالي: الدرس 2 كيف تعمل الشيفرة

---

1. لماذا تطبيق مزحة؟

يكون تعلّم العمل مع وكيل برمجة أسهل ما يكون حين تكون الشيفرة صغيرة وحقيقية وقليلة المخاطر. LockedIn CLI هي الثلاثة معا:

• صغيرة: ملف نواة واحد، ونقطة دخول واحدة، ومجموعة اختبار واحدة، وصفر اعتماديات.
• حقيقية: تُثبَّت كأمر عام lockedin وتتصرف كواجهة أوامر ذكاء اصطناعي حقيقية.
• قليلة المخاطر: إنها سخرية. إن جعل وكيلك التباهي المتواضع أكثر تواضعا بنسبة 20%، فلن يُستدعَى أحد على عجل.

هذا المزيج يتيح لك التركيز على المهارة الفعلية: وصف التغيير جيدا، وترك الوكيل يؤدي العمل، والتحقق من النتيجة.

2. احصل على الشيفرة

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

تحقق من إصدار Node لديك (تحتاج 18+):

node --version

لا شيء لتثبيته — لا npm install لأي اعتماديات، لأنه لا يوجد أي منها. هذا متعمّد: أجزاء متحركة أقل، وتعلّم أكثر.

3. شغّلها

جرّب الشيء الحقيقي:

node bin/lockedin.js            # شاشة البدء + اللافتة
node bin/lockedin.js post       # منشور «قيادة فكرية» مولّد
node bin/lockedin.js aura       # افحص هالتك المهنية
node bin/lockedin.js            # (بلا معاملات) يفتح جلسة الدردشة

اكتب /help داخل الجلسة، وتجوّل، ثم /exit. كل ما تراه مولَّد محليا من مجمّعات كلمات — لا شبكة، ولا حسابات. قائمة الأوامر الكاملة: مرجع الأوامر.

4. شغّل بوابة الاختبار

هذا هو الأمر الأهم في الدرس كله:

npm test

يفترض أن ترى جدارا من علامات الاختيار الخضراء ينتهي بشيء مثل pass 318. تلك المجموعة هي شبكة أمانك. من هنا فصاعدا، سير العمل دائما:

غيّر شيئا → npm test → لا تشحن إلا إن كانت خضراء.

5. تعرّف على وكيلك

افتح وكيل البرمجة لديك في مجلد المشروع حتى يرى الملفات. مع GitHub Copilot CLI، يكون ذلك:

copilot

ثم، لتأخذ فكرة، اطلب من الوكيل أن يوجّهك أنت (لا أن يغيّر شيئا بعد). جرّب توجيها مثل:

«أعطني جولة من فقرتين في هذا المستودع: ما الغرض من كل ملف ومجلد رفيع المستوى، وكيف أشغّل التطبيق والاختبارات. لا تغيّر شيئا.»

اقرأ إجابته مقارنة بما رأيته في الخطوتين 3–4. أن تألف طلبَ الوكيل أن يشرح قبل أن يعدّل عادةٌ جوهرية — سنعتمد عليها كثيرا.

---

✅ جرّبه مع وكيلك

1. اسأل الوكيل: «ماذا يطبع node bin/lockedin.js reflect 'كانت قهوتي باردة'، وأي ملف يقرر ذلك المخرَج؟» أكّد إجابته بتشغيل الأمر بنفسك.
2. اطلب منه تشغيل مجموعة الاختبار وإبلاغ النتيجة: «شغّل npm test وأخبرني كم عدد الاختبارات التي تنجح.»

رأيت الآن التطبيق، والاختبارات، والوكيل. تاليا، سننظر في لماذا هذه الشيفرة ودودة للوكيل — التصميم الذي يتيح لك تسليم التغييرات بثقة.

التالي: الدرس 2 كيف تعمل الشيفرة