دليل Prompt

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

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

دع الفريق يطرح الأسئلة قبل أن يبدأ بالبناء

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

اسألني عن أي شيء تحتاجه لفهم ما أريده بالكامل قبل أن تبدأ.

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

الخطوة 1: قرّر قبل أن تكتب

اعرف ما الذي تبنيه

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

غالبًا ما يُسمّى هذا الإجراء الرئيسي CTA، وهو اختصار لعبارة call to action. وهو الزر أو الرابط أو الخطوة التالية التي تريد من المستخدمين اختيارها أكثر من غيرها، مثل Sign Up أو Book a Demo أو Start Free أو Buy Now.

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

ابنِ موقعًا من صفحة واحدة لتطبيق ميزانية موجّه للعاملين المستقلين. الـ CTA الرئيسي هو “Start Saving Smarter.” استخدم مظهرًا جريئًا وتعبيريًا مع خطوط كبيرة وألوان لافتة.

ارسم الرحلة، وليس الشاشات فقط

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

حدّد التوجّه البصري مبكرًا

من الأسهل بكثير تأسيس الأسلوب من تعديله لاحقًا. اختر اتجاهًا: هادئًا وأنيقًا، أو جريئًا ومزعزعًا للمألوف، أو فاخرًا وانسيابيًا، واذكره في طلبك الأول باستخدام كلمات تصف النبرة ويمكن للفريق العمل بناءً عليها: minimal، playful، cinematic، developer focused. هذه الكلمات ليست مجرد زينة: فهي تشكّل الخطوط، والمسافات، والألوان، والظلال، واستدارة الزوايا منذ أول مكوّن. أعد استخدام سطر الأسلوب نفسه في الطلبات اللاحقة للحفاظ على التناسق.

استخدم تصميمًا هادئًا مستوحًى من العافية: تدرجات لونية ناعمة، وألوان ترابية هادئة، وزوايا مستديرة، وحشوات سخية. النبرة العامة لطيفة ومطمئنة.

الخطوة 2: اكتب طلبات تصل إلى الهدف

صف النتائج، لا طريقة التنفيذ

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

اعمل على أجزاء، لا على صفحات كاملة

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

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

استخدم كلمات حقيقية

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

عنوان القسم الرئيسي: “Design Calmly.” النص الفرعي: “Turn stress into structure.” CTA: “Start Building Free.” تخطيط متمحور حول النص مع مسافات عمودية سخية.

سمِّ العناصر الحقيقية

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

الطلبات المحددة أسهل في التنفيذ من الطلبات العامة. ابدأ بالعنصر الأساسي الذي تحتاجه، ثم أضف التفاصيل واحدًا تلو الآخر.

أنشئ بطاقة ملف شخصي تحتوي على صورة واسم وزر متابعة. أضف تسمية صغيرة “Verified” بجانب الاسم، وأظهر شرحًا قصيرًا عندما يمرر أحدهم المؤشر فوقها.

الخطوة 3: غيّر بدقة

حدّد نطاق كل تغيير: ما الذي يتغير وما الذي يبقى

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

غيّر نص الـ CTA إلى “Get Started” وزِد الحشوة الأفقية له. أبقِ الألوان الحالية والخط وكل شيء آخر في هذا القسم دون تغيير.

تغيير واحد ذو معنى في كل مرة

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

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

فكّر بخطوة تسبق واجهة المستخدم

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

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

الأسئلة الشائعة

كيف أكتب Prompt فعّالًا لـ AI agent؟

نظّم الـ Prompt باستخدام هذه العناصر الأساسية:

1. السياق — حدّد المشهد. اشرح ما الذي تبنيه وأين تقف الأمور حاليًا.

2. الهدف — كن محددًا بشأن النتيجة الدقيقة أو الميزة التي تريدها.

3. المتطلبات & القيود — اذكر بوضوح ما الذي يجب أن يتغير وما الذي يجب أن يبقى دون مساس.

4. النتيجة المتوقعة — حدّد كيف يبدو النجاح (مثلًا: سلوك واجهة المستخدم، ومعالجة الأخطاء، واستمرارية الحالة).

5. المراجع — أرفق لقطات شاشة، أو روابط، أو خطوات سير العمل، أو عينات من الكود كلما أمكن. أزل كلمات المرور، ورموز التحقق، ومفاتيح API، وملفات تعريف الارتباط، والبيانات الشخصية، وتفاصيل الدفع قبل المشاركة.

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

