スキル architecture
📐

architecture

安全

إطار عمل قرارات الهندسة المعمارية

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

対応: Claude Codex Code(CC)
📊 70 十分
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「architecture」を使用しています。 ساعدني في تخطيط الهندسة المعمارية لتطبيق تجارة إلكترونية MVP مع مطور واحد

期待される結果:

لمطور واحد في MVP، أوصي بـ: بنية Monolith مع Next.js، Prisma للوصول إلى البيانات، مصادقة JWT، قاعدة بيانات PostgreSQL، Stripe للمدفوعات. المفاضلات: توسع مستقل محدود، يمكن استخراج الخدمات لاحقاً عند الضرورة.

「architecture」を使用しています。 أنشئ ADR لاختيار PostgreSQL على MongoDB

期待される結果:

قالب ADR: السياق - الحاجة إلى بيانات تعاملات موثوقة. الخيارات التي تم النظر فيها: PostgreSQL (ACID، استعلامات معقدة) مقابل MongoDB (مرن، توسع أفقي). القرار: PostgreSQL. المبرر: التجارة الإلكترونية تتطلب سلامة التعاملات. المفاضلات المقبولة: مخطط أقل مرونة في البداية.

セキュリティ監査

安全
v1 • 2/24/2026

All static findings are false positives. The skill is a documentation guide for architectural decision-making. Detected patterns are markdown formatting (backticks), authentication standards (SAML, JWT), and normal decision-making terms (validate). No actual security risks identified.

6
スキャンされたファイル
398
解析された行数
4
検出結果
1
総監査数
中リスクの問題 (1)
Markdown Code Block Delimiters
Static analyzer detected backtick characters in markdown files. These are code block delimiters in documentation, not shell execution.
低リスクの問題 (3)
SAML Authentication Reference
Static analyzer flagged 'SAML' as related to Windows SAM database. SAML is Security Assertion Markup Language, a standard authentication protocol.
JWT Authentication Reference
Static analyzer flagged 'JWT' as weak cryptographic algorithm. JWT is JSON Web Token, a standard authentication mechanism.
Decision Validation Terms
Static analyzer flagged 'validate' as system reconnaissance. These are normal architectural decision validation steps.
監査者: claude

品質スコア

38
アーキテクチャ
100
保守性
87
コンテンツ
25
コミュニティ
94
セキュリティ
100
仕様準拠

作れるもの

تخطيط هندسة المشروع الجديد

عند بدء مشروع جديد، استخدم المهارة لتحديد الهندسة المعمارية المناسبة بناءً على حجم الفريق ومتطلبات القياس وقيود الجدول الزمني.

توثيق قرارات الهندسة المعمارية

عند إجراء خيارات معمارية مهمة، استخدم قوالب ADR لتسجيل السياق والخيارات التي تم النظر فيها ومبررات القرار والمفاضلات المقبولة.

إرشاد اختيار النمط

عند عدم التأكد من نمط الهندسة المعمارية الذي يجب استخدامه، استشر أشجار القرار لتقييم المفاضلات بين الخيارات مثل monolith مقابل microservices، أو REST مقابل GraphQL.

これらのプロンプトを試す

تحليل المتطلبات لمشروع جديد
ساعدني في تحديد الهندسة المعمارية لـ [project type] جديد مع [team size] مطورين، تستهدف [user scale] مستخدمين، مع جدول زمني هو [timeline]. الميزانية هي [budget constraint]. استخدم مهارة الهندسة المعمارية لتوجيه هذا القرار.
إنشاء سجل قرار الهندسة المعمارية
أنشئ ADR لاختيار [technology/pattern] على البدائل. السياق يتضمن [problem description]. ضع في الاعتبار هذه القيود: [list constraints]. استخدم إطار تحليل المفاضلات من مهارة الهندسة المعمارية.
تقييم Microservices مقابل Monolith
ساعدني في الاختيار بين بنية microservices و monolith لـ [project description] مع [team size] مطورين. ما هي المفاضلات؟ متى يكون كل نهج مبرراً؟
اختيار نمط الوصول إلى البيانات
ما نمط الوصول إلى البيانات الذي توصي به لـ [project type] مع احتياجات وصول بيانات [complexity level]؟ ضع في الاعتبار: حجم الفريق هو [size]، متطلبات الاختبار هي [level]، مصادر البيانات تشمل [sources].

ベストプラクティス

  • ابدأ بأبسط هندسة معمارية تلبي المتطلبات الحالية وأضف التعقيد فقط عند الضرورة المثبتة
  • وثق المفاضلات دائماً - كل خيار معماري له تكاليف وفوائد يجب أن تكون صريحة
  • استخدم ADRs لتسجيل ليس فقط ما تم تقريره ولكن لماذا، بما في ذلك القيود التي أثرت على الاختيار
  • ضع خبرة الفريق في الاعتبار عند اختيار الأنماط - أفضل نمط لا فائدة منه إذا لم يستطع الفريق صيانته

回避

  • microservices المبكرة جداً - تقسيم الخدمات قبل أن يبرر حجم الفريق أو القياس التعقيد
  • التجريد المفرط مع بنية Clean/Hexagonal عندما يكون CRUD بسيطاً كافياً
  • اختيار CQRS أو Event Sourcing بدون أدلة على أداء القراءة/الكتابة تظهر الفائدة
  • تجاهل المفاضلات - كل خيار معماري له تكاليف يجب الاعتراف بها

よくある質問

متى يجب استخدام microservices بدلاً من monolith؟
تكون microservices مبررة عندما: يتجاوز الفريق 10 مطورين، تحتاج مكونات مختلفة إلى قياس مختلف، توجد حدود نطاق واضحة. ابدأ بـ modular monolith واستخرج الخدمات عند الضرورة المثبتة.
ما هو ADR ولماذا أحتاج إليه؟
ADR (سجل قرار الهندسة المعمارية) يوثق القرارات المهمة مع السياق والخيارات التي تم النظر فيها والخيار الذي تم اتخاذه والمبررات والمفاضلات. يساعد المطورين المستقبليين على فهم سبب تصميم النظام بطريقة معينة.
كيف أحدد الهندسة المعمارية المناسبة لمشروعي؟
ابدأ بمصفوفة تصنيف المشروع: MVP (<1K مستخدم، مطور واحد)، SaaS (1K-100K، 2-10 مطورين)، Enterprise (100K+، 10+ مطورين). طابق تعقيد الهندسة المعمارية مع القيود الفعلية، وليس الاحتياجات المستقبلية الافتراضية.
متى يجب استخدام نمط Repository؟
استخدم نمط Repository عندما: يتطلب الاختبار تجريداً لمصدر البيانات، توجد مصادر بيانات متعددة، أو منطق الوصول إلى البيانات معقد. لـ CRUD بسيط مع قاعدة بيانات واحدة، الوصول المباشر عبر ORM أبسط وكافٍ.
كيف أقيّم المفاضلات في قرارات الهندسة المعمارية؟
لكل خيار، وثق: الإيجابيات المحددة، السلبيات المحددة، مستوى التعقيد، والشروط التي يكون فيها هذا الخيار صالحاً. اربط القرارات بقيود ملموسة (حجم الفريق، القياس، الجدول الزمني، الميزانية) بدلاً من أفضل الممارسات المجردة.
هل يمكن لهذه المهارة كتابة الكود لي؟
لا. توفر هذه المهارة إرشادات معمارية وأطر قرار وقوالب توثيق. لا تولد كود تنفيذ ولا تعدل الملفات. استخدمها للتخطيط والتوثيق قبل التنفيذ.

開発者の詳細