ما الذي تفعله هذه المهارة

يتولى محوّل JSON إلى أنواع المهمة المرهقة المتمثلة في تعريف هياكل البيانات يدويًا لاستجابات API أو مجموعات بيانات JSON. يحلل أي مصدر JSON بشكل تكراري—سواء أكان ملفًا محليًا أم سلسلة نصية خام—ويولّد واجهات TypeScript أو فئات بيانات Python جاهزة للإنتاج.

لماذا تستخدم هذه المهارة

بينما يمكنك أن تطلب من نموذج لغوي عادي "تحويل هذا JSON"، توفر هذه المهارة سير عمل منظمًا للمطورين كثيرًا ما يفتقر إليه النموذج اللغوي وحده. فهي تكتشف تلقائيًا بيئة اللغة في مشروعك، وتتعامل مع تحويل جذور المصفوفات إلى صيغة المفرد (مثل تحويل users.json إلى واجهة User)، وتدير أنواع الاتحاد المعقدة للمصفوفات المختلطة، وتتبع أفضل الممارسات الخاصة بكل لغة كتحويل التسمية إلى snake_case في Python واستخدام Record<string, unknown> للكائنات الديناميكية.

الأدوات المدعومة

• TypeScript: يولّد واجهات مُصدَّرة مع دعم الخصائص الاختيارية والأسماء البديلة للأنواع.
• Python: يولّد تعريفات @dataclass باستخدام وحدة typing وتعليقات __future__.
• اكتشاف المشروع: يستخدم Glob للتحقق تلقائيًا من وجود tsconfig.json أو pyproject.toml لاختيار اللغة المناسبة.

المخرجات

يولّد ملف types.ts أو models.py نظيفًا وموثقًا بتعليقات واضحة، ويقدم تقرير ملخص للمخطط المستنتج، بما في ذلك الحقول التي تم تحديدها كاختيارية بناءً على وجودها عبر عناصر المصفوفة.