المهارات data-structure-protocol
📦

data-structure-protocol

آمن

تعيين بنية قاعدة الكود لوكلاء الذكاء الاصطناعي

يفقد وكلاء الذكاء الاصطناعي السياق في قواعد الكود الكبيرة ويهدرون الرموز في التوجيه. يوفر هذا المهارة ذاكرة هيكلية مستمرة من خلال رسم بياني قابل للاستعلام، مما يمكّن الوكلاء من التنقل في التبعيات وفهم علاقات الكود دون إعادة قراءة الملفات.

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

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "data-structure-protocol". python dsp-cli.py --root . search "authentication"

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

Found 3 entities:
- obj-11223344: auth/middleware.ts (User authentication middleware)
- func-aabbccdd: auth/middleware.ts#validateToken (JWT token validation)
- obj-44556677: auth/providers/oauth.ts (OAuth provider integration)

استخدام "data-structure-protocol". python dsp-cli.py --root . get-recipients obj-11223344

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

Modules importing auth/middleware.ts:
- obj-99887766: src/app.ts ('Handles JWT verification on requests')
- func-12345678: api/routes.ts ('Authenticates incoming API requests')

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

آمن
v1 • 2/24/2026

Static analysis detected patterns in SKILL.md (external_commands, network URLs, weak crypto flags) but all are FALSE POSITIVES. The detected patterns are: (1) Example CLI commands in markdown code blocks - not actual shell execution; (2) GitHub reference URLs for documentation - not data exfiltration; (3) Misidentified content as crypto algorithms - the skill is pure documentation. This is a legitimate documentation skill with no security risks.

1
الملفات التي تم فحصها
199
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
83
الامتثال للمواصفات

ماذا يمكنك بناءه

التنقل في قواعد الكود الكبيرة

تنقل في قواعد الكود غير المألوفة عن طريق الاستعلام عن رسم DSP البياني لفهم علاقات الوحدات دون قراءة كل ملف

إعادة الهيكلة الآمنة

قبل استبدال مكتبة أو إعادة هيكلة، استعلم عن الرسم البياني للعثور على جميع الوحدات التابعة وفهم التأثير

الحفاظ على سياق الكود

الحفاظ على المعرفة الهيكلية عبر الجلسات بحيث يمكن لوكلاء الذكاء الاصطناعي فهم سبب وجود الاتصالات

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

إعداد DSP للمشروع 
إعداد بروتوكول هيكل البيانات (DSP) لهذا المشروع. قم بتنزيل dsp-cli.py إذا لزم الأمر، وتشغيل init، وب-bootstrapping الرسم البياني بدءًا من نقطة الدخول الرئيسية.
العثور على تبعيات الكيان 
العثور على جميع الكيانات التي تعتمد على [entity-name-or-path] وإظهار سبب وجود كل تبعية.
تعيين وحدة جديدة 
إنشاء كائن DSP جديد لـ [file-path] مع الوصف '[purpose]'. ثم إنشاء كيانات دالة لكل دالة مُصدَّرة، وضع علامة عليها كمشتركة، وأضف عمليات الاستيراد مع الأسباب.
البحث في بنية قاعدة الكود 
البحث في رسم DSP البياني عن '[query]' للعثور على الكيانات ذات الصلة. إظهار أوصافهم وعلاقات الاستيراد.

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

  • قم بتحديث DSP فورًا عند إنشاء ملفات جديدة أو إضافة واجهات برمجة تطبيقات عامة أو تغييرها
  • أضف دائمًا سببًا ذا معنى 'لماذا' عند تسجيل عملية الاستيراد - هذا هو المكان الذي توجد فيه معظم القيمة
  • عامل فروقات .dsp/ مثل فروقات الكود - راجعها وحافظ على دقتها

تجنب

  • لا تقم بتحديث DSP للتغييرات الداخلية فقط التي لا تؤثر على الغرض أو التبعيات
  • لا تنشئ معرفات فريدة لكل متغير محلي - فقط الكائنات على مستوى الملف والكيانات العامة
  • لا تتخطى إضافة أسباب 'لماذا' - بدونها يفقد الرسم البياني قيمة التنقل

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

ما هو DSP؟
DSP (بروتوكول هيكل البيانات) هو نظام يمنح وكلاء الذكاء الاصطناعي ذاكرة هيكلية مستمرة لقاعدة الكود. يقوم بتخزين رسم بياني قابل للاستعلام في دليل .dsp/ يُظهر الكيانات والواردات والصادرات وأسباب كل اتصال.
هل ينفذ هذا المهارة كودًا؟
لا. يوفر هذا المهارة وثائق وإرشادات حول استخدام البرنامج النصي Python dsp-cli.py. لا يحتوي على أي كود قابل للتنفيذ يعمل تلقائيًا.
كيف يساعد DSP في إعادة الهيكلة؟
قبل إجراء التغييرات، يمكنك الاستعلام عن رسم DSP البياني للعثور على جميع الكيانات التي تعتمد على وحدة وفهم السبب الذي تجعلها تعتمد عليها. هذا يمنع التغييرات المكسورة ويضمن تغطية إعادة الهيكلة الكاملة.
ما هي المعرفات ولماذا تهم؟
المعرفات الفريدة (مثل obj-a1b2c3d4) مستقلة عبر عمليات إعادة تسمية الملفات ونقلها. على عكس مسارات الملفات، تتيح المعرفات الفريدة للرسم البياني تتبع الكيانات بشكل متسق حتى عند إعادة هيكلة الملفات.
هل يحلل DSP مكتبات الطرف الثالث؟
لا. يتم تسجيل التبعيات الخارجية (حزم npm، stdlib، وما إلى ذلك) كنوع 'external' لكن لم يتم تحليل عملياتها الداخلية أبدًا. فقط كود مشروعك يُعين بالتفصيل.
هل يمكنني استخدام هذا مع Claude Code؟
نعم. هذا المهارة مصمم لمساعدلي البرمجة بالذكاء الاصطناعي بما في ذلك Claude وCodee وClaude Code. يساعد الوكلاء على الحفاظ على السياق عبر الجلسات دون إعادة قراءة قاعدة الكود بأكملها.

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

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/data-structure-protocol

مرجع

main

بنية الملفات

📄 SKILL.md