global-commenting
اكتب تعليقات برمجية نظيفة ومركزة
또한 다음에서 사용할 수 있습니다: DevanB
التعليقات السيئة أو القديمة تخلق الارتباك والديون التقنية. توفر هذه المهارة إرشادات واضحة لكتابة التعليقات التي تشرح لماذا تم اتخاذ القرارات، مما يساعد المطورين على إنشاء كود توثيقي ذاتي يبقى ذا صلة مع مرور الوقت.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
테스트해 보기
"global-commenting" 사용 중입니다. اكتب تعليقاً لدالة الفرز
예상 결과:
- • اشرح لماذا تم اختيار الفرز السريع بدلاً من دمج الفرز (استخدام الذاكرة في المكان)
- • وثق استراتيجية اختيار المحور
- • لاحظ الحالات الخاصة التي يتم التعامل معها
- • تجنب وصف ما هو الفرز السريع - القراء يعرفون الخوارزمية
보안 감사
안전Pure documentation skill containing only markdown files with commenting guidelines. No executable code, network access, filesystem operations, or command execution. All 24 static findings are false positives from over-aggressive pattern matching on Git metadata, documentation references, and benign terminology.
위험 요인
🌐 네트워크 접근 (1)
📁 파일 시스템 액세스 (4)
품질 점수
만들 수 있는 것
كتابة تعليقات واضحة
أضف تعليقات ذات معنى تشرح المنطق المعقد والقرارات غير الواضحة في قاعدة الكود الخاصة بك.
تحسين التوثيق
راجع وحسن التعليقات الموجودة من حيث الوضوح والملاءمة أثناء مراجعات الكود.
توثيق واجهات برمجة التطبيقات
أنشئ سلاسل وثائق متسقة وتعليقات واجهات برمجة التطبيقات باتباع المعايير المعتمدة.
이 프롬프트를 사용해 보세요
أضف تعليقاً واضحاً إلى هذه الدالة الذي يشرح لماذا تم اختيار هذا النهج، مع التركيز على منطق الأعمال وأي قرارات غير واضحة.
راجع هذه التعليقات وحدد أي منها قديم أو متكرر أو يمكن استبداله بكود أكثر وضوحاً أو أسماء متغيرات.
اكتب تعليقاً يشرح نهج الخوارزمية ولماذا يحل هذه المشكلة بشكل أفضل من البدائل.
اقترح كيفية جعل هذا الكود أكثر وضوحاً من خلال التسمية والبنية، وأين ستظل التعليقات تضيف قيمة.
모범 사례
- اشرح لماذا يوجد الكود، وليس ما يفعله
- فضل التسمية الواضحة والبنية على التعليقات المفرطة
- حافظ على التعليقات الدائمة - تجنب توثيق الإصلاحات المؤقتة
- أزل أو حدث التعليقات القديمة عند إعادة الهيكلة
피하기
- التعليق على الكود الواضح (مثل زيادة عداد)
- استخدام التعليقات لتعطيل الكود (كتل معلقة)
- كتابة التعليقات التي تصف التغييرات الأخيرة بدلاً من نية الكود
- إضافة التعليقات التي ستصبح قديمة مع التغييرات المستقبلية