كتابة مطالبات أفضل

تشريح المطالبة الجيدة

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

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

ما يجب تضمينه دائماً

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

أمثلة ضعيفة مقابل قوية

الفرق بين المطالبة الضعيفة والقوية هو عادةً التحديد، لا الطول. إليك مقارنة جنباً إلى جنب لفكرة التطبيق نفسها:

# Weak prompt — vague, forces guessing
Build me a task manager app.

# Strong prompt — concrete, covers all four dimensions
Build a team task manager for small marketing agencies.

Users: two roles — Agency Admin and Team Member.
- Admins can create projects, assign tasks, and view all activity.
- Team Members can view their assigned tasks, update status, and
  leave comments.

Data: Projects contain Tasks. Tasks have a title, description,
due date, priority (low/medium/high), status (todo/in-progress/done),
and an assignee (Team Member).

Stack: React frontend, FastAPI backend, PostgreSQL database.

The main view is a Kanban board grouped by status. Include email
notifications when a task is assigned or overdue.

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

مطالبات التكرار

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

# Good iteration prompt
On the Task detail page, add a Comments section below the task
description.

- Users can type a comment (up to 500 characters) and submit it.
- Comments display the author's name, avatar, and a relative
  timestamp ("2 hours ago").
- Comments load on page load; no infinite scroll needed yet.
- Only the comment author or an Admin can delete a comment.

ما يجب ألّا تضمّنه

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

استخدام الصوت للعصف الذهني أولاً

وضع الصوت (⌘ ⇧ P) هو أحد أسرع الطرق للوصول إلى مطالبة مكتوبة عالية الجودة. تحدّث بشكل طبيعي لمدة ٦٠–٩٠ ثانية عمّا تريد بناءه — ما المشكلة التي يحلّها، ومن يستخدمه، وما الميزة الأهم. يحوّل مايندلاب كلامك نصّاً ويهيكله في مسوّدة مطالبة، يمكنك بعدها مراجعتها وإحكامها قبل الضغط على ابنِ.

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