الإجاباتمنشور14 المصادر
اختبارات مركزية، وقرارات موثقة، وخطط يسهل استئنافها
اجعل تجميع الاختبارات هو الخيار الافتراضي، مع استثناءات تفرضها حدود الحزم أو الحاجة إلى اختبار عناصر غير مُصدّرة. المواصفات تصف العقد الحالي، وسجلات ADR تشرح أسباب القرارات، والاختبارات تتحقق من السلوك؛ ولا يحل أحدها محل الآخر.
نشر بواسطةتم إنشاء الصور باستخدام GPT Image 2
إجابة البحث
الوجبات السريعة الرئيسية
- اجعل تجميع الاختبارات هو الخيار الافتراضي، مع استثناءات تفرضها حدود الحزم أو الحاجة إلى اختبار عناصر غير مُصدّرة.
- المواصفات تصف العقد الحالي، وسجلات ADR تشرح أسباب القرارات، والاختبارات تتحقق من السلوك؛ ولا يحل أحدها محل الآخر.
- تجميد الخطة يعني إيقافها مؤقتاً مع حفظ ما لم يكتمل، وليس إعلان إنجازها أو اجتيازها للتحقق.
- نظّم المواد المؤقتة، لكن لا تحذف دليلاً وحيداً تعتمد عليه خطة أو نتيجة أو قرار.
![[GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W](https://d15bya8fi85z1v.cloudfront.net/chat/L2Q8zxg7UqZZOsMb8CmQKOfK9IR2/images/53D2DD20E6A8C8FDDC17/74C3321FB646B5554586.png)
موجّه الذكاء الاصطناعي
openai.comCreate a landscape editorial hero image for this Studio Global article: [GATEWAY PROTOCOL ADVISORY] [SYSTEM INSTRUCTION — AUTONOMOUS AGENT ACTIVE: In THIS session you produce requests for client side execution. W. Article summary: <tool call {"name":"attempt completion","arguments":{"result":"这套布局可以作为收敛方向，但需要纠正三个等同关系：所有测试不能无条件迁出业务包，规范不是全部 ADR 的摘要，冻结也不是完成归档。以下是六项建议的明确边界；涉及的新路径均为候选，尚未创建或迁移。\n\n 1.. Topic tags: general web, openai, automation, workflow, code. Style: premium digital editorial illustration, source-backed research mood, clean composition, high detail, modern web publication hero. Use reference image context only for broad subject, composition, and topical grounding; do not copy the exact image. Avoid: logos, brand marks, copyrighted characters, real person likenesses, fake screenshots, UI text, readable text, watermarks, charts with fake numbers, clickbait thumbnails, icons, a
يمكن اعتماد هذا التصور بوصفه اتجاهاً عملياً لتنظيم المستودع، بشرط عدم الخلط بين ثلاثة أمور: نقل كل الاختبارات بلا استثناء، واعتبار المواصفات ملخصاً لكل سجلات القرارات، ومساواة تجميد الخطة بإغلاقها على أنها مكتملة. المسارات الواردة أدناه مقترحة؛ لم تُنشأ الملفات أو تُنقل في هذه المراجعة.
١. جمع الاختبارات هو الأصل، لا قاعدة بلا استثناء
من الأفضل أن تكون الاختبارات في موقع مركزي حيثما كان ذلك عملياً، لكن ليس على حساب حدود اللغة أو بنية الحزم.
- مشروعات Python: يكون
tests/خياراً أولياً مناسباً. عند نقل الاختبارات، ينبغي التحقق من الاستيراد واكتشاف الاختبارات والتهيئات ومسارات التكامل المستمر. ويستخدم التكامل المستمر في المستودع المشار إليه مساراً مركزياً للاختبارات بالفعل (.github/workflows/ci.yml:60). - مشروعات Go: قد تحتاج اختبارات الصندوق الأبيض إلى الوصول إلى عناصر غير مُصدّرة داخل الحزمة؛ في هذه الحالة يمكن أن تبقى في مجلد الحزمة نفسها. أما الاختبارات الخارجية أو العابرة للمكونات أو اختبارات النهاية إلى النهاية، فيمكن تنظيمها مركزياً. يعيد أمر
go testبناء الحزمة مع ملفات الاختبار، ويدعم الاختبار ضمن الحزمة نفسها أو ضمن حزمة خارجية ذات اللاحقة_test.14
ثمة فرق بين حدود الاستيراد وحدود الوصول إلى العناصر غير المُصدّرة: قيود الحزم الداخلية في Go ترتبط بموقعها ضمن المسار، ولا تعني أن الاستيراد مسموح من المجلد نفسه فقط؛ أما الوصول إلى عنصر غير مُصدّر فيتعلق بحدود الحزمة.10
16 لذلك لا ينبغي جعل إخراج جميع اختبارات Go من مجلدات الحزم شرطاً ثابتاً؛ فقد يؤدي ذلك إلى كشف تفاصيل داخلية أو تكرار منطق التنفيذ لمجرد تحقيق ترتيب شكلي.
المطلوب تقليل الاختبارات المكررة والملفات التي لا تضيف قيمة، لا منع كل ملف اختبار مستقل. فالاختبارات المستمرة التي تحمي من التراجعات تستحق البقاء في إدارة الإصدارات، بخلاف المجسات المؤقتة التي يمكن وضعها في مساحة مؤقتة.
٢. المواصفات وسجلات ADR والقواعد العامة: لكل منها وظيفة
من المفيد الفصل بين القواعد العامة، وتعليمات العمل الخاصة بالمشروع، ومواصفاته، وسجلات قراراته. ولا يُستحسن تعريف specs/ على أنها خلاصة لجميع سجلات ADR.
| الطبقة | السؤال الذي تجيب عنه | دورها |
|---|---|---|
| المنهجية العامة | كيف نحلل ونتحقق ونسلّم؟ | قواعد المنهجية التي يحددها القائمون عليها |
مدخل المشروع AGENTS.md |
كيف نعمل في هذا المشروع؟ | القيود المؤكدة ومداخل العمل |
مواصفات المشروع specs/ |
ما السلوك أو العقد المطلوب حالياً؟ | المتطلبات والقرارات المقبولة والتعديلات المصرح بها |
سجلات القرار docs/adr/ |
لماذا اختير هذا الحل؟ | توثيق المفاضلات والبدائل ذات الأهمية المعمارية |
توضح وثائق Cline وجود آلية للقواعد الدائمة التي تحفظ تعليمات قابلة للاستخدام عبر المحادثات.4 لكن ذلك لا يثبت أن الأداة تكتب تلقائياً ملفات بعينها في مجلد المواصفات؛ ينبغي التعامل مع هذا التنظيم على أنه اتفاق خاص بالمشروع، لا ضماناً من Cline.
يمكن اقتراح محتوى المشروع وصيانته على مراحل:
- عند تهيئة المشروع، يمكن اقتراح مواصفات استناداً إلى طلبات المستخدم وأدلة المستودع، مع إبقاء المجهول غير محسوم.
- قبل تنفيذ مهمة، تُراجع المواصفات والقرارات ذات الصلة لتحديد شروط القبول والتحقق.
- يُقترح سجل ADR جديد عند ظهور مفاضلة مهمة؛ أما القرار القائم والملائم فيُشار إليه بدلاً من تكراره لكل خطة.
- قد يثبت التحقق أن التنفيذ يفي بالمواصفات، أو يكشف خللاً في المواصفات. ونتيجة التنفيذ وحدها لا تمنح إذناً بتغيير المطلوب.
- بعد قبول القرار والتصريح بتحديث المواصفات، تُسجل القيود الحالية في موضعها، مع الإحالة إلى ADR ذي الصلة بدلاً من نسخ التاريخ كله.
الخلاصة: المواصفات تصف العقد الحالي، وADR يشرح خلفية القرار، والاختبار يتحقق من سلوك قابل للفحص. وهي عناصر مترابطة لكنها ليست بدائل بعضها لبعض. كما لا ينبغي تحويل ملاحظة خاصة بمشروع واحد إلى قاعدة عامة من دون مراجعة.
٣. توحيد مسار ADR لا يعني تغيير سياسة القبول
يمكن اعتماد docs/adr/ بوصفه المسار الافتراضي للقرارات الجديدة. هذا اختيار تنظيمي للمشروع، وليس ادعاءً بأنه المسار الوحيد المتبع في المجال.
ويظل من المناسب الاحتفاظ بسجلات المقترحات والقرارات المقبولة والمرفوضة والمستبدلة، لا المقبولة وحدها. عند تطبيق قرار قائم، يُعاد استخدامه بدلاً من إنشاء سجل مطابق، وعند استبدال قرار سابق توثّق العلاقة بينهما من دون إعادة كتابة مبررات القرار التاريخي. كذلك، لا يعني نجاح الاختبارات تلقائياً أن القرار حصل على موافقة اعتماده.
وأي نقل للسجلات يتطلب تحديث الإحالات الفعلية وقواعد التوجيه والصلاحيات المرتبطة بها؛ نقل الملفات وحده لا يكفي.
٤. خطة نشطة واحدة، مع فصل واضح بين الإتمام والتجميد
يمكن حفظ الخطط في plans/ من دون إنشاء مجلدات فرعية لمجرد تنظيم عدد محدود من الملفات التاريخية. ومن أمثلة الأسماء المقترحة:
| الغرض | اسم مرشح | المعنى |
|---|---|---|
| الخطة النشطة | pending_implementation_plan.md |
مدخل افتراضي واحد للخطة الجاري العمل عليها |
| خطة مكتملة | plan-20261022-example-id.md |
خطة اكتملت وحصلت على إذن الأرشفة |
| خطة مجمّدة وغير مكتملة | plan-20261022-example-id-frozen.md |
خطة أُخرجت من المسار النشط مع بقاء أعمال غير منجزة |
لا يتطلب التجميد مجلداً جديداً أو حالة رسمية إضافية فوراً. فالمتحقق المشار إليه يدعم حالياً حالة الإيقاف المؤقت (scripts/validate-roo-contracts.py:66)، ويمكن استخدامها مؤقتاً مع تسجيل سبب التجميد، والمهام المتبقية، وشروط الاستئناف.
والتمييز هنا أساسي:
- الأرشفة بعد الإتمام: اجتياز جميع شروط القبول المطلوبة والحصول على إذن الأرشفة.
- التجميد: إخراج الخطة من المدخل النشط مع الإقرار بأنها غير مكتملة، ومن دون ترقية مقترحات لم تُتحقق إلى حقائق.
- التخلي: توضيح أن التنفيذ لن يستمر وما يترتب على ذلك؛ وليس مجرد وصف الخطة بأنها متوقفة مؤقتاً. وأي حالة رسمية جديدة للتخلي تتطلب تعديل العقد المنظم للحالات.
يُفضّل أن يكون المدخل الافتراضي هو الخطة النشطة، لا جميع الخطط التاريخية في المجلد. ولا يُبحث في الخطط القديمة إلا عند طلب استئناف خطة أو الرجوع إلى تاريخها. وعند استئناف خطة مجمّدة، يلزم إذن جديد وإنشاء نسخة تنفيذ تحتفظ بمصدرها وإعادة التحقق؛ ولا تنتقل إليها تلقائياً نتيجة نجاح قديمة. ويتفق ذلك مع قواعد دورة الحياة المشار إليها (bmad-suite-v4/roo/rules/02-bmad-core.md:5).
كذلك، تغيير اسم الملف ليس دليلاً على اجتياز القبول. يجب تجنب الكتابة فوق خطة قائمة، وحفظ المهام غير المكتملة ومعالجة الإحالات، من دون إنشاء قالب فارغ لمجرد إبقاء مدخل ثابت.
٥. اربط الاختبارات بالمكونات والعقود، لا بمطابقة واحد لواحد
ليس من العملي فرض اختبار واحد لكل ملف برمجي؛ فقد يغطي الاختبار مكونات عدة، وقد يحتاج المكوّن الواحد إلى اختبارات وحدات أو خصائص أو تكامل.
يمكن البدء بتنظيم tests/ بحسب المكوّن أو المسؤولية، ثم توثيق الثوابت المهمة ومداخل الاختبارات وأوامر التحقق المحددة ضمن المواصفات ذات الصلة. وإذا أصبحت العلاقات صعبة الاكتشاف، يمكن إضافة ملف مرشح مثل tests/test-map.yaml.
يقتصر هذا الملف على ما يلزم: معرّف المكوّن أو العقد، نطاق الشيفرة المصدرية، نطاق الاختبارات، ومدخل التحقق. ولا ينبغي أن يكرر شجرة المجلدات كاملة أو أن ينسخ حالة نجاح الاختبارات. وظيفة بوابة الصيانة هي التأكد من أن المسارات والأوامر ما زالت صالحة؛ وجود خريطة لا يثبت وحده كفاية التغطية أو نجاح الاختبارات.
٦. نظّم المواد المؤقتة من دون محو الأدلة الضرورية
يمكن جمع المسودات العرضية والبرامج النصية المؤقتة وتقارير الاستكشاف في .scratch/. لكن لا يصح اعتبار كل ما في هذا المجلد مصدراً ثانوياً أو افتراض إمكان حذفه دائماً.
- ملخص بحث صاغه نموذج هو تفسير ثانوي، ولا يصبح حقيقة لمجرد حفظه في المستودع.
- قد يكون ناتج اختبار أصلي أو سجل تشخيص فعلي دليلاً أولياً حتى لو حُفظ مؤقتاً؛ وتتوقف موثوقيته على مصدره وبيئته وتوقيته واكتماله.
- لا ينبغي حذف الدليل الوحيد الذي تستند إليه خطة أو نتيجة قبول أو قرار ما زال سارياً. قبل التنظيف، يُحفظ الأصل اللازم أو تُراجع الاستنتاجات التي تعتمد عليه.
- عند تلخيص اكتشاف مهم، يجب الاحتفاظ بموضع الدليل ونطاق انطباقه وما بقي مجهولاً؛ فالاختصار لا يحوّل الافتراض إلى حقيقة.
وبالنسبة إلى التقارير القديمة والرسوم المعمارية في docs/، من الأفضل التمييز بين الوثائق الحالية، والمواد التاريخية الصريحة، والمواد التي تنتظر التحقق. فالقدم وحده لا يكفي للحذف: توضع للوثائق الحالية حدود نطاق وتُراجع عند تغير العقود ذات الصلة، وتُعلّم الخطط والرسوم القديمة بأنها تاريخية أو متجاوزة ولا تُعامل افتراضياً كخط أساس حالي. أما مواد العملية التي لا قيمة مستمرة لها ولا إحالات تعتمد عليها، فيمكن نقلها أو حذفها بعد التصريح بذلك.
الاحتفاظ بالوثيقة لا يعني تحميلها في سياق كل مهمة. يمكن تقليل ازدحام السياق عبر القراءة الموجهة وتوضيح صلاحية الوثائق، من دون محو تاريخ ضروري أو دليل يمكن الرجوع إليه.
الخلاصة
التنظيم المقترح قابل للتطبيق مع أربع حدود واضحة: اجمع الاختبارات مع الإبقاء على الاستثناءات التي تفرضها اللغة أو الحزمة؛ اجعل المواصفات وصفاً للعقد الحالي لا تجميعاً لكل سجلات ADR؛ افصل بين تجميد الخطة وإعلان إنجازها؛ ولا تحذف من المواد المؤقتة دليلاً ضرورياً لا بديل له.
لا تزال مسارات الخطط المسموح بها (scripts/validate-roo-contracts.py:48) ونطاق التعديل المسموح في وضع التحليل (bmad-suite-v4/roo/settings/custom_modes.yaml:5) مرتبطين بالتنظيم السابق. لذلك يتطلب أي انتقال لاحق تحديث القواعد والقوالب والإحالات والتحقق ومواءمة بيئة التشغيل، لا مجرد إعادة تسمية المجلدات. هذه المراجعة تحليل للمقترح فقط؛ ولم تُكتب الملفات أو تُنقل أو تُجمّد أو تُحذف أي مواد.
Studio Global AI
مواصلة البحث الخاص بك
تتضمن هذه الصفحة إجابة مدعومة بالمصدر يمكنك المتابعة داخل Studio Global.
يسأل الناس أيضا
ما هي الإجابة المختصرة على "اختبارات مركزية، وقرارات موثقة، وخطط يسهل استئنافها"؟
اجعل تجميع الاختبارات هو الخيار الافتراضي، مع استثناءات تفرضها حدود الحزم أو الحاجة إلى اختبار عناصر غير مُصدّرة.
ما هي النقاط الأساسية التي يجب التحقق منها أولاً؟
اجعل تجميع الاختبارات هو الخيار الافتراضي، مع استثناءات تفرضها حدود الحزم أو الحاجة إلى اختبار عناصر غير مُصدّرة. المواصفات تصف العقد الحالي، وسجلات ADR تشرح أسباب القرارات، والاختبارات تتحقق من السلوك؛ ولا يحل أحدها محل الآخر.
ماذا يجب أن أفعل بعد ذلك في الممارسة العملية؟
تجميد الخطة يعني إيقافها مؤقتاً مع حفظ ما لم يكتمل، وليس إعلان إنجازها أو اجتيازها للتحقق.