المهارات architecture-decision-records
📦

architecture-decision-records

آمن

إنشاء سجلات قرارات الهندسة المعمارية

متاح أيضًا من: wshobson

تساعد هذه المهارة الفرق على توثيق القرارات التقنية الهامة باستخدام قوالب منظمة. توفر تنسيقات ADR شاملة، وإرشادات لإدارة دورة الحياة، وأفضل الممارسات لالتقاط السياق والمفاضلات والأسباب.

يدعم: Claude Codex Code(CC)
🥉 75 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "architecture-decision-records". إنشاء ADR لاعتماد TypeScript لمشروع الواجهة الأمامية الخاص بنا

النتيجة المتوقعة:

مستند ADR كامل مع الحالة: مقبول، سياق حول تحديات قاعدة كود React الحالية، قرار اعتماد TypeScript، العواقب التي تغطي الجيد (أمان الأنواع ودعم IDE) والسيئ (منحنى التعلم وتعقيد البناء)، والتخفيفات بما في ذلك جلسات التدريب.

استخدام "architecture-decision-records". توثيق إهمال خدمة المصادقة القديمة الخاصة بنا

النتيجة المتوقعة:

ADR إهمال مع حالة تظهر أنه يحل محل ADR-0015، سياق يدرج مشاكل الخدمة الحالية، خطة الترحيل مع نهج مرحلي، والدروس المستفادة حول ما حدث خطأ في القرار الأصلي.

التدقيق الأمني

آمن
v1 • 2/24/2026

Security analysis confirms this is a safe documentation skill. Static findings for external_commands, network, and weak_crypto are false positives. The skill contains markdown templates, example CLI commands (shown as documentation), and reference URLs to external documentation. No executable code, no data exfiltration, no cryptographic operations.

1
الملفات التي تم فحصها
444
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية

الأنماط المكتشفة

False Positive: External Commands DetectionFalse Positive: Network DetectionFalse Positive: Weak Cryptographic Algorithm
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
100
الامتثال للمواصفات

ماذا يمكنك بناءه

توثيق اختيار تقنية قاعدة البيانات

عند الاختيار بين PostgreSQL أو MySQL أو MongoDB لمشروع جديد، استخدم قالب Standard ADR لالتقاط المتطلبات ومقارنة الخيارات وتسجيل القرار مع الأسباب الكاملة.

تسجيل قرارات الترحيل بين الأطر

عند التخطيط للترحيل من Angular إلى React، أنشئ ADR إهمال لتوثيق أسباب التغيير ومراحل الترحيل والدروس المستفادة من القرار السابق.

إرساء عمليات اتخاذ القرار الجماعي

عند دمج أعضاء جدد في الفريق، استخدم قوالب ADR لمساعدتهم على فهم الخيارات المعمارية السابقة والأسباب الكامنة وراء العمارة الحالية.

جرّب هذه الموجهات

طلب ADR أساسي 
إنشاء سجل قرار معماري لـ [DECISION_TITLE]. استخدم التنسيق القياسي MADR. ضمّن سياقًا حول سبب حاجتنا لاتخاذ هذا القرار والخيارات التي نظرنا فيها وقرارنا النهائي والعواقب.
مقارنة التقنيات 
إنشاء ADR يقارن بين [TECHNOLOGY_A] و [TECHNOLOGY_B] و [TECHNOLOGY_C] لـ [USE_CASE] الخاص بنا. ضمّن إيجابيات وسلبيات مفصلة لكل خيار ومتطلباتنا وأوصِ بأفضل خيار مع الأسباب.
سجل الإهمال 
إنشاء ADR إهمال لـ [OLD_TECHNOLOGY] الذي يتم استبداله بـ [NEW_TECHNOLOGY]. ضمّن سياق سبب اتخاذ القرار الأصلي وما الذي تغير وخطة الترحيل والدروس المستفادة.
مقترح بأسلوب RFC 
إنشاء ADR مفصل بأسلوب RFC لـ [PROPOSAL]. ضمّن الدافع والتصميم المفصل والعيوب والبدائل المدروسة والأسئلة غير المحلولة وخطة التنفيذ. اجعله مناسبًا للمراجعة والنقاش الجماعي.

أفضل الممارسات

  • اكتب ADRs قبل بدء التنفيذ لالتقاط سياق القرار بدقة
  • ضمّن المفاضلات الصادقة والعيوب المحتملة في قسم العواقب
  • اربط ADRs ذات الصلة لبناء رسم بياني لاعتمادية القرارات للمشروع
  • حدّث حالة ADR عندما يتم إهمال القرارات أو استبدالها

تجنب

  • كتابة قرارات غامضة بدون سياق محدد أو أسباب
  • تخطي قسم البدائل لتجنب إظهار أن الخيارات الأخرى قد تم النظر فيها
  • تغيير ADRs المقبولة بدلاً من إنشاء جديدة لاستبدالها
  • إنشاء ADRs لقرارات طفيفة لا تستدعي التوثيق المعماري

الأسئلة المتكررة

ما هو سجل قرار الهندسة المعمارية؟
سجل قرار الهندسة المعمارية (ADR) هو مستند يلتقط قرارات معمارية هامة تم اتخاذها أثناء المشروع. يتضمن عادةً السياق والقرار نفسه وعواقب ذلك القرار.
متى يجب أن أنشئ ADR؟
أنشئ ADR عند اتخاذ قرارات معمارية هامة مثل اعتماد إطار عمل أو اختيار تقنية قاعدة بيانات أو أنماط تصميم API أو عمارة الأمان أو أنماط التكامل. تخطّ ADRs للإصلاحات الطفيفة أو الصيانة الروتينية.
ما تنسيق ADR الذي يجب أن أستخدمه؟
استخدم التنسيق القياسي MADR للقرارات الشاملة، والتنسيق الخفيف للقرارات السريعة، وY-Statement للخيارات الموجزة، وأسلوب RFC للمقترحات المعقدة التي تتطلب مراجعة جماعية.
كيف أربط ADRs ذات الصلة؟
ضمّن قسم القرارات ذات الصلة في كل ADR يشير إلى ADRs الأخرى بالرقم. استخدم مؤشرات الحالة مثل 'يحل محل ADR-0003' أو 'يكمل ADR-0002' لإظهار العلاقات.
هل يمكنني تعديل ADR مقبول؟
لا. لا يجب أبدًا تعديل ADRs المقبولة. بدلاً من ذلك، أنشئ ADR جديدًا يحل محل القديم ووثّق ما تغير ولماذا.
ما الأدوات التي يمكن أن تساعد في إدارة ADRs؟
adr-tools هي أداة CLI شائعة لإدارة ADRs. يمكنها تهيئة المجلدات وإنشاء ADRs جديدة وتوليد جدول محتويات وربط القرارات ذات الصلة.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/architecture-decision-records

مرجع

main

بنية الملفات

📄 SKILL.md