Compétences core-development
📦

core-development

Sûr

تطوير حزمة معالجة Figram الأساسية لـ DSL

Également disponible depuis: 7nohe

تتطلب حزمة Figram الأساسية تنسيقًا دقيقًا عبر الأنواع والتحقق من الصحة والتطبيع ومنطق الفرق. توفر هذه المهارة سير عمل منظمًا لتوسيع معالجة DSL مع أمان النوع وأنماط تدفق البيانات المتسقة.

Prend en charge: Claude Codex Code(CC)
⚠️ 67 Médiocre
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "core-development". إضافة خاصية 'healthCheck' للعقد يمكن أن تكون 'healthy' أو 'warning' أو 'critical'

Résultat attendu:

  • • أضفت DSLNode.healthCheck و IRNode.healthCheck إلى types.ts
  • • تحديث validate.ts: healthCheck يجب أن يكون واحدًا من ['healthy', 'warning', 'critical']
  • • تحديث normalize.ts: default healthCheck إلى 'healthy' عندما يكون غير محدد
  • • تحديث diff.ts: العقد بنفس المعرف ولكن healthCheck مختلف تشغيل upsertNode
  • • أضفت اختبارات في validate.test.ts لقيم healthCheck صالحة/غير صالحة
  • • أضفت اختبارات في normalize.test.ts لمعالجة القيمة الافتراضية

Audit de sécurité

Sûr
v3 • 1/10/2026

This skill is purely documentation-based with no executable code, scripts, or network capabilities. It provides guidance for working with TypeScript type definitions, validation, normalization, and diff algorithms in a DSL processing pipeline.

1
Fichiers analysés
144
Lignes analysées
0
résultats
3
Total des audits
Aucun problème de sécurité trouvé

Score de qualité

38
Architecture
100
Maintenabilité
83
Contenu
20
Communauté
100
Sécurité
78
Conformité aux spécifications

Ce que vous pouvez construire

توسيع أنواع الحزمة الأساسية

إضافة خصائص جديدة للعقد أو الحواف إلى DSL مع دعم التحقق من الصحة والتطبيع المناسب.

إصلاح أخطاء التحقق من الصحة

تشخيص وإصلاح الحالات الخاصة في التحقق من الصحة من YAML التي تسبب رسائل خطأ غير صحيحة.

إضافة عمليات التصحيح

تنفيذ أنواع جديدة من عمليات التصحيح لتحسين المزامنة بين CLI و FigJam.

Essayez ces prompts

إضافة خاصية العقدة
إضافة خاصية 'color' جديدة إلى DSLNode و IRNode في types.ts. ثم تحديث validate.ts للتأكد من أن اللون هو سلسلة hex صالحة، normalize.ts لتعيين قيمة افتراضية، و diff.ts للتعامل مع تغييرات اللون في فحوصات المساواة.
إضافة قاعدة التحقق من الصحة
إضافة قاعدة تحقق من الصحة في validate.ts تضمن أن جميع معرفات العقد في مصفوفة العقد فريدة داخل المستند. إضافة حالة اختبار للكشف عن المعرفات المكررة.
تصحيح مخرجات الفرق
مراجعة تنفيذ diff.ts. عند مقارنة وثيقتين IR حيث تغيرت فقط تسميات العقد، اشرح كيف تحدد خوارزمية العقد التي تحتاج عمليات upsertNode مقابل removeNode+upsertNode.
تحديث بروتوكول WebSocket
إضافة نوع رسالة 'sync' جديدة إلى بروتوكول WebSocket لطلب مزامنة جزئية للمستند. تحديث الواجهات المناسبة في types.ts وتوثيق تدفق الرسائل المتوقع.

Bonnes pratiques

  • الحفاظ على تزامن أنواع والتحقق من الصحة والتطبيع ومنطق الفرق عند إضافة خصائص جديدة
  • إضافة حالات اختبار لأخطاء التحقق من الصحة والقيم الافتراضية للتطبيع وحالات خاصة الفرق
  • اتباع تدفق البيانات الموثق لتتبع المشكلات عبر خط المعالجة

Éviter

  • إضافة خصائص إلى IR بدون أنواع DSL المقابلة ومنطق التطبيع
  • تجاوز التحقق من الصحة عند إضافة حقول جديدة، مما يؤدي إلى أخطاء وقت التشغيل
  • تعديل منطق الفرق بدون تحديث فحوصات المساواة في التطبيع

Foire aux questions

ما الملف الذي يتعامل مع التحقق من الصحة من YAML؟
validate.ts في packages/core/src/ يحتوي على جميع منطق التحقق من الصحة لمدخلات DSL مع رسائل خطأ وصفية.
كيف تضاف خصائص جديدة إلى DSL؟
تحديث types.ts و validate.ts و normalize.ts و diff.ts بالتسلسل. إضافة اختبارات لكل طبقة.
ما الذي يولد التحديثات التزايدية؟
diff.ts يحسب الفرق بين وثيقتين IR وينتج عمليات التصحيح للتحديثات الفعالة.
هل البيانات آمنة للمعالجة؟
نعم. الحزمة الأساسية خالية من التبعيات وتعالج البيانات في الذاكرة بدون وصول للشبكة أو كتابة على نظام الملفات.
كيف يتم تشخيص فشل الاختبارات؟
تشغيل bun test packages/core/ لرؤية أي طبقة فشلت. تتبع عبر تدفق البيانات لتحديد مصدر المشكلة.
كيف يقارن هذا بأدوات DSL الأخرى؟
تركز Figram تحديدًا على مخططات الهيكل مع خط أنبوبMinimal وآمن للنوع لتحويل YAML إلى FigJam.

Détails du développeur

Structure de fichiers

📄 SKILL.md