كيف أتعامل مع الطلبات المعقدة التي تتضمن ميزات متعددة؟

بالنسبة إلى الطلبات المعقدة، قسّمها إلى مهام أصغر:

1. اذكر المشكلة الحالية والهدف النهائي.

2. اسرد كل مهمة فرعية على حدة (المهمة 1، المهمة 2، المهمة 3).

3. تحقّق من كل مهمة قبل الانتقال إلى التالية.

4. اختبر التدفق الكامل في النهاية.

يقلّل هذا النهج من التغييرات غير المتوقعة الناتجة عن مطالبة Agent بتنفيذ الكثير دفعة واحدة. يجب أن يركّز كل Prompt على نتيجة واحدة قابلة للتحقق.

كيف أكتب Prompt لإصلاح خطأ برمجي؟

يجب أن يتضمن Prompt المفيد لإصلاح الأخطاء ما يلي:

• الصفحة، والميزة، والبيئة، والمستخدمون المتأثرون
• الخطوات الدقيقة لإعادة ظهور المشكلة
• السلوك الفعلي والسلوك المتوقع
• النص الكامل للخطأ ومتى حدث
• لقطات الشاشة أو السجلات ذات الصلة، مع إزالة كلمات المرور، وtokens، وملفات تعريف الارتباط، والبيانات الشخصية، وتفاصيل الدفع
• ما الذي يجب أن يبقى دون تغيير
• كيفية التحقق من الإصلاح وما فحوصات التراجع التي يجب تشغيلها

مثال: “في صفحة إتمام الشراء في Preview، يؤدي اختيار Submit إلى ظهور خطأ 500. المتوقع: يتم تأكيد الطلب ويصل المستخدم إلى صفحة الشكر. إعادة الظهور: [steps]. أصلح السبب دون تغيير إجماليات السلة أو تدفق الدفع، ثم تحقّق من حالة دفع ناجحة وأخرى مرفوضة. لقد أزلت جميع القيم السرية من السجل المرفق.”

كيف أكتب Prompt لتعديل تخطيط الصفحة أو تنسيقها؟

عند طلب تعديلات على الصفحة، ضمّن ما يلي:

1. الصفحة، والوحدة، والعنصر المحدد المراد تعديله.

2. الحالة الحالية والنتيجة المستهدفة.

3. الروابط المرجعية أو لقطات الشاشة.

4. الميزات التي يجب أن تبقى دون تغيير.

5. معايير القبول (مثلًا: يجب أن يعمل على كل من desktop وmobile).

مثال: "في صفحة /pricing، غيّر شبكة بطاقات الباقات من عمودين إلى 3 أعمدة على desktop. أبقِ تخطيط mobile كعمود واحد. ارجع إلى لقطة الشاشة هذه [attach]. لا تغيّر محتوى البطاقة أو أنماط الأزرار."

ماذا يجب أن أفعل عندما يستمر الـ agent في إجراء التغييرات الخاطئة رغم التصحيحات؟

عندما يخطئ Agent مرارًا في الوصول إلى المطلوب، فإن إضافة المزيد من التعليمات قد تسبب أحيانًا مزيدًا من الارتباك. بدلًا من ذلك:

1. حافظ على الحالة الحالية — توقّف عن إرسال تصحيحات متداخلة. إذا كانت دردشتك تعرض عنصر تحكم Revert، فاقرأ نص التأكيد قبل استخدامه، ودوّن أي تغييرات لاحقة تحتاج إلى الاحتفاظ بها، وتحقق من المشروع بعد ذلك. إذا كان النطاق غير واضح، فلا تتابع؛ استخدم إرشادات دردشة المشروع أو تواصل مع الدعم مع Chat Link منقّح ولقطة شاشة.

2. أزل الضوضاء — بدلًا من إضافة تعليمات إضافية فوق التعليمات الحالية، أعد صياغة المشكلة الأساسية بوضوح من الصفر.

3. مهمة واحدة في كل مرة — ركّز على إصلاح مشكلة واحدة قبل الانتقال إلى التالية.

إن التراجع خطوة إلى الوراء ومعالجة التغييرات بشكل تدريجي يحل المشكلات عادةً بسرعة أكبر بكثير من محاولة إصلاح عدة مشكلات متداخلة في Prompt واحد.