المهارات linux-troubleshooting
🖥️

linux-troubleshooting

آمن ⚙️ الأوامر الخارجية

تشخيص وحل مشاكل نظام لينكس

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

يدعم: Claude Codex Code(CC)
📊 70 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "linux-troubleshooting". الخادم يعمل ببطء. ابدأ استكشاف الأخطاء.

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

  • المرحلة 1 - اكتمل التقييم الأولي:
  • - تشغيل النظام: 45 يوماً
  • - نظام التشغيل: Ubuntu 22.04 LTS
  • - تم اكتشاف تحديث kernel حديث في dmesg
  • المرحلة 2 - تحليل الموارد:
  • - وحدة المعالجة المركزية: استخدام 95٪ بواسطة العملية java (PID 4521)
  • - الذاكرة: 7.8GB/8GB مستخدمة، نشاط تبادل مكثف
  • - القرص: /var عند 92٪ من السعة
  • الإجراء الموصى به: تحقيق في تسرب ذاكرة عملية Java وتنظيف مساحة القرص في /var/log

استخدام "linux-troubleshooting". فشلت خدمة nginx في البدء بعد تغيير التكوين

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

  • نتائج المرحلة 6 - استكشاف أخطاء ال��دمة:
  • - systemctl status nginx: فشل مع رمز الخروج 1
  • - journalctl -u nginx: 'nginx: [emerg] unknown directive' في السطر 47
  • - اختبار التكوين: nginx -t يظهر خطأ في بناء الجملة في /etc/nginx/sites-enabled/default
  • السبب الجذري: توجيه غير صالح تم تقديمه في تحرير التكوين الأخير
  • الإصلاح: استعادة التكوين السابق من النسخة الاحتياطية وإعادة تحميل nginx

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

آمن
v1 • 2/25/2026

