المهارات global-commenting
📦

global-commenting

مراجعة المحتوى r1 آمن 📁 الوصول إلى نظام الملفات

اكتب تعليقات كود واضحة

تصبح التعليقات الضعيفة قديمة وتخفي نية التصميم المهمة. تساعد هذه المهارة Claude وCodex وClaude Code على كتابة تعليقات موجزة تشرح المنطق غير البديهي.

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

التثبيت باستخدام Agent لدي

انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.

طلب الوكيل
Review the Skillstore skill "global-commenting" from https://skillstore.io/skills/eis-its-global-commenting.md and its manifest at https://skillstore.io/api/skills/eis-its-global-commenting/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.

موارد مهيّأة لـ Agents

استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.

تفاصيل Markdown GET /skills/eis-its-global-commenting.md manifest موقَّع GET /api/skills/eis-its-global-commenting/manifest lockfile موقَّع GET /api/skills/eis-its-global-commenting/lockfile

اختبرها

جارٍ استخدام "global-commenting". تحتوي دالة على تعليق يقول إنها تغيرت أثناء ترحيل حديث.

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

استبدله بتفسير ثابت للثابت المنطقي الذي أدخله الترحيل.

جارٍ استخدام "global-commenting". يجمع فحص صلاحيات معقد بين دور المستخدم وحالة الحساب وfeature flags.

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

  • أضف تعليقًا قصيرًا يشرح قاعدة الوصول.
  • لا تصف كل شرط إذا كانت الأسماء واضحة بالفعل.

جارٍ استخدام "global-commenting". يسأل مراجع ما إذا كان كل helper يحتاج إلى docstring.

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

أضف docstrings فقط عندما يحتاج المستدعون إلى معلومات عن العقد أو الأثر الجانبي أو الحدود.

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

آمن
v10 • ٩‏/٧‏/٢٠٢٦ فتح التقرير المرتبط بالإصدار

The static filesystem finding is confirmed because SKILL.md references a parent-directory standards file outside the skill folder. No evidence of prompt injection or other semantic abuse was found in the scanned file, but the external reference makes the effective instructions unaudited.

1
الملفات التي تم فحصها
30
الأسطر التي تم تحليلها
1
عناصر المراجعة
0
تم تجاهل الإيجابيات الكاذبة
عناصر مراجعة القدرات (1)

هذه قدرات محلية حقيقية قد يُتوقع وجودها لهذه المهارة، لذا فهي تتطلب مراجعة ولكن لا تُحتسب كسلوك خبيث مؤكد.

مرتفع
SKILL.md:29
Path traversal sequence
[global commenting](../../../agent-os/standards/global/commenting.md)
SKILL.md line 29 points to ../../../agent-os/standards/global/commenting.md, which escapes the skill directory and asks the assistant to load unaudited content. This broadens filesystem scope and can bypass marketplace review of the actual instructions.

عوامل الخطر

📁 الوصول إلى نظام الملفات (1)
SKILL.md:29
دقّقه: codex عرض سجل التدقيق →
شارك واستشهد بهذا التقرير

شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.

فتح التقرير المرتبط بالإصدار
تقييم الأمان

نسخ رابط التقرير

https://skillstore.io/skills/eis-its-global-commenting/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

