المهارات openapi-spec-generation
📦

openapi-spec-generation

مراجعة المحتوى r2 آمن 🌐 الوصول إلى الشبكة⚙️ الأوامر الخارجية

توليد مواصفات OpenAPI 3.1

تحتاج الفرق إلى عقود API دقيقة قبل أن يظل التوثيق وSDKs والاختبارات متوافقة. ترشد هذه المهارة إلى إنشاء OpenAPI 3.1 ومراجعته وصيانته من أجل REST APIs.

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

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

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

طلب الوكيل
Review the Skillstore skill "openapi-spec-generation" from https://skillstore.io/skills/sickn33-openapi-spec-generation.md and its manifest at https://skillstore.io/api/skills/sickn33-openapi-spec-generation/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/sickn33-openapi-spec-generation.md manifest موقَّع GET /api/skills/sickn33-openapi-spec-generation/manifest lockfile موقَّع GET /api/skills/sickn33-openapi-spec-generation/lockfile

اختبرها

جارٍ استخدام "openapi-spec-generation". يحتاج فريق إلى عقد ابتدائي لـ endpoints المستخدمين والملفات الشخصية.

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

  • مخطط عقد API منظم يتضمن مجموعات الموارد ومتطلبات المصادقة وفئات response.
  • خطة schema للمستخدمين والملفات الشخصية وpagination واستجابات الأخطاء القياسية.

جارٍ استخدام "openapi-spec-generation". لدى مطور route handlers لكن لا يوجد توثيق API مُصان.

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

  • مطابقة من routes إلى operations وparameters وrequest bodies ونماذج response.
  • قائمة تحقق لتعليقات الكود وخطوات validation قبل نشر التوثيق.

جارٍ استخدام "openapi-spec-generation". يريد مالك التوثيق تحسين جودة توليد SDK.

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

  • ملخص مراجعة لـ operation IDs وإعادة استخدام schema وإدخالات server واتساق استجابات الأخطاء.
  • سير عمل إصدار يغطي validation للمواصفة، ونشر التوثيق، وتوليد العملاء.

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

آمن
v5 • ٤‏/٨‏/٢٠٢٦ فتح التقرير المرتبط بالإصدار

All 21 static findings are false positives. The URLs are documentation examples, the reconnaissance matches are ordinary schema terms, and the backticks mark Markdown file paths rather than executable commands.

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

عوامل الخطر

🌐 الوصول إلى الشبكة (8)
resources/implementation-playbook.md:28 resources/implementation-playbook.md:66 resources/implementation-playbook.md:69 resources/implementation-playbook.md:72 resources/implementation-playbook.md:74 resources/implementation-playbook.md:76 resources/implementation-playbook.md:532 resources/implementation-playbook.md:533
⚙️ الأوامر الخارجية (2)
SKILL.md:32 SKILL.md:36
لم يكتشف أحدث تدقيق ثابت ودلالي مكتمل أي نتائج أمنية مؤكدة. ولا يثبت ذلك أن المهارة خالية من الآثار الجانبية.
دقّقه: codex عرض سجل التدقيق →
شارك واستشهد بهذا التقرير

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

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

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

https://skillstore.io/skills/sickn33-openapi-spec-generation/audits/5?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

