كتابة تعليقات شيفرة واضحة ومستدامة
غالبًا ما تضيف الفرق تعليقات تصبح قديمة أو تكرر الشيفرة الواضحة. ترشد هذه المهارة مساعدي الذكاء الاصطناعي إلى كتابة تعليقات محدودة تشرح القرارات غير البديهية.
انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.
Review the Skillstore skill "global-commenting" from https://skillstore.io/skills/devanb-global-commenting.md and its manifest at https://skillstore.io/api/skills/devanb-global-commenting/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.
استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.
جارٍ استخدام "global-commenting". تحتوي طريقة في خدمة على عدة تعليقات تعيد صياغة كل إسناد وشرط.
النتيجة المتوقعة:
تزيل المراجعة التعليقات الزائدة وتحتفظ بملاحظة قصيرة واحدة تشرح قاعدة الأعمال وراء الشرط.
جارٍ استخدام "global-commenting". تحتوي دالة TypeScript على منطق تواريخ معقد بلا سياق.
النتيجة المتوقعة:
تضيف النتيجة ملخص TSDoc موجزًا وتعليقًا مضمنًا واحدًا يشرح قاعدة التقويم.
جارٍ استخدام "global-commenting". يضيف طلب سحب تعليقات حول حل مؤقت لعملية ترحيل.
النتيجة المتوقعة:
تقترح المراجعة إزالة الصياغة المقيدة بالوقت وتوثيق السبب المستقر لفحص التوافق.
The static path traversal alert is a fixed Markdown link to a project standards document, not executable code or user-controlled file access. No prompt injection, data exfiltration, or malicious intent was found in SKILL.md.
شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.
https://skillstore.io/skills/devanb-global-commenting/audits/10?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report[](https://skillstore.io/skills/devanb-global-commenting?utm_source=security_passport_badge)<a href="https://skillstore.io/skills/devanb-global-commenting?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/devanb-global-commenting/security.svg" alt="Skillstore security assessment" loading="lazy"></a><iframe src="https://skillstore.io/embed/skills/devanb-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>DevanB. (2026). global-commenting security audit report (audit version 10) [Author version unspecified]. Skillstore. https://skillstore.io/skills/devanb-global-commenting/audits/10@techreport{devanb-devanb-global-commenting-2026,
author = {DevanB},
title = {global-commenting security audit report (audit version 10)},
institution = {Skillstore},
year = {2026},
number = {10},
url = {https://skillstore.io/skills/devanb-global-commenting/audits/10},
note = {Author version unspecified}
}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: "DevanB"
date-released: "2026-07-09"
url: "https://skillstore.io/skills/devanb-global-commenting/audits/10"
identifiers:
- type: other
value: "skillstore:devanb-global-commenting:audit:10"
description: "Skillstore immutable audit report identifier"
تبقى مهارة كل مؤلف عنصراً مستقلاً قابلاً للتثبيت. يُرتب المتغير الموصى به وفق أدلة Skillstore.
سبب تصدر هذا المتغير
devanb-global-commenting
2026-09-09
eis-its-global-commenting
2026-09-09
راجع التعليقات في قاعدة الشيفرة واحتفظ فقط بما يشرح سياقًا ثابتًا.
أنشئ تعليقات PHPDoc أو JSDoc أو TSDoc تطابق أسلوب تعليقات محدودًا.
حدد التعليقات التي تكرر سلوك الشيفرة واقترح تسمية أو بنية أوضح.
راجع هذه الشيفرة وأضف فقط التعليقات التي تشرح القرارات غير البديهية. تجنب التعليقات التي تكرر ما تقوله الشيفرة بالفعل.
أضف تعليقات PHPDoc أو JSDoc أو TSDoc حيث تساعد المشرفين المستقبليين على الصيانة. اجعل كل تعليق موجزًا ومركزًا على القصد.
راجع التعليقات الموجودة في هذا التغيير. علّم التعليقات القديمة أو الزائدة أو المؤقتة، واقترح بدائل قابلة للاستمرار عند الحاجة فقط.
ابحث عن المواضع التي يمكن أن تزيل فيها الأسماء أو البنية الأوضح الحاجة إلى التعليقات. أضف التعليقات فقط لقواعد الأعمال أو الخوارزميات التي تبقى غير بديهية.
المؤلف
DevanBالترخيص
MIT
مراجعة Skillstore
r1
تنبيه الإصدار
لم يعلن المؤلف عن إصدار.
مرجع
0519034dad657fb1f7706e0550e962beeda73fdf
حداثة الصيانة
١٨/٧/٢٠٢٦
الاستخدام
12 تنزيلات · 204 مشاهدات
بنية الملفات
📄 SKILL.md
بناء واجهات API خلفية بنمط RESTful
غالبًا ما يتعثر العمل على واجهات API الخلفية عند التوجيه، وإدارة الإصدارات، ومعايير الاستجابة. ترشد هذه المهارة Claude وCodex وClaude Code خلال تصميم وتنفيذ نقاط نهاية REST بشكل متسق.
توحيد اتفاقيات التطوير للفريق
غالبا ما تهدر الفرق وقتا عندما تختلف ممارسات بنية المشروع والالتزامات والمراجعات والتهيئة بين المساهمين. تمنح هذه المهارة Claude وCodex وClaude Code قائمة تحقق مشتركة لاتفاقيات تطوير متسقة.
بناء نماذج Backend موثوقة
تحتاج فرق Backend إلى تعريفات نماذج متسقة تتوافق مع معايير قواعد البيانات وORM. ترشد هذه المهارة مساعدي الذكاء الاصطناعي عبر تسمية النماذج، والعلاقات، والتحويلات، والتحقق، والمصانع، والمزودات الأولية.
بناء مكوّنات واجهة أمامية قابلة لإعادة الاستخدام
يصعب إعادة استخدام مكوّنات الواجهة الأمامية الكبيرة واختبارها وصيانتها. توجّه هذه المهارة Claude وCodex وClaude Code لإنشاء مكوّنات React مركّزة ذات props واضحة وحدود واضحة للحالة.
إنشاء ترحيلات خلفية آمنة
يمكن أن تؤدي تغييرات مخطط قاعدة البيانات إلى تعطيل عمليات النشر عندما تفتقر الترحيلات إلى خطط تراجع أو فحوصات توافق. توجه هذه المهارة Claude وCodex وClaude Code نحو ترحيلات مركزة.
تحسين استعلامات قاعدة البيانات في الواجهة الخلفية
غالبًا ما تصبح شيفرة الاستعلامات في الواجهة الخلفية بطيئة أو غير آمنة أو صعبة الصيانة. ترشد هذه المهارة Claude وCodex وClaude Code نحو معلمات أكثر أمانًا، والتحميل المسبق، والفهارس، والتخزين المؤقت، والمعاملات.
إدارة التطوير المعتمد على السياق
بواسطة wshobson
تفقد المشاريع المدعومة بالذكاء الاصطناعي اتساقها عندما تكون أهداف المنتج، وخيارات الحزمة التقنية، وقواعد سير العمل مبعثرة. ترشد هذه المهارة Claude وCodex وClaude Code عبر عناصر سياق Conductor.
تقييم قابلية قراءة الكود لغير المطورين
بواسطة AbeJitsu
تحتاج الفرق غالبًا إلى كود يستطيع المديرون وأصحاب المصلحة والمساهمون الجدد فهمه. تتحقق هذه المهارة من التسمية والتعليقات والمصطلحات المتخصصة والتوثيق كي يحصل المراجعون على درجة واضحة لقابلية القراءة.
تحسين مكوّنات Claude Code
بواسطة C0ntr0lledCha0s
قد تترك تحديثات المكوّنات أوصافًا مبهمة، وأذونات أدوات واسعة، وأمثلة ضعيفة. تطبّق هذه المهارة تحسينات منظّمة تحافظ على السلوك مع تحسين الوضوح والأمان وسهولة الاستخدام.
خطط لمشاريع البرمجيات باستخدام مستندات منظمة
بواسطة Dwsy
غالبًا ما تفشل مشاريع البرمجيات عندما تكون المتطلبات وخيارات التصميم والمهام غير واضحة. تحول هذه المهارة أفكار المشاريع إلى مستندات تخطيط منظمة لسير عمل Claude وCodex وClaude Code.
نظّم مهام الذكاء الاصطناعي الطويلة باستخدام ملفات التخطيط
بواسطة ZhanlinCui
يمكن أن تفقد جلسات الذكاء الاصطناعي الطويلة الأهداف والقرارات والتقدم. ترشد هذه المهارة Claude وCodex وClaude Code إلى تخزين الخطط والنتائج والسجلات في ملفات المشروع.
إنشاء وثائق إصدار GitHub ثنائية اللغة
بواسطة ZhanlinCui
إن إنشاء وثائق إصدار احترافية يتطلب وقتًا ويتسم بالاتساق عبر اللغات. تقوم هذه المهارة بأتمتة إنشاء ملفات README ثنائية اللغة من البيانات الوصفية الموجودة في مستودعك.