عندما تبني مشروعًا بمساعدة الذكاء الاصطناعي، قد تجد نفسك تكرر التعليمات نفسها: افهم المشروع أولًا، اختر الأدوات المناسبة، اختبر التعديل، ثم راجعه قبل أن تعلن اكتماله. ومع تعدد المهارات والمساعدين، تصبح إدارة هذه الخطوات عملًا بحد ذاتها.
لهذا بنيت Setup & Start: مهارة مفتوحة المصدر تمنح مساعد البرمجة مدخلًا واحدًا، وتوجّهه إلى الإرشادات المناسبة للمرحلة التي يعمل عليها. الهدف أن تصبح طريقة الانتقال من الطلب إلى التنفيذ والتحقق أوضح، وأن يحمل المساعد ما يحتاجه من تعليمات في الوقت المناسب.
استكشف مشروع Setup & Start وكوده على GitHub
المشكلة: امتلاك مهارات كثيرة لا يكفي
تطوير واجهة عربية يختلف عن إصلاح واجهة برمجية أو تجهيز تطبيق سطح مكتب. وحتى داخل المهمة الواحدة، تتغير الحاجة بين التخطيط والكتابة والاختبار والمراجعة. تحميل كل الإرشادات دفعة واحدة يزيد المحتوى الذي على المساعد التعامل معه، بينما اختيارها يدويًا في كل خطوة يضيف عبئًا على المستخدم.
يعالج المشروع هذه المشكلة بكتالوج محلي للإرشادات وآلية توجيه تراعي نوع الطلب ومرحلة العمل. يختار الموجّه ثلاث حزم إرشادية كحد أقصى في المرحلة الواحدة، من مجالات تشمل الواجهات والخوادم وتطبيقات سطح المكتب والجوال والأتمتة والأمان وWordPress.
تتضمن قواعد المطابقة كلمات عربية وإنجليزية، مثل «واجهة» و«تصميم» و«قاعدة البيانات» و«اختبار». وهذا يجعل الطلب العربي جزءًا من تصميم آلية الاختيار نفسها.
ما الذي تحصل عليه عند استخدامه؟
- نقطة بداية واحدة: تستدعي مهارة setup-and-start، ثم تُحمّل المراجع المتخصصة عند الحاجة.
- مسار عمل واضح: تخطيط وتنفيذ، ثم اختبارات ومراجعة وإصلاحات محدودة عندما تتوفر أدوات التشغيل المطلوبة.
- تقارير أكثر دقة: يميز المشغّل المحلي بين اختبارات نُفذت، ومراجعة متاحة، وأجزاء لم يكتمل التحقق منها.
- أدوات اختيارية للتوسع: مساعد Python محلي لتوجيه الطلبات وفحص البيئة، مع خيارات لتشغيل أدوات البرمجة وإدارة محاولات الإصلاح.
المهارة مصممة للعمل مع Claude Code وCodex وOpenCode والمساعدين المتوافقين مع معيار Agent Skills. أما الأتمتة المحلية فتتوقف على الأدوات المثبتة وصلاحياتها وإعداداتها الفعلية.
مثال عملي: بناء واجهة عربية للمخزون
بعد تثبيت المهارة، يمكن أن تبدأ بطلب مثل:
استخدم setup-and-start لبناء تطبيق ويب عربي لإدارة المخزون، يعمل على الهاتف، مع اختبارات للوظائف الأساسية.
هذا مثال للاستخدام، وليس عرضًا لنتيجة جرى تنفيذها ضمن هذا المقال. في مثل هذا الطلب، تساعد إرشادات الواجهات على تحديد تجربة المستخدم واتجاه الكتابة من اليمين إلى اليسار، ثم تتغير الإرشادات المطلوبة مع الانتقال إلى اختبار السلوك ومراجعة التعديلات.
يمكن أيضًا معاينة اختيار الحزم وخطة المراحل باستخدام المساعد المحلي قبل استدعاء نموذج أو بدء تنفيذ تعديلات. بهذه الطريقة تستطيع فهم المسار المقترح قبل استخدام خيارات التشغيل التلقائي.
كيف تبدأ؟
يوثق المستودع أمر التثبيت التالي للأدوات الثلاث. تحتاج إلى بيئة تدعم npx؛ المهارة نفسها لا تتطلب Python. أداة skills المستخدمة في التثبيت تابعة لطرف ثالث، فراجع ما تثبته والصلاحيات التي تستخدمها.
npx skills add amen78977/setup-and-start -s setup-and-start -a claude-code -a codex -a opencode -yثم افتح مساعد البرمجة الذي تستخدمه واطلب منه استخدام setup-and-start في مهمة محددة. وللتثبيت العام أو استخدام مساعد Python ومتطلبات التشغيل الاختيارية، راجع دليل الاستخدام في المستودع.
للتجربة الأولى، اختر مشروعًا تجريبيًا ومهمة صغيرة تستطيع مراجعة نتيجتها. خيارات التنفيذ المحلي قد تطلب من أدوات البرمجة تعديل المشروع فعلًا؛ معاينة الخطة خطوة مناسبة قبل تفعيلها.
ما الذي يُظهره هذا المشروع من طريقة عملي؟
Setup & Start يجمع بين تصميم تجربة الاستخدام وبناء أدوات التنفيذ. الواجهة الأولى بسيطة: مهارة واحدة يستدعيها المستخدم. وخلفها توجد قواعد لاختيار المراجع، وخطط للمراحل، وشروط لقبول نتائج التحقق.
ومن الجوانب التي أركز عليها في هذا البناء:
- تصميم تدفق العمل: تحويل طلب مفتوح إلى مراحل لها متطلبات ونتائج يمكن مراجعتها.
- بناء أدوات قابلة للفحص: كتالوج محلي وموجّه مكتوب بـPython، مع اختبارات تغطي حالات الفشل وآليات المراجعة.
- الاهتمام بالعربية: دعم كلمات الطلب العربي وإرشادات الواجهات العربية وRTL.
- ربط الجودة بالأدلة: رفض اعتبار مجموعة اختبارات فارغة نجاحًا، وإظهار حدود المراجعة بدل اختزال كل الحالات في كلمة «تم».
هذه التفاصيل تقدم مثالًا على ما أحب بناءه: أدوات تجعل استخدام الذكاء الاصطناعي في مشروع حقيقي أكثر تنظيمًا وقابلية للمراجعة.
حالة المشروع وحدود ما يمكن توقعه
بحسب سجل التغييرات، الإصدار الموثّق وقت إعداد المقال هو v1.1.0 بتاريخ 12 أكتوبر 2026. يتضمن المستودع اختبارات آلية وتغطية لتكامل العمليات واختبار متصفح، إضافة إلى توثيق آليات التحقق وقياس النتائج.
حالة التحقق في 13 أكتوبر 2026: آخر تشغيل فحصناه نجح في مهام Linux واختبار المتصفح، وفشل في مهام Windows؛ لذلك لا أقدّم الإصدار الحالي على أنه مجتاز لجميع الفحوصات على كل الأنظمة. يمكنك متابعة التفاصيل في سجل الاختبارات.
كذلك، لا يضمن المشروع خلو الكود من الأخطاء أو خفض التكلفة في كل مهمة. اختيار عدد محدود من الإرشادات آلية موجودة في المشروع، لكن إثبات أثرها على التكلفة والوقت والجودة يحتاج إلى قياسات لمهام فعلية. لهذا يتضمن المستودع دليلًا لقياس النتائج يميز الأرقام المرصودة عن التقديرات.
جرّب الفكرة، أو ناقش معي طريقة عملك
إذا كنت تستخدم مساعد برمجة وتحتاج إلى تنظيم اختيار المهارات وخطوات التحقق، ابدأ باستكشاف المستودع وتجربته على مهمة صغيرة. وإذا كانت لديك طريقة عمل متكررة تريد تحويلها إلى أداة أو مسار أوضح، يمكننا مناقشة المشكلة والنتيجة التي تحتاجها.
ابدأ من مستودع Setup & Start · ناقش معي أداة أو سير عمل تريد بناءه
المقال مبني على README وسجل التغييرات وكتالوج الإرشادات ونتائج GitHub Actions العامة وقت إعداد المقال. راجع المستودع لمعرفة التحديثات اللاحقة.