SkillSpector فحص أمان المهارات: مستودع NVIDIA/SkillSpector أداة سطر أوامر تحلل مهارة (skill) لوكيل ذكاء اصطناعي قبل تثبيتها. تبحث عن الثغرات وحقن التعليمات (prompt injection) وتسريب الأسرار والاعتمادات الخطرة. يضم المستودع نحو 22000 نجمة في نهاية أكتوبر 2026 ويستخدم رخصة Apache 2.0.
المهارة مجلد يحوي ملف SKILL.md وأحيانًا سكربتات، وتعمل بثقة الوكيل الذي يحمّلها. بالنسبة إلى فريق التشغيل هي حزمة جديدة تحتاج إلى فحص، مثل صورة حاوية. يتبع هذا المقال ملف README والوثائق الرسمية اللذين قُرئا في 26 أكتوبر 2026.
توضيح للأمانة: لم تثبّت span.observer أداة SkillSpector. الأوامر مأخوذة من README، واللقطتان أدناه تعيدان مقتطفين من README كما هما.
SkillSpector فحص أمان المهارات: ما يقوله المستودع
- الناشر والرخصة: المستودع تحت منظمة NVIDIA، ونص رخصة Apache 2.0 في ملف
LICENSE. - أرقام قُرئت في 26 أكتوبر 2026: نحو 22000 نجمة ونحو 1900 نسخة (fork) و1698 إيداعًا (commit) في الفرع الرئيسي. لا تعرض صفحة المستودع أي إصدار منشور.
- اللغة: Python 3.12 أو أحدث، بحسب شارة README.
- موقعه ضمن منظومة: يقدّم README الأداة خطوة في مسار NVIDIA Verified Skills الذي يفحص المهارات ويقيّمها ويوقّعها قبل نشرها في كتالوج NVIDIA.
- ما يفحصه: مجلدًا أو ملف
SKILL.mdأو مستودع Git أو رابطًا أو أرشيف zip.
يذكر README رقمًا لافتًا: في مجموعة جزئية من 31132 مهارة من بيانات بحثية، تحتوي 26.1% من المهارات على ثغرات وتُظهر 5.2% نية خبيثة محتملة. هذا ادعاء المشروع نفسه ولم نتمكن من التحقق منه.
ما الذي يكتشفه الفاحص
يعلن README عن 71 نمطًا موزعة على 17 فئة. منها حقن التعليمات (P1 وP2 وP3)، وتسريب البيانات (E2 لجمع متغيرات البيئة)، ورفع الصلاحيات، وسلسلة التوريد (SC2 للأمر curl | bash وSC4 للاعتمادات ذات الثغرات المعروفة CVE المستعلَم عنها مباشرة في OSV.dev)، وتحليل شيفرة Python (استدعاءات exec() أو eval()).
بحسب وثائق NVIDIA يتم التحليل على مرحلتين. الفحوص الثابتة سريعة وحتمية. والفحوص الدلالية تستخدم نموذجًا لغويًا (LLM) ليقارن ما تدّعيه المهارة بما تفعله شيفرتها. يُبقي الخيار --no-llm على المرحلة الثابتة وحدها.
جولة في تقرير
لا يحتوي المستودع على لقطات واجهة، فالأداة تكتب في الطرفية. يقدّم README مثال إخراج لمهارة اسمها suspicious-skill نعيد عرضه أدناه. إنه مثال README وليس فحصًا أجريناه.

يعرض التقرير أولًا درجة الخطر والخطورة والتوصية. ثم يسرد مكونات المهارة، ومنها scripts/sync.py المعلَّم قابلًا للتنفيذ، وكل ملاحظة مع موقعها ودرجة ثقتها (94% و89% في المثال) وشرحها. هنا تتبع حلقة على os.environ عملية إرسال عبر HTTP: نمط سرقة بيانات اعتماد.
حساب الدرجة موثّق: +50 نقطة لكل ملاحظة CRITICAL و+25 لـ HIGH و+10 لـ MEDIUM و+5 لـ LOW، مع معامل 1.3 للسكربتات القابلة للتنفيذ. من 0 إلى 20 التوصية SAFE، ومن 21 إلى 50 CAUTION، وما فوق 50 DO NOT INSTALL.
التثبيت خطوة بخطوة
الخطوة 1: تثبيت الأداة
يقترح README استخدام uv داخل بيئة افتراضية:
uv tool install git+https://github.com/NVIDIA/skillspector.git
لخادم MCP أضف الإضافة: uv tool install 'skillspector[mcp] @ git+https://github.com/NVIDIA/skillspector.git'. ومن المصدر: git clone ثم إنشاء بيئة افتراضية ثم make install. ينبّه README إلى أن المشروع ينزّل ويثبّت برمجيات حرة أخرى من أطراف ثالثة، فاقرأ رخصها.
بدون Python يمكن بناء صورة Docker من ملف Dockerfile في المستودع:
make docker-build
docker run --rm -v "$PWD:/scan" skillspector scan ./my-skill/ --no-llm
الخطوة 2: تشغيل فحص ثابت
skillspector scan ./my-skill/ --no-llm
يمكن أن يكون الهدف مجلدًا أو ./SKILL.md أو رابط Git أو ملف .zip. بحسب README، التنزيلات محدودة بـ 100 ميبيبايت وأرشيف zip بـ 10000 عنصر.
الخطوة 3: تفعيل التحليل الدلالي
اختر مزوّدًا بالمتغير SKILLSPECTOR_PROVIDER وقدّم مفتاحه. مثال README لـ Anthropic:
export SKILLSPECTOR_PROVIDER=anthropic
export ANTHROPIC_API_KEY=...
skillspector scan ./my-skill/
يذكر README أيضًا OpenAI وBedrock وAzure OpenAI وGemini وOllama (محلي بلا مفتاح) ومزوّدين متوافقين مع OpenAI. مع مزوّد مستضاف يخرج محتوى المهارة إلى تلك الخدمة، فقرّر ذلك قبل فحص مهارة خاصة.
الخطوة 4: اختيار صيغة الإخراج
skillspector scan ./my-skill/ --format json --output report.json
skillspector scan ./my-skill/ --format sarif --output report.sarif
الصيغ هي terminal (الافتراضية) وjson وmarkdown وsarif (SARIF 2.1.0 للتكامل المستمر والمحررات).
ربط الفاحص بالتكامل المستمر وبالوكيل
يصف README الواجهة بأنها عقد مستقر. رمز الخروج 0 إذا كانت الدرجة 50 أو أقل، و1 إذا تجاوزت 50 (أو فشل شرط صارم)، و2 عند الخطأ.

