رسالة البداية لوكيل البرمجة

مهارة hasanat-builder تعطي وكيل البرمجة مسارًا واضحًا: يصقل معك نتيجة أولى صغيرة، وينسخ القالب الرسمي، ويشغّله على جهازك، ويتحقق من الصفحة قبل أن يضيف تسجيل الدخول أو قاعدة البيانات أو النشر.

تعمل الرسالة مع وكلاء البرمجة الذين يستطيعون تشغيل الأوامر وقراءة الملفات، مثل GitHub Copilot أو Claude Code أو Cursor.

ثلاث خطوات

راجع المصدر. اقرأ تعليمات المهارة قبل أن تمنحها للوكيل.
انسخ الرسالة كما هي والصقها في وكيل البرمجة. لا تحتاج إلى تعديل أي جزء منها.
أجب عن سؤاله الأول: سيبدأ بسؤالك عمّا تريد بناءه.

الرسالة

ساعدني في بدء مشروع صغير يعمل ضمن حسنات.

ابدأ بسؤالي: ما الذي أريد بناءه؟ لا تطلب مني تعديل هذه الرسالة أو إعادة كتابتها. بعد إجابتي، اسأل سؤالين قصيرين كحد أقصى، وفقط عند الحاجة، لتحديد:

- لمن ستكون النسخة الأولى، وما المشكلة التي تحلها؛
- الفعل المفيد الوحيد الذي يجب أن تدعمه أول صفحة محلية.

بعد ذلك لخّص المرحلة الأولى في جملة واحدة، ثم تابع دون أن تطلب مني إعداد وثيقة متطلبات.

تحقق أولاً مما إذا كانت مهارات حسنات الخمس متاحة: hasanat-builder وhasanat-auth وhasanat-d1 وhasanat-design وhasanat-deploy. إن كانت أي منها غير متاحة:

1. نزّل الحزمة الكاملة الموثقة وملف البيان وأداة التحقق من https://platform.hasanat.dev/skills/ إلى مجلد مؤقت: hasanat-skills.skill وhasanat-skills.manifest.json وverify-hasanat-skills.mjs.
2. شغّل node verify-hasanat-skills.mjs hasanat-skills.skill hasanat-skills.manifest.json. لا تثبّت الحزمة إن فشل التحقق. ثم اعرض محتوياتها باستخدام unzip -l وتحقق من احتوائها على مجلد لكل مهارة من المهارات الخمس. اشرح باختصار أن المهارات تعليمات وسكربتات سيتبعها وكيل البرمجة.
3. اطلب موافقتي مرة واحدة قبل تثبيت المهارات الناقصة، ولا تستبدل أي مجلد مهارة موجود.
4. بعد الموافقة، أنشئ .agents/skills داخل المشروع الحالي وفك الحزمة هناك:

mkdir -p .agents/skills
unzip -n <temporary-path>/hasanat-skills.skill -d .agents/skills

ثم حمّل مهارة hasanat-builder واتبعها، وحمّل المهارات المساندة فقط عندما تصل إلى تسجيل الدخول أو قاعدة البيانات أو التصميم أو النشر.

اجعل المرحلة الأولى محددة: عرّف نتيجة واحدة مفيدة للصفحة الأولى، انسخ قالب حسنات الرسمي العام عبر HTTPS إلى مجلد جديد، ثبّت الاعتماديات المقفلة، انسخ .env.example، شغّل خادم التطوير، وتحقق من الصفحة في المتصفح. لا تشترط تسجيل GitHub أو OAuth أو D1 أو النشر أو أي أسرار قبل أن أرى صفحة تعمل محليًا. بعد ذلك واصل معي تشكيل الفكرة وتنفيذها.

ماذا سيحدث

يسألك الوكيل عمّا تريد بناءه، ثم سؤالين قصيرين على الأكثر عند الحاجة.
يلخّص المرحلة الأولى في جملة واحدة.
يتحقّق من وجود المهارات الخمس. إن نقص بعضها نزّل الحزمة إلى مجلد مؤقت، وتحقّق منها، وطلب موافقتك مرة واحدة قبل التثبيت. التفاصيل في حزمة المهارات.
ينسخ القالب، ويثبّت الاعتماديات، ويشغّل خادم التطوير، ويفتح الصفحة في المتصفح.

إن كنت تعمل على مشروع له مواصفات

ابدأ برسالة القسم 12 في مواصفات المشروع بدل هذه الرسالة، لأنها توجّه الوكيل إلى الموجز والمواصفات أولًا. انظر من المواصفات إلى النسخة الأولى.

إن لم يستطع وكيلك تنزيل الملفات

نزّل الحزمة وتحقّق منها بنفسك باتباع حزمة المهارات، ثم الصق الرسالة.