المهارات allra-api-design
📦

allra-api-design

مراجعة المحتوى r2 آمن ⚙️ الأوامر الخارجية

تصميم Spring REST APIs لـ Allra

غالبًا ما تفقد فرق الواجهة الخلفية الاتساق عند إضافة Spring APIs وDTOs. تطبق هذه المهارة اصطلاحات Allra لتنظيم الحزم، وتسمية REST، وسجلات DTO، والتحقق، والاستجابات.

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

التثبيت باستخدام Agent لدي

انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.

طلب الوكيل
Review the Skillstore skill "allra-api-design" from https://skillstore.io/skills/allra-fintech-allra-api-design.md and its manifest at https://skillstore.io/api/skills/allra-fintech-allra-api-design/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.

موارد مهيّأة لـ Agents

استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.

تفاصيل Markdown GET /skills/allra-fintech-allra-api-design.md manifest موقَّع GET /api/skills/allra-fintech-allra-api-design/manifest lockfile موقَّع GET /api/skills/allra-fintech-allra-api-design/lockfile

اختبرها

جارٍ استخدام "allra-api-design". أنشئ product creation API لخدمة واجهة خلفية من Allra.

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

  • تسمي النتيجة حزمة مجال المنتج وتفصل طبقات API وDTO وentity وrepository وservice.
  • تقترح CreateProductRequest وProductResponse كأسماء DTO العامة.
  • توصي بالتحقق المطلوب لحقلي اسم المنتج والسعر.

جارٍ استخدام "allra-api-design". راجع بنية user API الخاصة بي وفقًا لمعايير Allra.

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

  • تشير المراجعة إلى أسماء الحزم التي لا تفصل مسؤوليات controller وDTO وrepository وservice.
  • تحدد DTOs التي يجب أن تستخدم لواحق Request أو Response أو Dto.
  • تتحقق مما إذا كانت request DTOs تتضمن قواعد تحقق.

جارٍ استخدام "allra-api-design". خطط DTOs الداخلية لنتائج استعلامات المنتجات والأحداث.

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

  • تميز الخطة DTOs الموجهة للعميل عن كائنات النقل الداخلية.
  • توصي بلواحق Dto لكائنات الاستعلام والأحداث الداخلية.
  • تشير إلى المواضع التي قد تكون فيها QueryDSL projection DTOs مناسبة.

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

آمن
v9 • ٢٣‏/٧‏/٢٠٢٦ فتح التقرير المرتبط بالإصدار

All 31 static findings are false positives caused by Markdown backticks, fenced examples, and ordinary Java request parameters. The skill is a documentation-only API design guide with no command execution, system reconnaissance, or prompt injection behavior.

1
الملفات التي تم فحصها
269
الأسطر التي تم تحليلها
0
عناصر المراجعة
0
تم تجاهل الإيجابيات الكاذبة

عوامل الخطر

⚙️ الأوامر الخارجية (26)
SKILL.md:24-32 SKILL.md:32-34 SKILL.md:34 SKILL.md:38-55 SKILL.md:55-61 SKILL.md:61-62 SKILL.md:62 SKILL.md:63-64 SKILL.md:64 SKILL.md:68-71 SKILL.md:71 SKILL.md:77-96 SKILL.md:96-102 SKILL.md:102-137 SKILL.md:137-139 SKILL.md:139-145 SKILL.md:145-158 SKILL.md:158-165 SKILL.md:165-170 SKILL.md:170-173 SKILL.md:173-181 SKILL.md:181-199 SKILL.md:199-236 SKILL.md:236-240 SKILL.md:240-257 SKILL.md:257-268
لم يكتشف أحدث تدقيق ثابت ودلالي مكتمل أي نتائج أمنية مؤكدة. ولا يثبت ذلك أن المهارة خالية من الآثار الجانبية.
دقّقه: codex عرض سجل التدقيق →
شارك واستشهد بهذا التقرير

شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.

فتح التقرير المرتبط بالإصدار
تقييم الأمان

نسخ رابط التقرير

https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