تشدّد الخيارات --fail-on-findings و--fail-on-incomplete و--min-coverage PERCENT البوابة. ولقبول ملاحظات معروفة ينشئ الأمر skillspector baseline ./my-skill/ -o .skillspector-baseline.yaml خط أساس، ثم يعرض --baseline الملاحظات الجديدة فقط.
يعرض خادم MCP أداة واحدة هي scan_skill تعيد risk_score وseverity وrecommendation وsafe_to_install. التسجيل في Claude Code: claude mcp add skillspector -- skillspector mcp. لخلفية MCP راجع دليل خادم GitHub MCP.
مراقبة SkillSpector
لا يصف README أي تصدير إلى OpenTelemetry. هذا ما تتيح الوثائق تتبعه دون اختلاق ميزات:
- رمز الخروج: خطوة تكامل مستمر تفشل بالرمز 1 هي أبسط إشارة. احسب الإخفاقات لكل مستودع وكل أسبوع.
- تقرير JSON: يصلح
risk_assessment.scoreوقائمةissuesلمقياس تصدره بنفسك إلى منصة المراقبة. - كلفة الفحوص: يحوي
metadata.inference_usageلكل ردّ من النموذج عدد الرموز (tokens) المدخلة والمخرجة عندما يعرضها المزوّد. راجع أيضًا كلفة وكيل ذكاء اصطناعي بالرموز. - السجلات: يقبل المتغير
SKILLSPECTOR_LOG_LEVELالقيم DEBUG وINFO وWARNING وERROR (الافتراضي WARNING). - الوكلاء في الإنتاج: يفحص الأداة المهارات قبل استخدامها. وما تفعله بعد ذلك يُتتبع عبر تتبعات OpenTelemetry لوكلاء MCP ومراقبة وكيل البرمجة.
الحدود ونقاط مفتوحة
- لا يعرض المستودع أي إصدار منشور: يُثبَّت من الفرع الرئيسي، فقد يتغير السلوك من يوم إلى آخر.
- درجة منخفضة من فحص ثابت وحده لا تثبت سلامة المهارة؛ ولهذا يذكر خادم MCP الحقلين
llm_usedوscan_mode. وتضيف وثائق NVIDIA أن تقريرًا نظيفًا وحده لا يكفي. - لا يملك نقل HTTP في خادم MCP أي مصادقة. يقبل عناوين الحلقة المحلية فقط (
127.0.0.1أو::1)؛ وللوصول عن بعد ضع وكيلًا يصادق أمامه. - يذكر README مشكلة معروفة في تهيئة نقل stdio (القضية رقم 199).
- المزوّد
codex_cliمعطّل لأن صندوقه المعزول يسمح بقراءة ملفات المضيف. - أرقام الانتشار (26.1% و5.2%) هي أرقام المشروع ولم نتحقق منها من مصدر آخر.
- لأداة مجاورة في أمان المهارات راجع مهارة تدقيق الأمان من Cloudflare.
أفضل الممارسات
- افحص كل مهارة من طرف ثالث قبل تثبيتها، ثم افحص مهارتك قبل نشرها.
- امنع الملاحظات CRITICAL وHIGH إلى أن تُصحَّح أو تُقبل كتابةً، كما توصي وثائق NVIDIA.
- اجمع بين التحليل الثابت والدلالي، وراجع يدويًا المهارات التي تلمس الأسرار.
- استخدم
--fail-on-incompleteفي التكامل المستمر حتى لا يمر فحص جزئي دون انتباه. - أبقِ خادم MCP على واجهة الحلقة المحلية.
الأسئلة الشائعة
هل SkillSpector مجاني؟
الشيفرة برخصة Apache 2.0. أما التحليل الدلالي فيستدعي مزوّد نموذج لغوي تتحمل أنت رسومه، إلا إذا استخدمت نموذجًا محليًا مثل Ollama.
هل يمكن استخدامه بدون مفتاح API؟
نعم، بالخيار --no-llm للمرحلة الثابتة. ويستخدم مزوّدو سطر الأوامر (claude_cli وgemini_cli وopencode_cli) جلسة المصادقة المحلية للأداة المقابلة.
هل يغني عن المراجعة البشرية؟
لا. تساعد الدرجة على الفرز ولا تضمن شيئًا. تطلب وثائق NVIDIA أن يتطابق الغرض المعلن والصلاحيات والشيفرة والمخاطر الموثقة.
خلاصة
يمنح SkillSpector الفرق فحصًا قابلًا للأتمتة قبل تثبيت مهارة: درجة وأنماطًا مسماة ورمز خروج للتكامل المستمر. لا يعرض المستودع أي إصدار منشور. جرّبه أولًا على مهارات لا تحتوي أسرارًا. المصادر: مستودع NVIDIA/SkillSpector ودليل NVIDIA لفحص المهارات. التالي في السلسلة: T3 Code.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، فتحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.