مهارة رسمية · المنتج

مراجعة المواصفات قبل البناء

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

تعمل في Claude وChatGPT ووكلاء البرمجة. في Team وBusiness، تتحدّث المهارة الرسمية في Pod فريقك تلقائيًا كلما حسّنّاها.

متى تستخدمها

ما تعطيه لها

ما تحصل عليه

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

كيف تعمل

  1. امشِ في المسار كمستخدم جديد ابدأ من حيث يصل المستخدم (رابط في بريد، عنصر في القائمة، حساب فارغ) وصِف كل خطوة: ماذا يرى، وماذا عليه أن يقرر، وعلى ماذا ينقر. وحيثما لا تقول المواصفات ماذا يظهر بعد ذلك، سجّل ثغرة. وحيثما تحيّر تسميةٌ أو سؤالٌ شخصًا جديدًا، سجّلها.
  2. افحص حالات كل شاشة لكل شاشة أو مكوّن، ابحث عن: الحالة الفارغة (أول استخدام، لا نتائج)، والتحميل، والخطأ، والبيانات الجزئية، وغياب الصلاحية، والنجاح. توصي NN/g بأن تُظهر الحالة الفارغة وضع النظام، وتعلّم المستخدم كيف يبدأ، وتعطيه طريقًا مباشرًا إلى المهمة، وألا تظهر رسالة «لا توجد سجلات» والبيانات ما زالت تُحمَّل. ويجب أن تكون رسائل الخطأ ظاهرة، بلغة بسيطة، بنّاءة، وتحافظ على ما أدخله المستخدم.
  3. ابحث عن الكلمات الغامضة ضع علامة على «سريع»، «سهل»، «بسيط»، «بديهي»، «ينبغي»، «إلخ»، «و/أو»، «بعض»، «حسب الحاجة». كل واحدة تحتاج إلى رقم أو قائمة أو قرار. وضع علامة على أي متطلب يمكن لقارئين أن يختبراه بطريقتين مختلفتين.
  4. افحص القواعد والحدود من يستطيع فعل هذا؟ كم مرة أو كم عددًا؟ ماذا يحدث عند الحد؟ وماذا عن البيانات والمستخدمين الحاليين عند الإطلاق؟ الإجابات الغائبة مانعة إذا كانت تغيّر نموذج البيانات.
  5. افحص المقاييس يجب أن يوجد مقياس أساسي واحد مرتبط بالمشكلة، وخط أساس، وهدف، وطريقة قياس. وإذا كان الحدث المطلوب عدّه غير موجود بعد، فهذا متطلب ناقص في المواصفات.
  6. افحص الإطلاق والتراجع هل الميزة خلف مفتاح تفعيل (feature flag)؟ من يراها أولًا (الفريق الداخلي، نسبة مئوية، شريحة)؟ أي مقياس يستدعي التراجع، وهل يمكن إيقافها دون إصدار جديد؟ إرشادات Martin Fowler عن مفاتيح الميزات تفرّق بين مفاتيح الإصدار، والإطلاق التدريجي بالنسب المئوية، ومفاتيح الإيقاف الطارئ (kill switch)؛ ومفتاح الإيقاف يجب أن يُقلب بسرعة، دون إصدار جديد.
  7. رتّب الملاحظات واكتبها مانع = لا يستطيع الفريق بناءها أو اختبارها، أو فيها خطر على البيانات أو الثقة. يُستحسن إصلاحه = سيسبب إعادة عمل أو ارتباكًا. ملاحظة صغيرة = صياغة. كل ملاحظة تقتبس المواصفات، وتقول لماذا تهم، وتقترح إصلاحًا أو سؤالًا.

شاركها مع فريقك

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

أضِفها إلى Pod فريقي

سجل التغييرات

المصادر

  1. Designing Empty States in Complex Applications: 3 Guidelines - NN/G (قُرئ في 2026-11-04)
  2. Error-Message Guidelines - NN/G (قُرئ في 2026-11-04)
  3. Feature Toggles (aka Feature Flags) (Martin Fowler) (قُرئ في 2026-11-04)