All 47 static analysis findings are false positives. The SKILL.md file is documentation-only (markdown) containing workflow instructions and example commands. The detected 'backtick execution' patterns are markdown code fence markers (```bash), not Ruby/shell backticks. The 'hardcoded URL' and 'reconnaissance' patterns are documented examples for users, not executable code. No actual security risks detected.

1
الملفات التي تم فحصها
222
الأسطر التي تم تحليلها
2
النتائج
1
إجمالي عمليات التدقيق
مشكلات منخفضة المخاطر (1)
SKILL.md:42-47SKILL.md:68-73
Documentation Contains Shell Command Examples
The skill documentation includes example shell commands for system diagnostics (uptime, top, df, journalctl, etc.). These are intended for user execution via other skills, not direct code execution by this skill.

عوامل الخطر

⚙️ الأوامر الخارجية (6)
SKILL.md:42-47 SKILL.md:68-73 SKILL.md:94-99 SKILL.md:120-124 SKILL.md:145-150 SKILL.md:171-175
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
32
المجتمع
100
الأمان
83
الامتثال للمواصفات

ماذا يمكنك بناءه

الاستجابة لتوقف خادم الإنتاج

اتبع سير العمل المكون من سبع مراحل لتشخيص سبب توقف خادم الإنتاج عن الاستجابة، وتحديد السبب الجذري (استنفاد الموارد أو فشل الخدمة أو مشكلة شبكية)، وتطبيق إصلاح موثق.

التحقيق في تدهور الأداء

استخدم مراحل تحليل الموارد والتحقيق في العمليات لتحديد العمليات التي تستهلك وحدة المعالجة المركزية أو الذاكرة بشكل مفرط، ثم اعمل مع مهارة server-management لحل المشكلة.

تشخيص فشل الخدمة

طبق مرحلة استكشاف أخطاء الخدمة لتشخيص سبب فشل خدمات systemd في البدء، وراجع السجلات مع مهارة error-detective، ونفذ إصلاحات التكوين.

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

فحص الصحة الأساسي للنظام 
استخدم سير عمل linux-troubleshooting للتحقق من صحة النظام. ابدأ بالمرحلة 1 (التقييم الأولي) والمرحلة 2 (تحليل الموارد). شغّل uptime، وتحقق من استخدام وحدة المعالجة المركزية والذاكرة مع top و free، وأبلغ عن مساحة القرص مع df -h.
الخدمة لا تبدأ 
خدمة حرجة تفشل في البدء. اتبع المرحلة 6 (استكشاف أخطاء الخدمة) للتحقق من systemctl status، وراجع السجلات مع journalctl -u service -f، وحدد مشاكل التكوين. ثم استخدم المرحلة 4 (تحليل السجلات) لل��حث عن أخطاء ذات صلة في /var/log/.
مشاكل الاتصال الشبكي 
لا يمكن للمستخدمين الوصول إلى خادم الويب الخاص بنا. نفذ المرحلة 5 (التشخيصات الشبكية) للتحقق من واجهات الشبكة مع ip addr، والتحقق من المنافذ المستمعة مع ss -tulpn، واختبار الاتصال مع curl، والتحقق من حل DNS مع dig. اربط النتائج بقواعد جدار الحماية.
الاستجابة الكاملة للحادث 
خادم الإنتاج يواجه مشاكل حرجة. شغّل سير عمل linux-troubleshooting الكامل المكون من سبع مراحل: (1) التقييم الأولي، (2) تحليل الموارد، (3) التحقيق في العمليات، (4) تحليل السجلات، (5) التشخيصات الشبكية، (6) استكشاف أخطاء الخدمة، (7) الحل. وثق النتائج في كل مرحلة ونفذ إصلاحات موثقة.

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

  • وثق دائماً النتائج في كل مرحلة قبل الانتقال إلى التالية
  • تحقق من الإصلاحات عن طريق إعادة تشغيل أوامر التشخيص للتأكيد على الحل
  • أنشئ خطط وقائية بعد الحل لتجنب المشاكل المتكررة

تجنب

  • تخطي المراحل والقفز مباشرة إلى إعادة التشغيل دون تشخيص السبب الجذري
  • تنفيذ الإصلاحات دون التحقق أولاً من السبب الجذري المحدد
  • الفشل في مراقبة استقرار النظام بعد تطبيق الحل

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

ما هي المهارات التي أحتاجها لاستخدام هذا سير العمل؟
ينسق هذا سير العمل مع bash-linux لتنفيذ الأوامر، و performance-engineer لتحليل الموارد، و server-management لإدارة العمليات والخدمات، و error-detective لتحليل السجلات، و network-engineer للتشخيصات الشبكية. تحدد كل مرحلة المهارات التي يجب استدعاؤها.
هل يمكن ل هذا سير العمل إصلاح المشاكل تلقائياً؟
لا، هذا دليل سير عمل منظم. يوفر خطوات تشخيص منهجية وينسق مع مهارات أخرى لتنفيذ الأوامر. جميع الإصلاحات تتطلب موافقة المستخدم قبل التنفيذ.
ماذا لو أحتاج فقط إلى التحقق من منطقة واحدة محددة؟
يمكنك تنفيذ مراحل فردية بشكل مستقل. على سبيل المثال، شغّل فقط المرحلة 5 للمشاكل الشبكية أو المرحلة 4 لتحليل السجلات. سير العمل modular وكل مرحلة مكتفية ذاتياً.
كيف أوثق عملية استكشاف الأخطاء؟
تشمل المرحلة 1 جمع النتائج الأولية، وتشمل المرحلة 7 إنشاء وثائق الحل. كل مرحلة لها خط��ة 'توثيق النتائج'. يشجع سير العمل على الحفاظ على سجل استكشاف الأخطاء طوال العملية.
ما هي الأذونات التي أحتاجها لتشغيل هذه التشخيصات؟
معظم أوامر التشخيص (top, df, ss) تعمل مع أذونات المستخدم القياسية. بعض الأوامر مثل journalctl -xe و strace وإدارة الخدمات تتطلب وصول sudo/root. تأكد من أن جلسة Claude Code الخاصة بك لديها أذونات النظام المناسبة.
هل يمكنني استخدام هذا سير العمل للبيئات المحتوية؟
نعم، لكن بعض الأوامر قد تعمل بشكل مختلف داخل الحاويات. الأوامر مثل systemctl قد لا تعمل في الحاويات بدون systemd. تكيف سير العمل باستخدام بدائل خاصة بالحاوية (docker top, docker logs) حيث ينطبق ذلك.

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

المؤلف

sickn33

الترخيص

MIT

المستودع

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/linux-troubleshooting

مرجع

main

بنية الملفات

📄 SKILL.md