shellcheck-configuration
تكوين ShellCheck للتحقق الموثوق من البرامج النصية
تظل مشكلات البرامج النصية للـ shell مخفية حتى مرحلة الإنتاج وتبطئ مراجعات الكود. تشرح هذه المهارة إعداد ShellCheck وتكوين القواعد وتد سير العمل لاكتشاف المشكلات قبل الدمج.
تنزيل ZIP المهارة
رفع في Claude
اذهب إلى Settings → Capabilities → Skills → Upload skill
فعّل وابدأ الاستخدام
اختبرها
استخدام "shellcheck-configuration". I need help understanding SC2086 and how to fix it
النتيجة المتوقعة:
- SC2086 هو تحذير توسيع المتغير غير المقتبس
- قم بالإصلاح عن طريق اقتباس المتغيرات أو استخدام صيغة المصفوفة
- مثال: غير 'for i in $list' إلى 'for i in "$list"' أو 'for i in "${list[@]}"'
استخدام "shellcheck-configuration". Create a .shellcheckrc for a Bash project
النتيجة المتوقعة:
- حدد shell=bash لتحليل لهجة Bash
- فتح الفحوصات الاختيارية مثل require-variable-braces
- تعطيل SC1091 للملفات المصدرية التي قد لا توجد
- وثق كل رمز معطل بتعليق يشرح السبب
التدقيق الأمني
آمنPure documentation skill containing only markdown guidance for ShellCheck, a legitimate open-source static analysis tool. All static findings are false positives. References like SC2009, SC2086 are ShellCheck error codes (not C2 keywords), sha256sum is appropriate for caching (not weak crypto), and shell examples are documentation (not malicious patterns).
عوامل الخطر
🌐 الوصول إلى الشبكة (5)
⚙️ الأوامر الخارجية (72)
📁 الوصول إلى نظام الملفات (5)
درجة الجودة
ماذا يمكنك بناءه
إضافة التحقق من shell في CI
إعداد ShellCheck في خطوط CI مع أعلام متسقة وقواعد الفشل.
إصلاح التحذيرات الشائعة
فهم رموز ShellCheck الرئيسية وتطبيق أنماط اقتباس وتدفق أكثر أماناً.
توحيد قواعد التحقق
تعريف إعدادات .shellcheckrc المشتركة وسياسات التوثيق.
جرّب هذه الموجهات
اشرح كيفية تثبيت ShellCheck وتشغيله على برنامج نصي واحد. قم بتضمين أمثلة الأوامر للتثبيت على Ubuntu وضد ملف Bash.
صمم .shellcheckrc لبرامج Bash النصية مع بعض الفحوصات الممكنة ورمزين معطلين. اشرح كل إعداد.
قدم خطوة GitHub Actions بسيطة تثبت ShellCheck وتشغله على جميع ملفات .sh، مع الفشل عند التحذيرات.
أظهر كيفية قمع SC1091 وSC2119 في برنامج نصي للـ shell ووثق لماذا كل قمع آمن.
أفضل الممارسات
- حدد الـ shell المستهدف صراحة قبل التحقق ليتوافق مع بيئة النشر الخاصة بك
- وثق كل رمز مضغوط بتعليق يشرح المبرر
- شغل ShellCheck في كل من خطافات pre-commit وCI للكشف المحلي والبعيد المبكر
تجنب
- تعطيل التحذيرات على نطاق واسع دون مبرر محدد لكل رمز
- التحقق من برامج Bash النصية كـ POSIX sh دون فهم متطلبات التوافق
- تجاهل فشل ShellCheck في CI أو تجاوز رموز الخروج دون مراجعة
الأسئلة المتكررة
Is this compatible with Bash and POSIX sh?
What are the limits of this skill?
Can it integrate with CI systems?
Does it access my files or credentials?
What if ShellCheck reports too many warnings?
How does it compare to generic linters?
تفاصيل المطور
المؤلف
wshobsonالترخيص
MIT
المستودع
https://github.com/wshobson/agents/tree/main/plugins/shell-scripting/skills/shellcheck-configurationمرجع
main
بنية الملفات
📄 SKILL.md