スキル linux-troubleshooting
🖥️

linux-troubleshooting

安全 ⚙️ 外部コマンド

Linux 시스템 문제 진단 및 해결

Linux 관리자는 체계적인 진단이 필요한 복잡한 시스템 장애에 직면합니다. 이 워크플로우는 근본 원인을 체계적으로 식별하고 검증된 수정 사항을 구현하는 7단계 접근 방식을 제공합니다.

対応: Claude Codex Code(CC)
🥉 73 ブロンズ
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「linux-troubleshooting」を使用しています。 서버가 느리게 실행되고 있습니다. 문제 해결을 시작하세요.

期待される結果:

  • 1단계 - 초기 평가 완료:
  • - 시스템 가동 시간: 45일
  • - OS: Ubuntu 22.04 LTS
  • - dmesg에서 최신 커널 업데이트 감지됨
  • 2단계 - 리소스 분석:
  • - CPU: 프로세스 java(PID 4521)가 95% 사용
  • - 메모리: 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)
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.
監査者: claude

品質スコア

38
アーキテクチャ
100
保守性
87
コンテンツ
50
コミュニティ
100
セキュリティ
83
仕様準拠

作れるもの

프로덕션 서��� 장애 응답

7단계 워크플로우를 따라 프로덕��� 서버가 응답하지 않는 이유를 진단하고, 근본 원인(리소스 고갈, 서비스 실패 또는 네트워크 문제)을 식별하며, 검증된 수정 사항을 구현하세요.

성능 저하 조사

리소스 분석 및 프로세스 조사 단계를 사용하여 과도한 CPU ���는 메모리를 소비하는 프로세스를 식별한 다음 server-management 스킬과 함께 작업하여 문제를 해결하세요.

서비스 실패 진단

서비스 문제 해결 단계를 적용하여 systemd 서비스가 시작하지 못하는 이유를 진단하고, error-detective 스킬로 로그를 검토하며, 구성 수정을 구현하세요.

これらのプロンプトを試す

기본 시스템 상태 확인
linux-troubleshooting 워크플로우를 사용하여 시스템 상태를 확인하세요. 1단계(초기 평가)와 2단계(리소스 분석)부터 시작하세요. uptime을 ��행하고, top 및 free로 CPU 및 메모리 사용량을 확인하며, df -h로 디스크 공간을 보고하세요.
서비스 시작 실패
중요한 서비스가 시작하지 못하고 있습니다. 6단계(서비스 문제 해결)를 따라 systemctl status를 확인하고, journalctl -u service -f로 로그를 검토하며, 구성 문제를 식별하세요. 그런 다�� 4단계(로그 분석)를 사용하여 /var/log/에서 관련 오류를 검색하세요.
네트워크 연결 문제
사용자가 웹 서버에 연결할 수 없습니다. 5단계(네트워크 진단)를 실행하여 ip addr로 네트워크 인터페이스를 확인하고, ss -tulpn으로 수신 대기 포트를 확인하며, curl로 연결을 테스트하고, dig로 DNS 확인을 확인하세요. 방화벽 규칙과 발견 사항을 연관시키세요.
전체 인시던트 응답
프로덕션 서버�� 심각한 문제가 발생했습니다. 전체 7단��� linux-troubleshooting 워크플로우를 실행하세요: (1) 초기 평가, (2) 리소스 분석, (3) 프로세스 조사, (4) 로그 분석, (5) 네트워크 진단, (6) 서비스 문제 해결, (7) 해결. 각 단계에서 발견 사항을 문서화하고 검증된 수정 사항을 구현하세요.

ベストプラクティス

  • 다음 단계로 진행하기 전에 항상 각 단계에�� 발견 사항을 문서화하세요
  • 진단 명령을 다시 ���행하여 해결을 확인하여 수정 사항을 검증하세요
  • 반복되는 문제를 방지하기 위해 해결 후 예방 계획을 수립하세요

回避

  • 근본 원인을 진단하지 않고 단계를 건너뛰어 바로 재시작하는 것
  • 식별된 근본 원인을 먼저 검증하지 않고 수정 사항을 구현하는 것
  • 해결 방법을 적용한 후 시스템 안정성을 모니터링하지 않는 것

よくある質問

이 워크플로우를 사용하려면 어떤 스킬이 필요합니까?
이 ���크플로우는 명령 실행을 위해 bash-linux와, 리소스 분석을 위해 performance-engineer와, 프로세스 및 서비스 관리를 위해 server-management와, 로그 분석을 위해 error-detective와, 네트워크 진단을 위해 network-engineer와 조율합니다. 각 단계는 호출할 스킬을 지정합니다.
이 워크플로우가 문제를 자동으로 수정할 수 있나요?
아니요, 이것은 구조화된 워크플로우 가이드입니다. 체계적인 진단 단계를 제공하고 명령을 실행하기 위해 다른 스킬과 조율합니다. 모든 수정 사항은 구현 전에 사용자 승인이 필요합니다.
하나의 특정 영역만 확인해야 한다면 어떻게 하나요?
네, 개��� 단계를 독립적으로 실행할 수 있습니다. 예를 들어, 네트워크 문제의 경우 5단계만 실행하거나 로그 ��석의 경우 4단계만 실행할 수 있습니다. 워크플로우는 모듈식이며 각 단계는 자체 포함되어 있습니다.
문제 해결 프로세스를 어떻게 문서화하나요?
1단계에는 초기 발견 사항 수집이 포함되고, 7단계에는 해결 문서 작성이 포함됩니다. 각 단���에는 '발견 사항 문서화' 단계가 있습니다. 워크플로우는 전체 과정에서 문제 해결 로그를 유지 관리하도록 권장합니다.
이러한 진단을 실행하려면 어떤 권한이 필요합니까?
대부분의 진단 명령(top, df, ss)은 표준 사용자 권한으로 작동합니다. journalctl -xe, strace 및 서비스 관리와 같은 일부 명령은 sudo/root 액세스가 ��요합니다. Claude Code 세션에 적절한 시스템 권한이 있는지 확인하세요.
컨테이너화된 환경에서 이 워크플로우를 사용할 수 있나요?
네, 하지만 일부 명령은 컨테이너 내에서 다르게 작동할 수 있습니다. systemctl과 같은 명령은 systemd가 없는 컨테이너에서 작동하지 않을 수 있습니다. 해당하는 경우 컨테이너별 대안(docker top, docker logs)을 사용하여 워크플로우를 조정하세요.

開発者の詳細

ファイル構成

📄 SKILL.md