مواصفة الميزة: المتطلبات وخطة تسليم على مراحل
آخر تحديث
حوّل طلبا من سطر واحد إلى معايير قبول وخطة على مراحل بسير العمل Discovery & Spec: وكلاء Researcher و Product Analyst و Project Planner.
ابدأ من هنا حين تكون الميزة ما زالت جملة واحدة في تذكرة. فسير العمل Discovery & Spec يحولها إلى متطلبات يستطيع أحد التحقق منها وخطة يستطيع أحد جدولتها، قبل كتابة أي كود للتطبيق.
الوكلاء الذين يعملون
- الأعمال السابقة. يستطلع وكيل Researcher الكود والمكتبات والمراجع ذات الصلة بالميزة. ولتصدير الفواتير، يعني ذلك أين يستعلم عن الفواتير اليوم، وأي أدوات التسلسل (serializers) تستخدمها الخدمة أصلا.
- المتطلبات. يكتب وكيل Product Analyst المتطلبات مع معايير القبول وحدود النطاق.
- خطة التسليم. يقسم وكيل Project Planner العمل على مراحل، مع التبعيات بينها والمعالم وتقديرات الجهد.
تقرأ كل خطوة ما كتبته الخطوات السابقة.
ما تحصل عليه
- سجل ADR مقترح. تحفظ المتطلبات المتفق عليها تحت Plan → ADRs بحالة مقترح، ليقبلها شخص أو يرفضها.
- عناصر على لوحة Plan. تصبح عناصر القائمة في خطوة Delivery plan إدخالات على اللوحة، كل منها مربوط بالجلسة التي اقترحته.
- لا تغيير في الكود. سير العمل Discovery & Spec يكتب وثائق فقط، فتنتهي الجلسة دون فروقات ودون موافقة لتطبيق تغيير. ولإبقاء المواصفة في المستودع، ابدأ جلسة Plan, Build, Review & Test تطلبها ملفا في
docs/specs/. ويحصل ذلك التغيير على أمر الاختبار لديك، ومراجعة الملاحظات بالذكاء الاصطناعي، وموافقة بشرية كأي تغيير آخر، فتناقش المواصفة في طلب سحب حيث يعلق الفريق أصلا.
أعط الوكلاء الوقائع التي لا يستطيعون استنتاجها من الكود: من المستخدمون، والأحجام المتوقعة، وما هو خارج النطاق صراحة.
دع الوكلاء يقرؤون التذاكر لا يكتبونها
إذا كان نظام تتبع المشكلات لديك مربوطا بصفته خادم MCP بعيدا باسم "Tracker" (ومعرفه tracker)، فإن قواعد السياسة هذه تبعد أدوات الكتابة فيه عن كل جلسة، بينما تبقى أدوات القراءة متاحة:
[
{ "id": "tracker-no-create", "action": "mcp.invoke", "resource": "tracker/create_*", "decision": "deny" },
{ "id": "tracker-no-update", "action": "mcp.invoke", "resource": "tracker/update_*", "decision": "deny" }
]
قواعد mcp.invoke تأخذ allow أو deny، ولا تأخذ ask أبدا، والأداة المرفوضة لا تعرض على الوكلاء أبدا. وأسماء الأدوات تعتمد على الخادم الذي تربطه، فطابق الأنماط مع أسماء أدواته الفعلية. وجرب القواعد في وضع التسجيل فقط أولا لترى ما كانت ستمنعه.
ما الخطوة التالية
اقبل سجل ADR أو ارفضه، وافرز عناصر اللوحة، ثم ابن المرحلة الأولى باستخدام قالب الميزة الكاملة أو بجلسة Plan, Build, Review & Test أصغر لكل مرحلة.
الأسئلة الشائعة
هل تصل الخطة إلى لوحة Plan؟
نعم. حين تكتمل الجلسة، تصبح عناصر القائمة في خطوة Delivery plan إدخالات على لوحة Plan، حتى 50 في المرة الواحدة، مع تخطي العناوين الموجودة على اللوحة أصلا.
هل يستطيع وكيل Researcher قراءة نظام تتبع المشكلات لدينا؟
فقط عبر خادم MCP بعيد تربطه، وفقط الأدوات التي تسمح سياسة مساحة العمل بمرورها.