كيف تعمل مع مطوّر على تطبيق بُني بالذكاء الاصطناعي

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

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

متى يكون المطوّر مفيدًا؟

أسباب شائعة لإحضار شخص:

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

وضوحك بشأن أي هذه الأسباب هو ما يشكّل كل ما يلي.

الخطوة 1: ضع الكود في مكان قابل للمشاركة

يعمل المطوّرون من مستودعات Git. قبل أن تتواصل مع أي أحد:

1. اربط المشروع بمستودع خاص على GitHub (أو خدمة مشابهة)، أو صدّره.
2. تأكد من ألا توجد أسرار في الكود أو في سجله. راجع كيف تحافظ على مفاتيح API آمنة.
3. تحقق من أن المشروع يعمل من نسخة جديدة. اطلب من الذكاء الاصطناعي كتابة خطوات الإعداد.

اكتب ملف README لمطوّر ينضم إلى هذا المشروع: ماذا يفعل التطبيق، والتقنيات المستخدمة، وكيف يُثبَّت ويُشغَّل محليًا، ومتغيرات البيئة التي يحتاجها (الأسماء فقط)، وبنية المجلدات، وأي شيء هش أو غير معتاد.

إذا كان Git جديدًا عليك، فإن كيف تستخدم Git مع تطبيق بُني بالذكاء الاصطناعي يغطي الأساسيات.

الخطوة 2: اكتب موجزًا من صفحة واحدة

لم يحضر المطوّر سجل محادثاتك. أعطه السياق في صفحة واحدة:

• ما الذي يفعله التطبيق، ولمن، وكم عدد الأشخاص الذين يستخدمونه.
• ما الذي يهم أكثر: المسارات التي يجب ألا تتعطل أبدًا.
• المشكلات المعروفة وما الذي جربته لحلها.
• المهمة، وكيف ستعرف أنها اكتملت.
• القيود: الميزانية، والموعد النهائي، والأشياء التي لا يجب أن يغيّرها.

تعريف «الاكتمال» الجيد قابل للاختبار: «يستطيع المستخدم المسجّل الدخول أن يدفع لخطة شهرية عبر Stripe Checkout، وتظهر الخطة في صفحة حسابه، وإلغاء الاشتراك من بوابة العميل يخفّض مستواه في نهاية الفترة.» وليس «أصلح المدفوعات».

الخطوة 3: امنح الوصول بأمان

• الكود: أضفه متعاونًا على المستودع. لا ترسل ملفات ZIP ذهابًا وإيابًا بعد أن يبدأ العمل.
• أداة البناء: إذا كانت أداة بنائك تدعم أعضاء الفريق، فادعه إلى مساحة عمل تحتوي هذا المشروع فقط.
• الأسرار: أضفها في إعدادات الاستضافة، أو شاركها عبر مدير كلمات المرور. لا تلصق المفاتيح في البريد الإلكتروني أو المحادثة أبدًا.
• حسابات الاختبار: أنشئها ببيانات تجريبية، بدلًا من مشاركة تسجيل دخولك أنت.
• بيانات الإنتاج: فقط إذا كان يحتاجها فعلًا، وفقط ما يحتاجه.

أبقِ المستودع ونطاق الموقع وحسابات الاستضافة باسمك أنت. أضف أشخاصًا، ولا تسلّمهم حساباتك.

الخطوة 4: اتفقا على من يغيّر ماذا

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

أيًا كان ما تختاره: اسحب أحدث كود قبل كل جلسة كتابة، واجعل التغييرات الكبيرة على فروع يستطيع الآخر مراجعتها.

الخطوة 5: تواصل كتابةً

• أبلغ عن المشكلات بالخطوات، والنتيجة المتوقعة والفعلية. راجع كيف تكتب تقرير خطأ جيدًا.
• احتفظ بالقرارات في مكان واحد: متتبع مشكلات، أو مستند مشترك، أو تعليقات طلبات السحب.
• اطلب منه أن يشرح التغييرات بلغة واضحة في كل طلب سحب.
• اتفقا على وتيرة المتابعة.

الخطوة 6: راجع عمله

لا تحتاج إلى قراءة الكود لتراجع العمل. تحقّق من:

• أنه يفعل ما يقوله الموجز، في المعاينة أو نسخة التجربة.
• أنه لم يكسر شيئًا آخر، بتشغيل المسارات الحرجة.
• أنه شرح ما غيّره ولماذا.
• عدم ظهور أي أسرار في الكود.

للمراجعة الأدق، يقدّم كيف تراجع الكود المولّد بالذكاء الاصطناعي قائمة فحص تنفع مع الكود المكتوب بيد البشر أيضًا. ويمكنك أن تطلب من أداة البناء شرح طلب السحب لمطوّر بلغة بسيطة.

الخطوة 7: حافظ على وضوح الملكية

• تبقى المستودعات والاستضافة والنطاق وحسابات الطرف الثالث باسمك.
• دوّن ملكية الكود الذي يكتبه المطوّر قبل بدء العمل. وراجع القوانين المحلية أو مستشارًا في المسائل التعاقدية.
• عند انتهاء العمل، أزل صلاحيات الوصول وأعد تدوير أي مفاتيح اطلع عليها.

أمثلة على الطلبات

قام المطوّر بتغيير كود الدفع في آخر طلب سحب. اشرح بلغة بسيطة ما الذي غيّره، وهل يعتمد أي شيء آخر في التطبيق عليه.

اسرد أكثر أجزاء هذا التطبيق تعقيدًا أو خطرًا، حتى أستطيع أن أخبر المطوّر بأين يركّز المراجعة.

سأسلّم المدفوعات إلى مطوّر. من الآن فصاعدًا، لا تعدّل أي ملفات داخل src/payments أو مسارات /api/billing. إذا احتاج تغيير إليها، فأخبرني بدلًا من ذلك.

أخطاء شائعة

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

قائمة التحقق

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

العمل مع مطوّر على Mythex

• ادعه إلى مساحة عمل. يستطيع المالكون دعوة متعاونين بلا حد دون رسوم لكل مقعد، ويعمل الأعضاء على مشاريع مساحة العمل. استخدم مساحة عمل منفصلة كي لا يرى إلا هذا المشروع. تُحمَّل أرصدة التطبيقات المنشورة على مالك مساحة العمل. راجع الدعوات.
• المزامنة مع GitHub والتصدير (Pro). اربط مستودعًا وادفع واسحب عليه، أو صدّر المشروع مع استبعاد الأسرار. راجع GitHub والتصدير والاستيراد.
• شارك رابط معاينة لعرض العمل الجاري على شخص ليس لديه حساب في Mythex، واحذفه حين تنتهي.
• وضع الأسئلة يجيب عن أسئلة حول الكود دون تغييره، وهو مفيد لفهم تغييرات المطوّر.

إذا كان المطوّر سيشغّل التطبيق في مكان آخر، فراجع كيف تصدّر تطبيقًا بناه الذكاء الاصطناعي وتستضيفه بنفسك.

الأسئلة