قالب PRD لوكلاء البرمجة بالذكاء الاصطناعي هو موجز قصير خاص بمهمة واحدة، يخبر Claude Code أو Cursor أو GitHub Copilot بمن يواجه المشكلة، وما الذي يجب أن يتغير، وما الذي يقع خارج النطاق، وأي فحوص تثبت أن العمل انتهى. احتفظ بقواعد المشروع الثابتة في CLAUDE.md أو AGENTS.md أو قواعد Cursor، واحتفظ بقرار الميزة في الـ PRD. القالب أدناه يتسع لصفحة أو صفحتين.
أهم النقاط
الوكلاء سريعون وكثيرًا ما يخطئون قليلًا. في استطلاع Stack Overflow لعام 2025، ذكر 66% من المطورين أن حلول الذكاء الاصطناعي «شبه الصحيحة، لكن ليست تمامًا» من أكبر مصادر الإحباط، وأبدى 86.9% قلقهم من دقة وكلاء الذكاء الاصطناعي (Stack Overflow, 2025).
يتفق مزوّدو الأدوات على أن ملفات تعليمات المشروع ينبغي أن تكون قصيرة وعامة: تستهدف Anthropic أقل من 200 سطر لكل ملف CLAUDE.md، وتنصح Cursor بإبقاء القواعد دون 500 سطر، ويحدّد موجّه التهيئة الخاص بـ GitHub تعليمات Copilot بصفحتين ويستبعد المحتوى الخاص بمهمة بعينها.
لذلك يحتاج قرار الميزة إلى مكان خاص به: PRD واحد لكل مهمة، يُربط من الـ issue أو الـ pull request.
القسم الذي يغيّر مخرجات الوكيل أكثر من غيره هو فحوص القبول. الوكيل الذي لديه فحص ينجح أو يفشل يستطيع اختبار عمله وإصلاحه بنفسه، أما الوكيل الذي لا فحص لديه فيتوقف حين يبدو العمل منتهيًا فقط.
كانت المتطلبات الغامضة مكلفة قبل الذكاء الاصطناعي أيضًا. وجد PMI أن سوء إدارة المتطلبات يقف وراء 47% من المشاريع التي أخفقت في تحقيق أهدافها (PMI, 2014).
ما هو قالب PRD لوكلاء البرمجة بالذكاء الاصطناعي؟
وثيقة متطلبات المنتج (PRD) الموجّهة إلى وكيل برمجة تجيب عن الأسئلة نفسها التي تجيب عنها أي PRD: مشكلة من هذه؟ وما الذي يجب أن يتغير؟ وكيف سنعرف أن الأمر نجح؟ الفرق في القارئ. المهندس البشري يسأل في Slack حين يكون شيء ما غامضًا، أما الوكيل فيختار عادةً تفسيرًا ويمضي.
يقولها دليل Claude Code من Anthropic صراحةً: يميل Claude إلى فهم الطلب بأضيق معانيه وبناء الحد الأدنى الذي يحققه، لأنه لا يستطيع أن يعرف إلى أي مدى كنت طموحًا (Anthropic, Claude Code best practices). الحل ليس موجّهًا أطول، بل موجز يذكر ما كان زميل بشري سيلتقطه وهو في الغرفة.
لماذا يحتاج وكلاء البرمجة بالذكاء الاصطناعي إلى PRD أصلًا؟
لأن الشيفرة لا تخبر الوكيل بأي مشكلة عميل هي المهمة، ولا بأي مقايضة قبلها الفريق، ولا بما هو خارج النطاق عن قصد. هذه الحقائق موجودة في المقابلات والتذاكر والاجتماعات. وإن لم يدوّنها أحد، يملأ الوكيل الفراغ بتخمين معقول.
صار استخدام الوكلاء معتادًا بما يكفي ليكون لذلك وزن. في استطلاع Stack Overflow لعام 2025، كان 84% من المشاركين يستخدمون أدوات الذكاء الاصطناعي أو ينوون ذلك، واستخدم 14.1% وكلاء الذكاء الاصطناعي في العمل يوميًا و9% آخرون أسبوعيًا. الثقة متأخرة عن الاستخدام: 46% لم يثقوا بدقة مخرجات الذكاء الاصطناعي، مقابل 33% وثقوا بها (Stack Overflow, 2025).
كان الغموض في النوايا مكلفًا قبل الوكلاء بزمن طويل. وجد بحث PMI لعام 2014 أن سوء إدارة المتطلبات تسبب في إخفاق 47% من المشاريع غير الناجحة في تحقيق أهدافها، وأهدر 5.1% من كل دولار أُنفق على المشاريع (PMI, 2014). مع الوكيل، يظهر الغموض نفسه في صورة pull request واثقة خلال دقائق بدلًا من مفاجأة في مراجعة السبرينت.
الأمان سبب آخر للوضوح. اختبرت Veracode أكثر من 100 نموذج لغوي كبير ووجدت أن 45% من عيّنات الشيفرة المولَّدة أدخلت ثغرة من قائمة OWASP Top 10، وبلغت نسبة الإخفاق 72% في عيّنات Java (Veracode, 2025). لن يعالج الـ PRD ذلك وحده، لكن قائمة «يُمنع» وفحص أمني مُسمّى يدلّان الوكيل والمراجع على موضع النظر.
ما الذي يدخل في CLAUDE.md أو AGENTS.md وما الذي يدخل في الـ PRD؟
قسّم السياق بحسب المدة التي يبقى فيها صحيحًا. ملفات تعليمات المستودع تحمل القواعد التي تسري على كل مهمة، والـ PRD يحمل قرار هذه المهمة. خلطهما يُسيء إليهما معًا: يتضخم ملف التعليمات ويضيع قرار الميزة فيه.
توثّق كل أداة ملفات تعليماتها وإرشادات الحجم الخاصة بها:
الأداة
ملفات تعليمات المشروع
إرشاد الحجم من المزوّد
خيار على مستوى المهمة
Claude Code
CLAUDE.md (نطاقات managed وuser وproject وlocal)، و.claude/rules/ مع مرشحات المسار؛ ويقرأ AGENTS.md عند غياب CLAUDE.md
استهدف أقل من 200 سطر لكل ملف
الإشارة إلى ملف spec عبر @path؛ أو اطلب من Claude أن يجري معك مقابلة ويكتب SPEC.md
Cursor
.cursor/rules/*.mdc (دائمة أو ذكية أو مطابِقة للملفات أو يدوية)؛ وAGENTS.md بما فيها المتداخلة
أبقِ القواعد دون 500 سطر
الإشارة إلى ملف الـ PRD بـ @ في الدردشة
GitHub Copilot
.github/copilot-instructions.md و.github/instructions/*.instructions.md مع applyTo؛ وAGENTS.md أو CLAUDE.md أو GEMINI.md
موجّه التهيئة: لا يزيد على صفحتين وليس خاصًا بمهمة
ملفات الموجّهات، تُختار في كل دردشة
أي وكيل يدعم AGENTS.md
AGENTS.md؛ والغلبة للملف الأقرب إلى الشيفرة المعدَّلة
لا حقول إلزامية؛ يستخدمه أكثر من 60 ألف مشروع مفتوح المصدر
تفصيلان من وثائق المزوّدين يحددان هذا التقسيم. تقول Anthropic إن Claude يتعامل مع CLAUDE.md بوصفه سياقًا لا إعدادًا مفروضًا بالقوة، وإن الملفات الأطول تقلل الالتزام. وتصف وثائق Copilot من GitHub ملفات الموجّهات بأنها شيء تختاره في كل دردشة، بخلاف التعليمات التي تُطبَّق تلقائيًا (GitHub Docs). كلاهما يشير إلى الاتجاه نفسه: القواعد الدائمة في الملف الذي يُحمَّل دائمًا، والقرارات لمرة واحدة في ملف تسلّمه لتلك المهمة.
ضع في تعليمات المستودع:
أوامر البناء والاختبار وفحص الأنواع والـ lint، بما في ذلك كيفية تشغيل ملف اختبار واحد
المواضع التي تضلّل فيها الشيفرة، مثل نمط قديم يجب ألا تنسخه الشيفرة الجديدة
القرارات غير الظاهرة في الشيفرة: مساعد الأخطاء، وعملية النشر، وما يحتاج إلى مراجعة ترحيل
قواعد الأمان والخصوصية وإمكانية الوصول التي تسري في كل مكان
موضع قرارات المنتج، في صورة رابط
ضع في الـ PRD:
المستخدم والمشكلة والأدلة التي تقف خلفها
النتيجة ونقطة الأساس وحدود الأمان
ما هو داخل النطاق وخارجه و«يُمنع»
السلوك المطلوب، بما في ذلك حالات الفراغ والتحميل والخطأ
فحوص القبول والأوامر التي تتحقق منها
الأسئلة المفتوحة ومن يحسمها
تضيف وثائق Cursor قاعدة مفيدة للاثنين: أشِر إلى الملفات بدلًا من نسخ محتواها، فالنسخ تتقادم. اربط البحث ولا تلصقه.
قالب PRD قابل للنسخ لوكلاء البرمجة بالذكاء الاصطناعي
انسخه إلى docs/specs/<feature>.md أو إلى نص الـ issue. اجعل كل إجابة قصيرة، واربط البحث أو التصاميم أو الملاحظات التقنية للتفاصيل.
# PRD: [العنوان المؤقت]
المالك: [الاسم] | الحالة: مسودة / معتمد | التاريخ: [YYYY-MM-DD]
Issue / PR: [رابط]
## 1. المشكلة
- المستخدم الأساسي:
- الموقف والمشكلة (جملة واحدة):
- الأدلة: [روابط]. ضع على كل بند وسم: ملاحَظ / مستنتَج / مفترَض.
- لماذا الآن:
- ما لا نعرفه بعد:
## 2. النتيجة
- نتيجة المستخدم: ما الذي يصبح أسهل أو أسرع أو أكثر أمانًا؟
- إشارة المنتج: السلوك الذي يُظهر أن ذلك أفاد
- نقطة الأساس: [رقم + مصدر] أو "غير معروفة: قِس أولًا"
- حدود الأمان: ما يجب ألا يسوء (الأخطاء، الخصوصية، زمن الاستجابة، تحكم المستخدم)
## 3. النطاق
- داخل النطاق:
- خارج النطاق (Non-goals):
- يُمنع: [إجراءات أو آثار جانبية محظورة]
- الاعتمادات:
## 4. السلوك المطلوب
R1. نقطة الدخول والمسار الرئيسي بلغة بسيطة:
R2. حالات الفراغ والتحميل والخطأ:
R3. الصلاحيات ومعالجة البيانات:
R4. الحالات الحدّية التي تغيّر القرار:
## 5. السياق
- السلوك الحالي: [مسار أو شاشة أو ملف]
- القرارات ذات الصلة: [رابط إلى سجل القرارات]
- القيود المعروفة: [المنصة، التوافق، زمن الاستجابة، السياسة]
- قواعد المستودع: انظر CLAUDE.md / AGENTS.md
- إذا تعارض مصدران: توقف واسأل [المالك]
## 6. سلوك الذكاء الاصطناعي (فقط إذا كانت الميزة تستخدم نموذجًا)
- المدخلات التي يجوز للنموذج استخدامها:
- المخرجات المعروضة أو المحفوظة:
- الاستناد: أي مصدر يدعم كل ادعاء
- عدم اليقين: متى يقول "الأدلة غير كافية" أو يسأل
- التحكم البشري: أي الإجراءات تحتاج إلى مراجعة
- معالجة الإخفاق: انتهاء المهلة، مخرجات مشوهة، غياب الأدلة
- حالات التقييم: [رابط، بما فيها الأمثلة الصعبة والسلبية]
## 7. فحوص القبول
AC1. بافتراض [حالة]، عندما [إجراء]، فإن [نتيجة قابلة للملاحظة].
AC2. إذا [حالة غير مرغوبة]، فعلى النظام [بديل آمن].
AC3. بافتراض [مستخدم بلا صلاحية]، عندما [يفتحه]، فلا تظهر أي بيانات مقيَّدة.
AC4. الانحدار: [أمر الاختبار الحالي] ما زال ينجح.
التحقق عبر: [أوامر الاختبار وفحص الأنواع والـ lint والاختبار الشامل]
## 8. اتفاق تنفيذ الوكيل
1. اقرأ هذا الـ PRD وتعليمات المستودع قبل أي تعديل.
2. أعد صياغة المتطلب واذكر الأسئلة المفتوحة. انتظر الإجابات عن كل ما وُسم بـ "قرار".
3. اقترح خطة: الملفات التي ستتغير والاختبارات التي ستُضاف. انتظر الموافقة.
4. ابنِ أصغر شريحة تجتاز فحوص القبول.
5. توقف واسأل قبل أن تغيّر واجهة API عامة، أو تلمس المصادقة أو الفوترة أو الترحيلات، أو تضيف اعتمادًا، أو تحسم سؤالًا مفتوحًا.
6. شغّل أوامر التحقق والصق الأوامر ومخرجاتها.
7. لخّص السلوك المتغير والافتراضات والمخاطر المتبقية.
أي الأقسام أهم؟
ما لا نريده و«يُمنع». يكفي سطر واحد (مثل «لا منشئ لوحات معلومات جديدًا» أو «لا تغيّر تعريفات التقارير») لمنع وكيل معقول من تحويل طلب صغير إلى إعادة تصميم. بعض الأدوات تحجب فعلًا أخطر الإجراءات. فالوضع التلقائي في Claude Code مثلًا يحجب افتراضيًا عمليات النشر إلى الإنتاج والترحيلات وforce push ودمج pull request لم يوافق عليها أي إنسان (Anthropic, permission modes). وقائمتك تضيف المحظورات الخاصة بمنتجك التي لا تعرفها أي أداة: منطق التسعير، ونص الموافقة، وبريد إلكتروني موجّه إلى العملاء.
وثمة حدّ واحد: كل ما يُكتب في PRD أو CLAUDE.md هو إرشاد قد يقرر الوكيل أنه لا ينطبق. ونصيحة Anthropic أن القاعدة التي لا تحتمل استثناءات مكانها hook أو قاعدة منع أو إعداد مُدار، لا النثر (Anthropic, Claude Code best practices).
كيف تكتب معايير قبول يستطيع وكيل البرمجة بالذكاء الاصطناعي التحقق منها؟
اكتب كل فحص بحيث يعود بنتيجة نجاح أو فشل، وسمِّ الأمر أو الملاحظة التي تحسم ذلك. يسرد دليل Anthropic أنواع الفحوص التي يستطيع Claude قراءتها: ملف اختبار، أو رمز خروج لعملية بناء، أو linter، أو سكربت يقارن المخرجات بـ fixture، أو لقطة شاشة للمتصفح بجوار النموذج التصميمي.
صيغتان تُبقيان معايير القبول قابلة للاختبار:
Given / When / Then (بافتراض / عندما / فإن)، من التطوير الموجَّه بالسلوك: «بافتراض وجود عرض محفوظ، عندما يحذفه المستخدم، فإنه يختفي من الشريط الجانبي ولا تعيده واجهة API الخاصة بالقائمة بعد ذلك.»
EARS (Easy Approach to Requirements Syntax)، ابتكرها Alistair Mavin وزملاؤه في Rolls-Royce ونُشرت أول مرة عام 2009 (Mavin, EARS). وتستخدم خمسة أنماط:
نمط EARS
القالب
مثال من المنتج
Ubiquitous
على النظام أن …
على التصدير أن يتضمن صف عناوين.
Event-driven
عندما [المشغّل]، على النظام أن …
عندما يتجاوز الرفع 10 MB، على النظام أن يعرض حد الحجم.
State-driven
ما دام [الحالة]، على النظام أن …
ما دامت المزامنة جارية، على النظام أن يعطّل زر الحفظ.
Unwanted behaviour
إذا [الشرط]، فعلى النظام أن …
إذا لم يُرجع النموذج أي مصدر، فعلى النظام أن يضع على الموضوع وسم «غير مدعوم».
Optional feature
حيثما [الميزة]، على النظام أن …
حيثما فُعّل SSO، على النظام أن يخفي حقل كلمة المرور.
الأمثلة توضيحية. ونمط «إذا … فإن» هو الأنفع للوكلاء، لأن السلوك غير المرغوب هو الموضع الذي يخمّنون فيه.
ثم اطلب دليلًا لا حكمًا. توصي Anthropic بأن تسأل Claude عن الأمر الذي شغّله ومخرجاته، لأن مجرد الادعاء بأن الاختبارات تنجح دليل ضعيف. وكخط دفاع ثانٍ، اطلب من جلسة جديدة أو وكيل فرعي لم يكتب الشيفرة أن يراجع الـ diff مقابل الـ PRD.
مثال مكتمل: ملخصات المواضيع لنصوص المقابلات
هذا المثال توضيحي، وليس بحثًا من عميل حقيقي.
المشكلة. لدى فريق منتج من خمسة أشخاص 12 نص مقابلة موزعة على عدة مستندات. وقبل اجتماع التخطيط يريد رؤية المشكلات المتكررة دون أن يفقد أدلة المشاركين التي تقف خلف كل منها.
السلوك المطلوب. يختار أحد أعضاء الفريق النصوص ويطلب مسودة ملخص للمواضيع. يرتبط كل موضوع بالمقاطع التي تدعمه. ويعدّل العضو الملخص قبل مشاركته.
داخل النطاق. مسودات المواضيع، وروابط المصادر، وخطوة مراجعة قابلة للتعديل.
خارج النطاق. نشر المواضيع تلقائيًا، أو تغيير الـ roadmap، أو عرض عدد المواضيع من 12 مقابلة كأنه تقدير للسوق كله.
يُمنع. اختلاق اقتباس، أو نسبة قول إلى مشارك خاطئ، أو ادعاء تكرار لا تدعمه النصوص.
فحوص القبول.
بافتراض نص يتضمن مقطعًا عن مشكلة في الإعداد، عندما يتضمن الملخص هذا الموضوع، فإن القارئ يستطيع فتح المقطع الداعم نفسه بالضبط.
إذا لم يكن لموضوع ما مقطع داعم، فعلى النظام أن يضع عليه وسم «غير مؤكد» بدلًا من سدّ الفجوة.
بافتراض ملخص مولَّد، عندما يفتحه عضو الفريق، فإنه يستطيع تعديله قبل مشاركته.
بافتراض نص يحتوي معلومات شخصية، عندما تعالجه الميزة، فإن قواعد البيانات والوصول القائمة في الـ workspace تسري عليه.
نقطة الأساس. غير معروفة. قبل تحديد هدف، يقيس الفريق الوقت الذي يستغرقه العثور يدويًا على أدلة ثلاثة مواضيع، ويحصي تصحيحات المراجعين. ولا يفترض المثال أي تحسن بعينه.
كيف تسلّم الـ PRD إلى Claude Code أو Cursor أو Copilot؟
اكتب الـ PRD. اكتبه بنفسك، أو ابدأ من مولّد PRD المجاني، أو استخدم الموجّهات في كيف تكتب PRD بالذكاء الاصطناعي. في Claude Code يمكنك أن تطلب منه إجراء مقابلة معك حتى يستطيع كتابة الـ spec، ثم حفظها باسم SPEC.md.
ضعه حيث يستطيع الوكيل قراءته. احفظه في المستودع أو الـ issue وأشِر إليه بالمسار (@docs/specs/saved-views.md في Claude Code أو Cursor).
اطلب أولًا إعادة صياغة وخطة. يتيح وضع الخطة في Claude Code للوكيل القراءة والاستكشاف لكنه يمنع التعديل حتى توافق على الخطة. صحّح سوء الفهم هنا حيث لا يكلّف شيئًا.
ابنِ في جلسة جديدة. تقترح Anthropic بدء البناء في جلسة جديدة بعد وجود الـ spec، ليبدأ البناء بلا ثرثرة التخطيط ومعه الـ spec بوصفه تعريف الإنجاز.
أعد القرارات الجديدة إلى السجل. إذا كشف العمل عن قرار، حدّث الـ PRD أو سجل القرارات، لا الدردشة وحدها.
قبل أن تترك وكيلًا يعمل دون إشراف، تقترح Anthropic خمسة أسئلة: هل يعرف كيف يبدو «المنتهي»؟ وهل يستطيع فحص عمله بنفسه؟ وما الذي يُسمح له بلمسه؟ وما الذي يوقفه؟ ومن يعتمد النتيجة؟ والأقسام 3 و7 و8 من القالب تجيب عن أربعة منها.
متى تستخدم Spec Kit أو Kiro بدلًا من ذلك؟
استخدم سير عمل مواصفات منظّمًا حين تريد خط الإنتاج كله لا مجرد تسليم أفضل. يفصل Spec Kit من GitHub، وله نحو 150 ألف نجمة، بين الـ spec («ماذا نبني ولماذا») والخطة التقنية، ثم يولّد المهام والتنفيذ (GitHub, Spec Kit). ويقسّم Kiro كل spec إلى requirements.md وdesign.md وtasks.md (Kiro docs). القالب أعلاه يقابل خطوة المتطلبات: الأقسام من 1 إلى 4 والقسم 7. وإن كان فريقك يستخدم إحدى هاتين الأداتين فالصق أقسام المنتج في خطوة الـ spec فيها بدلًا من الاحتفاظ بمستندين.
ما الطول المناسب لـ PRD موجّه إلى وكيل برمجة بالذكاء الاصطناعي؟
بما يتناسب مع مخاطر التغيير. هذه النطاقات قاعدة تقريبية، وليست معيارًا مرجعيًا:
التغيير
ما يُضمَّن
الطول التقريبي
تصحيح نص أو تعديل صغير قابل للتراجع في الواجهة
المشكلة والنطاق وفحص أو فحصان
5-15 سطرًا
شريحة ميزة قياسية
الأقسام 1-5 و7 و8
نحو صفحة
الصلاحيات أو الفوترة أو البيانات الشخصية أو ادعاءات يولدها الذكاء الاصطناعي
القالب كاملًا بما فيه القسم 6 وفحص أمني ومراجع مسمّى
حتى صفحتين، مع روابط
الحد الأعلى يتبع المنطق نفسه الذي يطبقه المزوّدون على ملفات التعليمات. فكل سطر يتنافس على انتباه النموذج، ولذلك يُخفي PRD من خمس صفحات القيد الوحيد الذي كان مهمًا. وإذا تجاوز قسم نصف صفحة فالأرجح أنه يضم عدة قرارات؛ فقسّمه أو اربطه. وبالنسبة إلى PRD لإصدار كامل مكتوب للبشر، راجع كيف تكتب PRD.
أخطاء شائعة في PRD لوكلاء البرمجة بالذكاء الاصطناعي
لصق ويكي المنتج كاملًا. المزيد من السياق ليس سياقًا أفضل. اربط المصدرين أو الثلاثة التي تغيّر القرار.
وضع تفاصيل الميزة في CLAUDE.md أو AGENTS.md. هذان الملفان يُحمَّلان مع كل مهمة. وموجّه التهيئة من GitHub يُبقي المحتوى الخاص بمهمة بعينها صراحةً خارج ملف تعليمات Copilot.
متطلبات من نوع «اجعل الذكاء الاصطناعي دقيقًا». اذكر ما يستطيع المستخدم فحصه وما يفعله النظام حين لا يستطيع تلبية المتطلب.
اختلاق هدف. إن لم توجد نقطة أساس فاكتب «غير معروفة» وقِس أولًا.
قبول «تم» دون مخرجات. اطلب الأوامر ونتائجها.
ترك الوكيل يكتب الـ PRD الخاص به ويعتمده. يستطيع الوكيل صياغة مسودة، لكن على إنسان أن يؤكد المشكلة والأدلة والنطاق.
كتابة القواعد الصارمة نثرًا. «لا تلمس الترحيلات أبدًا» مكانها أيضًا قاعدة منع أو hook، إضافةً إلى الـ PRD.
أين يندرج Specky
يصوغ Specky مسودات PRD في محرر PRD الخاص به مع اقتباسات مضمّنة من مكالمات العملاء والتذاكر والملاحظات في Product Graph لديك، فيرتبط قسم الأدلة بمصادر حقيقية. ويتيح خادم MCP الخاص به لـ Claude Code وCursor وغيرهما من عملاء MCP تحميل هذا الموجز مباشرة: تُرجع get_coding_brief ملفات PRD والقرارات والأدلة ذات الصلة بتذكرة ما، وكل ما يكتبه الوكيل عائدًا يصل كمسودة للمراجعة البشرية. يوجد الإعداد في صفحة إعداد MCP لوكلاء الذكاء الاصطناعي.
الأسئلة الشائعة
هل يختلف PRD لوكيل برمجة بالذكاء الاصطناعي عن PRD عادي؟
الأسئلة نفسها: من لديه المشكلة، وما الذي يجب أن يتغير، وكيف ستعرف أن الأمر نجح. النسخة الموجّهة إلى الوكيل أقصر ومحصورة في مهمة واحدة وأكثر صراحةً بشأن ما لا نريده وقواعد التوقف والفحوص التي يستطيع الوكيل تشغيلها، لأن الوكيل يتصرف عند الغموض بدلًا من أن يسأل. اجعل الموجز متناسبًا مع حجم التغيير ومخاطره.
ما الطول المناسب لـ PRD موجّه إلى Claude Code أو Cursor؟
نحو صفحة لشريحة ميزة قياسية، وحتى صفحتين للتغييرات التي تمس الصلاحيات أو الفوترة أو البيانات الشخصية أو ادعاءات يولدها الذكاء الاصطناعي. اربط للتفاصيل. ويضع المزوّدون حدودًا متقاربة لملفات التعليمات: أقل من 200 سطر لكل CLAUDE.md، وأقل من 500 سطر لكل قاعدة Cursor، وألا يزيد موجّه التهيئة من GitHub على صفحتين.
هل يوضع الـ PRD في CLAUDE.md أو AGENTS.md؟
لا. يُحمَّل CLAUDE.md وAGENTS.md في كل جلسة، فينبغي أن يحويا قواعد المشروع الدائمة مثل الأوامر والاصطلاحات وقيود الأمان. ضع PRD الميزة في ملف مستقل أو في الـ issue وأشِر إليه في تلك المهمة. ورابط إلى موضع قرارات المنتج هو القدر المناسب من سياق المنتج لملف التعليمات.
هل يستطيع وكيل البرمجة كتابة الـ PRD بنفسه؟
يستطيع صياغة مسودة وتنظيم ملاحظاتك واقتراح حالات حدّية. وبإمكان Claude Code حتى أن يجري معك مقابلة ويكتب ملف spec. لكن على إنسان أن يؤكد مشكلة المستخدم والأدلة والنطاق وإشارة النجاح، لأن النص المولَّد ليس دليلًا على أن الفريق اتخذ تلك القرارات. تعامل مع PRD صاغه وكيل بوصفه مسودة.
ما هو التطوير الموجَّه بالمواصفات (spec-driven development)؟
التطوير الموجَّه بالمواصفات يعني كتابة مواصفة لما سيُبنى ولماذا قبل أن يخطط وكيل الذكاء الاصطناعي وينفّذ. يضفي Spec Kit من GitHub وKiro طابعًا رسميًا على ذلك في مراحل: المتطلبات أو الـ spec، ثم الخطة التقنية أو التصميم، ثم المهام، ثم الشيفرة. وقالب الـ PRD في هذه المقالة يغطي مرحلة المتطلبات.
كيف أكتب معايير قبول لوكيل برمجة بالذكاء الاصطناعي؟
اكتب كل معيار كعبارة تنجح أو تفشل مرتبطة بشيء يستطيع الوكيل تشغيله أو ملاحظته: اختبار أو بناء أو linter أو مقارنة fixture أو لقطة شاشة. استخدم صيغة Given/When/Then أو EARS، وضمّن حالة واحدة على الأقل من نوع «إذا ساء شيء، فإن»، واطلب من الوكيل لصق الأوامر ومخرجاتها.
GDPR-aligned. EU workspace data is stored in Frankfurt, Germany. GDPR and EU data Built in Vienna, Austria. A product of influence solutions fm GmbH (FN 675374y). Imprint 14-day trial. Card required, and nothing is charged until day 14. 30-day refund after subscribing. See pricing