pydantic-models-py
إنشاء نماذج Pydantic باستخدام نمط النماذج المتعددة
حدد مخططات API متسقة دون الحاجة إلى كتابة كود متكرر يدوياً. تقوم هذه المهارة بإنشاء نماذج Pydantic منظمة mengikuti الأنماط المعمول بها للتحقق من صحة الطلبات والاستجابات والتكامل مع قواعد البيانات.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "pydantic-models-py". كيان User مع حقول id و name و email و created_at
النتيجة المتوقعة:
فئات النماذج UserBase و UserCreate و UserUpdate و UserResponse و UserInDB المُنشأة مع تعريفات Field مناسبة وتعليقات النوع وفئة Config للتعامل مع الأسماء المستعارة
استخدام "pydantic-models-py". نموذج Project يتطلب توافق API مع camelCase
النتيجة المتوقعة:
نماذج مع Field aliases (workspaceId، createdAt) تقبل اصطلاحات التسمية كلاهما مع استخدام Pythonic snake_case داخلياً
التدقيق الأمني
آمنAll 21 static analysis findings are false positives. The scanner misidentified Markdown code block backticks as shell execution, and documentation references to HTTP/cryptography as actual code. SKILL.md is pure documentation with Python code examples for Pydantic model patterns. No executable code, network calls, or security risks detected.
درجة الجودة
ماذا يمكنك بناءه
تعريف مخطط REST API
حدد نماذج الطلب/الاستجابة لنقاط نهاية FastAPI أو Flask مع أنماط تحقق من الصحة متسقة.
نمذجة مستندات قاعدة البيانات
أنشئ متغيرات نموذج InDB مع حقول doc_type لتخزين مستندات Cosmos DB أو MongoDB.
مزامنة عقد الواجهة الأمامية والخلفية
أنشئ نماذج Python وأنواع TypeScript متطابقة لضمان اتساق عقد API.
جرّب هذه الموجهات
أنشئ نماذج Pydantic لكيان User مع الحقول: id (string)، name (string، مطلوب)، email (string مع التحقق من صحة البريد الإلكتروني)، created_at (datetime). استخدم نمط النماذج المتعددة مع متغيرات Base و Create و Update و Response.
أنشئ نماذج Pydantic لكيان Project. يجب أن تقبل جميع الحقول كلاً من snake_case و camelCase باستخدام Field aliases. ضمّن حقول workspace_id و project_name و is_active.
أنشئ نماذج Pydantic كاملة لكيان Document بما في ذلك متغير InDB مع حقل doc_type. أضف التحقق من صحة min_length على name وحقل description اختياري للتحديثات.
ابنِ نماذج Pydantic لكيان Order مع مصفوفة line_items متداخلة. يحتوي كل عنصر سطر على product_id و quantity و price. أنشئ نمط نماذج متعدد كامل مع قيود التحقق من الصحة على جميع الحقول.
أفضل الممارسات
- افصل دائماً بين نماذج Create و Update - يتطلب Create جميع الحقول، بينما يجعل Update جميع الحقول اختيارية لدلالات PATCH
- استخدم Field مع default=None صريح للحقول الاختيارية في التحديث لتمييز القيم null عن القيم غير المحددة
- مكّن populate_by_name = True في فئة Config لقبول كلاً من snake_case و camelCase من عملاء API
تجنب
- لا تعيد استخدام فئة النموذج نفسها لكل من هيئات الطلب ومستندات قاعدة البيانات - الفصل يمنع تسرب البيانات
- تجنب وضع منطق العمل في فئات النماذج - اجعلها مخططات بيانات نقية مع التحقق من الصحة فقط
- لا تحذف doc_type في نماذج InDB عند استخدام Cosmos DB - ستفشل الاستعلامات دون تصفية النوع المناسبة