شارة Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/allra-fintech-allra-api-design/security.svg)](https://skillstore.io/skills/allra-fintech-allra-api-design?utm_source=security_passport_badge)

شارة HTML

<a href="https://skillstore.io/skills/allra-fintech-allra-api-design?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/allra-fintech-allra-api-design/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

بطاقة قابلة للتضمين

<iframe src="https://skillstore.io/embed/skills/allra-fintech-allra-api-design.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
الاستشهادات الأكاديمية (APA · BibTeX · CFF)

اقتباس APA

Allra-Fintech. (2026). allra-api-design security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9

اقتباس BibTeX

@techreport{allra-fintech-allra-fintech-allra-api-design-2026, author = {Allra-Fintech}, title = {allra-api-design security audit report (audit version 9)}, institution = {Skillstore}, year = {2026}, number = {9}, url = {https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "allra-api-design security audit report (audit version 9)" version: "unspecified" type: report authors: - name: "Allra-Fintech" date-released: "2026-07-23" url: "https://skillstore.io/skills/allra-fintech-allra-api-design/audits/9" identifiers: - type: other value: "skillstore:allra-fintech-allra-api-design:audit:9" description: "Skillstore immutable audit report identifier"

تقييم Skillstore

سبب هذا التقييم موثوقية الأدلة: مرتفع
55
الهندسة المعمارية
85
قابلية الصيانة
87
المحتوى
70
المجتمع
83
الامتثال للمواصفات

ما الذي يمكنك بناؤه

إنشاء domain API جديدة

إنشاء خطة حزم متسقة وأسماء DTO ومسارات controller وقائمة تحقق للتحقق لمجال جديد في الواجهة الخلفية.

مراجعة اتساق API

مقارنة تصميمات controller وDTO الحالية باصطلاحات Allra قبل دمج pull request.

توجيه عمل الواجهة الخلفية بمساعدة AI

إبقاء Claude أو Codex أو Claude Code متوافقًا مع معايير الواجهة الخلفية لدى Allra أثناء مهام التنفيذ.

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

إنشاء خطة DTO 
صمم DTOs للطلب والاستجابة لـ user signup API جديدة باستخدام اصطلاحات Allra. ضمّن توصيات التحقق من الحقول.
تصميم REST Endpoint 
صمم Spring REST endpoint بأسلوب Allra لإنشاء المنتجات. ضمّن تسمية المسار، وموضع الحزمة، وأسماء DTO، وإرشادات الاستجابة.
إعادة هيكلة بنية الحزم 
راجع بنية وحدة الواجهة الخلفية هذه واقترح تغييرات تجعلها متوافقة مع قواعد حزم المجال في Allra ومسؤوليات الطبقات.
تدقيق تصميم API قبل الدمج 
دقق تصميم Spring API هذا مقابل معايير Allra. تحقق من تنظيم الحزم، وتسمية REST، ولواحق DTO، واستخدام record، والتحقق، واتساق الاستجابات.

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

  • قدم المجال المستهدف، والغرض من endpoint، وأسماء الحزم الحالية قبل طلب التصميم.
  • اطلب قواعد التحقق كلما قبلت request DTO إدخالًا من العميل.
  • راجع التصميمات المولدة مقابل سياسات إصدار API والاستجابة الخاصة بالمشروع.

تجنب

  • لا تخلط فئات controller وservice وrepository وentity في حزمة واحدة.
  • لا تستخدم اللاحقة Dto لكائنات الطلب أو الاستجابة العامة.
  • لا تنسخ أشكال الاستجابات النموذجية من دون التحقق من معيار المشروع.

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

ما الذي تساعد هذه المهارة في تصميمه؟
تساعد في تصميم Spring REST APIs، وأسماء DTO، وقواعد التحقق، وأشكال الاستجابة، وبنية حزم المجال لواجهات Allra الخلفية.
هل تنشئ كودًا جاهزًا للإنتاج؟
توفر إرشادات تصميم وأمثلة. لا يزال كود الإنتاج يحتاج إلى سياق المشروع، والاختبارات، والتفويض، وتفاصيل الاستمرارية.
أي أسلوب Java تفضله لـ DTOs؟
تفضل Java records لكائنات الطلب والاستجابة والنقل الداخلي البسيطة عندما يدعمها المشروع.
هل يمكن استخدامها خارج مشاريع Allra؟
نعم، لكن الاصطلاحات خاصة بـ Allra. يجب على الفرق الأخرى تكييف الأسماء والمسارات وتنسيقات الاستجابة وفقًا لمعاييرها الخاصة.
هل تغطي أمان API؟
تتضمن فقط إرشادات تحقق أساسية. تحتاج المصادقة والتفويض وحدود المعدل والتعامل مع البيانات الحساسة إلى مراجعة منفصلة.
ما أدوات AI التي يمكنها استخدامها؟
يذكر التقرير دعم Claude وCodex وClaude Code.

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

المؤلف

Allra-Fintech

الترخيص

MIT

مراجعة Skillstore

r2

تنبيه الإصدار

لم يعلن المؤلف عن إصدار.

المستودع

https://github.com/Allra-Fintech/allra-ai-skills/tree/main/backend-plugin/skills/api-design

مرجع

31bc7611b504c197d3e993aef7943461c871616f

حداثة الصيانة

٢٦‏/٧‏/٢٠٢٦

الاستخدام

10 تنزيلات · 233 مشاهدات

بنية الملفات

📄 SKILL.md

المزيد من Allra-Fintech

عرض الكل

مهارات ذات صلة

عرض الكل