شارة Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/eis-its-global-commenting/security.svg)](https://skillstore.io/skills/eis-its-global-commenting?utm_source=security_passport_badge)

شارة HTML

<a href="https://skillstore.io/skills/eis-its-global-commenting?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/eis-its-global-commenting/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

بطاقة قابلة للتضمين

<iframe src="https://skillstore.io/embed/skills/eis-its-global-commenting.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
الاستشهادات الأكاديمية (APA · BibTeX · CFF)

اقتباس APA

EIS-ITS. (2026). global-commenting security audit report (audit version 10) [Author version unspecified]. Skillstore. https://skillstore.io/skills/eis-its-global-commenting/audits/10

اقتباس BibTeX

@techreport{eis-its-eis-its-global-commenting-2026, author = {EIS-ITS}, title = {global-commenting security audit report (audit version 10)}, institution = {Skillstore}, year = {2026}, number = {10}, url = {https://skillstore.io/skills/eis-its-global-commenting/audits/10}, note = {Author version unspecified} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "global-commenting security audit report (audit version 10)" version: "unspecified" type: report authors: - name: "EIS-ITS" date-released: "2026-07-09" url: "https://skillstore.io/skills/eis-its-global-commenting/audits/10" identifiers: - type: other value: "skillstore:eis-its-global-commenting:audit:10" description: "Skillstore immutable audit report identifier"

مقارنة المتغيرات

2 متغيرات قابلة للتثبيت

تبقى مهارة كل مؤلف عنصراً مستقلاً قابلاً للتثبيت. يُرتب المتغير الموصى به وفق أدلة Skillstore.

سبب تصدر هذا المتغير

أعلى تقييم في Skillstore
DevanB موصى به

devanb-global-commenting

تقييم Skillstore 79
موثوقية الأدلة مرتفع
استخدام Skillstore 18
تم التحديث

2026-09-09

EIS-ITS الحالي

eis-its-global-commenting

تقييم Skillstore 78
موثوقية الأدلة مرتفع
استخدام Skillstore 41
تم التحديث

2026-09-09

تقييم Skillstore

سبب هذا التقييم موثوقية الأدلة: مرتفع
55
الهندسة المعمارية
85
قابلية الصيانة
87
المحتوى
70
المجتمع
83
الامتثال للمواصفات

ما الذي يمكنك بناؤه

توثيق المنطق المعقد

أضف تعليقات موجزة للخوارزميات وقواعد العمل والمفاضلات غير البديهية.

تحسين التعليقات الحالية

راجع التعليقات أثناء الصيانة واستبدل الملاحظات القديمة بتفسيرات قابلة للاستمرار.

مراجعة Pull Requests

تحقق مما إذا كانت التعليقات المضافة تشرح النية دون تكرار الكود المقروء.

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

قرر ما إذا كانت التعليقات مطلوبة 
راجع هذا الملف وحدد المواضع التي ستضيف فيها التعليقات سياقًا دائمًا. فضل تحسين الأسماء أو البنية عندما يكون التعليق غير ضروري.
حسن التعليقات الحالية 
راجع التعليقات الحالية في هذا التغيير. أعد كتابة التعليقات القديمة أو المؤقتة أو التي تركز على التعديلات الحديثة.
وثق منطق العمل 
أضف تعليقات لقواعد العمل غير البديهية في هذه الوحدة. اشرح النية والقيود والمفاضلات دون إعادة صياغة كل سطر.
ضع معيارًا لكتابة التعليقات 
دقق جودة التعليقات في هذا المكون عبر الدوال والفئات وAPIs. اقترح نهجًا موجزًا لكتابة التعليقات للتغييرات المستقبلية.

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

  • استخدم التعليقات لشرح النية والقيود والمفاضلات التي لا يستطيع الكود إظهارها بوضوح.
  • حسن الأسماء والبنية والاختبارات قبل إضافة تعليقات تعيد ذكر سلوك واضح.
  • اجعل التعليقات قابلة للاستمرار بتجنب التواريخ وسجل التذاكر وملاحظات التنفيذ المؤقتة.

تجنب

  • إضافة تعليقات تسرد كل سطر من كود مباشر وواضح.
  • ترك تعليقات تصف سلوكًا قديمًا أو إصلاحات حديثة أو حلولًا مؤقتة.
  • استخدام التعليقات للتعويض عن أسماء غير واضحة أو تعقيد يمكن تجنبه.

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

بماذا تساعد هذه المهارة؟
تساعد المساعدين على كتابة تعليقات وdocstrings موجزة تشرح نية دائمة.
هل تكتب تعليقات لكل دالة؟
لا. إنها تفضل الكود الواضح وتضيف التعليقات فقط عندما توفر سياقًا مفيدًا.
هل يمكنها تحسين التعليقات الحالية؟
نعم. يمكنها تحديد التعليقات القديمة أو المؤقتة أو الواضحة واقتراح بدائل أوضح.
هل تدعم docstrings؟
نعم. تنطبق على docstrings وتوثيق الدوال وAPIs والفئات وتعليقات المصدر.
هل يمكنها أن تحل محل دليل أسلوب الفريق؟
لا. توفر إرشادات عامة لكتابة التعليقات ويجب أن تتبع معايير المشروع المحلية.
أي مساعدين يمكنهم استخدامها؟
يشير التقرير إلى أنها متوافقة مع Claude وCodex وClaude Code.

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

المؤلف

EIS-ITS

الترخيص

MIT

مراجعة Skillstore

r1

تنبيه الإصدار

لم يعلن المؤلف عن إصدار.

المستودع

https://github.com/EIS-ITS/vss-cli/tree/main/.claude/skills/global-commenting

مرجع

26421118b848d9f1efc0aa169d8a7a9e7e0a877e

حداثة الصيانة

٢١‏/٧‏/٢٠٢٦

الاستخدام

7 تنزيلات · 216 مشاهدات

بنية الملفات

📄 SKILL.md

المزيد من EIS-ITS

عرض الكل
📦

frontend-accessibility

79

تحسين إمكانية الوصول في الواجهات الأمامية

غالبا ما تفوّت فرق الواجهات الأمامية متطلبات لوحة المفاتيح والدلالات وقارئات الشاشة أثناء العمل الروتيني على واجهات المستخدم. ترشد هذه المهارة Claude وCodex وClaude Code إلى تطبيق فحوصات إمكانية الوصول أثناء إنشاء الواجهات أو تعديلها.

البرمجة والتطوير عرض

مهارات ذات صلة

عرض الكل