إرشادات هندسة البرمجيات

SKILL.md

---
name: إرشادات هندسة البرمجيات
description: تطبيق إرشادات هندسة البرمجيات السياقية عند تحليل حدود النظام، ومتطلبات الجودة، والاتصال، والأنماط، والقرارات، والمخاطر، أو التطور.
---

# إرشادات هندسة البرمجيات

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

## سير العمل

1. **تحديد السياق والسلطة.** حدد المجال، حدود النظام، نتائج الأعمال، قيود النشر والبيانات، قدرات الفريق، الأدلة المعروفة، المجهولات، وسلطة اتخاذ القرار. احترم السلطة المفوضة بالفعل. اطلب فقط الحقائق المفقودة التي يمكن أن تغير النتيجة؛ وإلا قدم توصية شرطية.
2. **ترتيب المحركات.** ترجم نتائج أصحاب المصلحة إلى خصائص معمارية. اختبر كل مرشح مقابل التعريف الثلاثي الأجزاء، فكك الخصائص المركبة، وأولوي مجموعة صغيرة.
3. **رسم الحدود والبيانات.** حدد المسؤوليات الوظيفية، التبعيات، المعاملات، ملكية البيانات، الترابط الثابت، المكالمات أثناء التشغيل، والخصائص عند كل حد ذي صلة.
4. **المقارنة النسبية.** لاختيار مهم، قارن على الأقل خيارين قابلين للتطبيق مقابل الأولويات، التكاليف، المخاطر، والأدلة المذكورة. لا تفرض مقارنة رسمية لتغيير صغير وقابل للعكس.
5. **اتخاذ القرار مع المبرر.** اذكر التوصية أو الحالة، سبب ملاءمتها، التكاليف المقبولة، الافتراضات، وما الأدلة التي قد تؤدي لإعادة النظر. اتبع السلطة المفوضة؛ لا تخترع بوابات الموافقة.
6. **تحديد الفحوصات.** اختر مقاييس أو دوال ملاءمة تتناسب مع المخاطر. سمّ نطاقها، الإشارة، القيود، والاستجابة.

## القواعد الأساسية

- استند التوصيات إلى السياق ([قواعد السياق والأولويات](references/rulebook.md#context-priorities): F01) واحترم السلطة المفوضة ([قواعد القرار والمخاطر والتطور](references/rulebook.md#decisions-risk-evolution): D03).
- استخلص ورتب الخصائص من نتائج أصحاب المصلحة القابلة للقياس ([قواعد السياق والأولويات](references/rulebook.md#context-priorities): F05, F06, F07, F08, F18).
- حافظ على تماسك المسؤوليات والحدود صادقة بشأن التبعيات والترابط ([قواعد الحدود](references/rulebook.md#boundaries-coupling-data): F11–F17, S03, S08; [المصطلحات](references/glossary.md)).
- اختر التواصل للعمل؛ ميز بين الطلب، الأمر، والحدث، وصمم للفشل ([قواعد التواصل](references/rulebook.md#communication-reliability): S06, S09–S13, S15, D08).
- اعتبر أنماط الهندسة خيارات شرطية وقارن تكاليفها ([قواعد الأنماط](references/rulebook.md#style-choice): S01, S16, D06; [دليل الأنماط](references/style-selection.md)).
- سجل سبب وجود القرارات المهمة وما الذي قد يغيرها ([المقايضات](references/rulebook.md#context-priorities): F02; [سجلات القرار](references/rulebook.md#decisions-risk-evolution): F03).
- اجعل المخاطر، عدم اليقين، وتوافق التنفيذ مرئية ([قواعد المخاطر والتطور](references/rulebook.md#decisions-risk-evolution): D10, D11, D12, D13).
- احكم القيود المهمة بفحوصات يفهمها الناس ([قواعد الحوكمة](references/rulebook.md#decisions-risk-evolution): F09, F10).
- حافظ على اختيار الفريق ضمن السلطة والقيود الفعلية ([قواعد الفريق والتواصل](references/rulebook.md#communication-teams): S04, D16, D17, D18).
- طبق إرشادات مزود الخدمة فقط عندما يشمل المشروع مزود نموذج ([D15 في rules.json](references/rules.json)).

## عقد المخرجات

الإرجاع: السياق والمجهولات؛ التوصية والحالة؛ البدائل والتكاليف؛ تداعيات الحدود، البيانات، والتواصل؛ الأدلة والفحوصات؛ ومحفز إعادة النظر. قم بتوسيع التفاصيل حسب أهمية الاختيار.

## المراجع

لمهمة، حمّل فقط الفئة ذات الصلة في [rules.json](references/rules.json) أو اقرأ قسمها في [rulebook.md](references/rulebook.md)، لا كلاهما أو الحزمة كاملة. حمّل [style-selection.md](references/style-selection.md) للأنماط التسعة، [glossary.md](references/glossary.md) للمصطلحات المعتمدة على المصدر، و[source-map.json](references/source-map.json) لتحديد مواقع الفصول المذكورة. توجد مطالبات التقييم الاصطناعي في [evaluation-cases.json](references/evaluation-cases.json)؛ لم تُنفذ بعد. المنهج والقيود في [method-and-validation.md](references/method-and-validation.md).