شارة Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/sickn33-openapi-spec-generation/security.svg)](https://skillstore.io/skills/sickn33-openapi-spec-generation?utm_source=security_passport_badge)

شارة HTML

<a href="https://skillstore.io/skills/sickn33-openapi-spec-generation?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/sickn33-openapi-spec-generation/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

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

<iframe src="https://skillstore.io/embed/skills/sickn33-openapi-spec-generation.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

sickn33. (2026). openapi-spec-generation security audit report (audit version 5) [Author version unspecified]. Skillstore. https://skillstore.io/skills/sickn33-openapi-spec-generation/audits/5

اقتباس BibTeX

@techreport{sickn33-sickn33-openapi-spec-generation-2026, author = {sickn33}, title = {openapi-spec-generation security audit report (audit version 5)}, institution = {Skillstore}, year = {2026}, number = {5}, url = {https://skillstore.io/skills/sickn33-openapi-spec-generation/audits/5}, 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: "openapi-spec-generation security audit report (audit version 5)" version: "unspecified" type: report authors: - name: "sickn33" date-released: "2026-08-04" url: "https://skillstore.io/skills/sickn33-openapi-spec-generation/audits/5" identifiers: - type: other value: "skillstore:sickn33-openapi-spec-generation:audit:5" description: "Skillstore immutable audit report identifier"

مقارنة المتغيرات

2 متغيرات قابلة للتثبيت

تبقى مهارة كل مؤلف عنصراً مستقلاً قابلاً للتثبيت. يُرتب المتغير الموصى به وفق أدلة Skillstore.

سبب تصدر هذا المتغير

أعلى تقييم في Skillstore
sickn33 موصى به الحالي

sickn33-openapi-spec-generation

تقييم Skillstore 78
موثوقية الأدلة مرتفع
استخدام Skillstore 17
تم التحديث

2026-09-09

wshobson

wshobson-openapi-spec-generation

تقييم Skillstore 76
موثوقية الأدلة مرتفع
استخدام Skillstore 14
تم التحديث

2026-09-09

تقييم Skillstore

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

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

تصميم عقد API جديد

إنشاء أساس واضح لـ OpenAPI 3.1 قبل بدء تنفيذ backend.

توثيق endpoints الحالية

تحويل سلوك routes ونماذج response وقواعد validation إلى توثيق API قابل لإعادة الاستخدام.

تحضير مدخلات SDK والبوابة

تنقيح المواصفات حتى تحتوي العملاء المولدة وبوابات التوثيق على تفاصيل operation متسقة.

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

إنشاء مواصفة ابتدائية 
أنشئ أول مواصفة OpenAPI 3.1 لـ REST API بهذه endpoints: [list endpoints]. ضمّن paths وschemas وresponses والمصادقة.
مراجعة مسودة مواصفة 
راجع مسودة OpenAPI هذه بحثاً عن schemas مفقودة، وتعريفات response ضعيفة، وoperation IDs غير متسقة، ومتطلبات security غير واضحة: [paste summary].
مطابقة الكود مع OpenAPI 
استخدم تعريفات routes والنماذج هذه لاقتراح بنية OpenAPI 3.1. حدد التعليقات أو metadata اللازمة للتوليد: [paste routes].
تخطيط حوكمة العقود 
صمم سير عمل للتحقق من تغييرات OpenAPI ونشر التوثيق وتوليد SDKs. ضمّن الفحوصات والملكية وخطوات الإصدار.

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

  • ابدأ من السلوك الفعلي لـ endpoint، ثم وحّد الأسماء وschemas وأنماط response.
  • عرّف المصادقة والتفويض والأخطاء وpagination باتساق عبر العمليات.
  • تحقق من المواصفات قبل نشر التوثيق أو توليد SDKs.

تجنب

  • لا تترك schemas بنمط placeholder في عقود API الإنتاجية.
  • لا تخلط بين operation IDs وtags وأشكال response غير المتسقة.
  • لا تنشر المواصفات من دون توثيق security schemes وتنسيقات الأخطاء.

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

هل تولد هذه المهارة ملف OpenAPI كاملاً؟
يمكنها الإرشاد في البنية والمحتوى. تعتمد الجودة النهائية على تفاصيل endpoint وschemas التي توفرها.
هل يمكنها العمل من كود موجود؟
نعم. تتضمن أنماط code-first وتساعد في مطابقة routes والنماذج والتعليقات مع مفاهيم OpenAPI.
هل تستدعي خدمات API خارجية؟
لا. توفر المهارة إرشادات وأمثلة. ولا تجري طلبات شبكة بنفسها.
ما إصدار OpenAPI الذي تستهدفه؟
تركز على OpenAPI 3.1، بما في ذلك schemas وcomponents قابلة لإعادة الاستخدام وsecurity schemes وmetadata الخاصة بالخوادم.
هل يمكنها المساعدة في توليد SDK؟
نعم. تشرح كيفية إعداد مواصفات متسقة لتوليد العملاء وبوابات التوثيق.
هل هي مناسبة لـ GraphQL APIs؟
لا. تركز على RESTful APIs الموصوفة باستخدام OpenAPI، وليس GraphQL schemas.

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

المؤلف

sickn33

الترخيص

MIT

مراجعة Skillstore

r2

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

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

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/openapi-spec-generation

مرجع

81e05e636292629114b76cbb3922fbe57672fc02

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

٨‏/٨‏/٢٠٢٦

الاستخدام

15 تنزيلات · 114 مشاهدات

بنية الملفات

📁 resources/

📄 implementation-playbook.md

📄 SKILL.md

المزيد من sickn33

عرض الكل

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

عرض الكل
📦

python-fastapi-patterns

85

إنشاء واجهات API باستخدام FastAPI بأنماط قابلة لإعادة الاستخدام

بواسطة 0xDarkMatter

تحتاج مشاريع FastAPI إلى اختيارات متسقة للتحقق من الصحة، والتبعيات، والبرمجيات الوسيطة، والعمل في الخلفية. تمنح هذه المهارة Claude وCodex وClaude Code أنماطًا قابلة لإعادة الاستخدام لتطوير واجهات API عملية بلغة Python.

البرمجة والتطوير عرض