mcpField
L
linux-troubleshooting

linux-troubleshooting

github.com/sickn33クラウド・DevOps48.7k207 回インストール今日更新
リポジトリ

linux-troubleshooting について

linux-troubleshooting は、Linux の性能、サービス、ネットワーク、ディスク、アプリケーションの問題を調査する段階的なワークフローです。範囲を限定した読み取り専用の診断から始め、権限や機密情報への配慮、変更前の復旧準備を重視します。

主な機能

  1. 01システム状態と変更履歴の確認
  2. 02CPU・メモリ・ディスク・I/O の分析
  3. 03プロセスとログの調査
  4. 04ネットワークとサービスの診断
  5. 05修正の検証と記録

活用シーン

  1. 01Linux ホストの性能低下の調査
  2. 02サービス障害とエラーログの調査
  3. 03接続性や DNS の問題の診断
  4. 04ディスク容量やアプリケーション問題の特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill linux-troubleshooting

インストール後、Claude Code で/linux-troubleshootingを入力して読み込まれたか確認します。

詳細

Linux トラブルシューティングワークフロー

概要

パフォーマンスの問題、サービス障害、ネットワークの問題、リソースの制約など、Linux システムの問題を診断して解決するための専門的なワークフローです。

このワークフローを使用する場合

次の場合にこのワークフローを使用します。

  • システムのパフォーマンス問題を診断する
  • サービス障害をトラブルシューティングする
  • ネットワークの問題を調査する
  • ディスク容量の問題を解決する
  • アプリケーションエラーをデバッグする

範囲と運用上の境界

指定された許可済みホストで、読み取り専用かつ範囲を限定した診断から開始します。ログ、プロセス引数、トレースには認証情報や個人データが含まれる場合があります。必要な情報だけを収集し、共有する前に機密情報を伏せてください。strace のアタッチはタイミングに影響し、ペイロードを露出させる可能性があります。適用されるトレース権限を取得し、速やかにデタッチしてください。サービスの再起動はユーザーへの割り込みや処理中の作業の消失につながる可能性があります。設定と依存関係を調べ、証拠を保全し、許可を得て再起動する前に復旧手順に合意してください。コマンドはディストリビューション、init システム、インストール済みツールに合わせて調整してください。すべてのフェーズを実行するためだけに、パッケージをインストールしたり権限を昇格したりしないでください。

ワークフローのフェーズ

フェーズ 1：初期評価
呼び出すスキル
  • bash-linux - Linux コマンド
  • devops-troubleshooter - トラブルシューティング
アクション
  1. システムの稼働時間を確認する
  2. 最近の変更を確認する
  3. 症状を特定する
  4. エラーメッセージを収集する
  5. 調査結果を記録する
コマンド
uptime
hostnamectl
cat /etc/os-release
dmesg | tail -50
コピーして貼り付けるプロンプト
Use @bash-linux to gather system information
フェーズ 2：リソース分析
呼び出すスキル
  • bash-linux - リソース関連のコマンド
  • performance-engineer - パフォーマンス分析
アクション
  1. CPU 使用率を確認する
  2. メモリを分析する
  3. ディスク容量を確認する
  4. I/O を監視する
  5. ネットワークを確認する
コマンド
top -bn1 | head -20
free -h
df -h
iostat -x 1 5
コピーして貼り付けるプロンプト
Use @performance-engineer to analyze system resources
フェーズ 3：プロセス調査
呼び出すスキル
  • bash-linux - プロセス関連のコマンド
  • server-management - プロセス管理
アクション
  1. 実行中のプロセスを一覧表示する
  2. リソースを大量に消費するプロセスを特定する
  3. プロセスの状態を確認する
  4. プロセスツリーを確認する
  5. strace の出力を分析する
コマンド
ps aux --sort=-%cpu | head -10
pstree -p
lsof -p PID
strace -p PID
コピーして貼り付けるプロンプト
Use @server-management to investigate processes
フェーズ 4：ログ分析
呼び出すスキル
  • bash-linux - ログ関連のコマンド
  • error-detective - エラー検出
アクション
  1. システムログを確認する
  2. アプリケーションログを確認する
  3. エラーを検索する
  4. ログのパターンを分析する
  5. イベントを相互に関連付ける
コマンド
journalctl -xe
tail -f /var/log/syslog
grep -i error /var/log/*
コピーして貼り付けるプロンプト
Use @error-detective to analyze log files
フェーズ 5：ネットワーク診断
呼び出すスキル
  • bash-linux - ネットワーク関連のコマンド
  • network-engineer - ネットワークのトラブルシューティング
アクション
  1. ネットワークインターフェースを確認する
  2. 接続をテストする
  3. 接続状況を分析する
  4. ファイアウォールルールを確認する
  5. DNS 名前解決を確認する
コマンド
ip addr show
ss -tulpn
curl -v http://target
dig domain
コピーして貼り付けるプロンプト
Use @network-engineer to diagnose network issues
フェーズ 6：サービスのトラブルシューティング
呼び出すスキル
  • server-management - サービス管理
  • systematic-debugging - デバッグ
アクション
  1. サービスの状態を確認する
  2. サービスログを確認する
  3. サービスの再起動をテストする
  4. 依存関係を確認する
  5. 設定を確認する
コマンド
systemctl status service
journalctl -u service -f
systemctl restart service
コピーして貼り付けるプロンプト
Use @systematic-debugging to troubleshoot service issues
フェーズ 7：解決
呼び出すスキル
  • incident-responder - インシデント対応
  • bash-pro - 修正の実装
アクション
  1. 修正を実施する
  2. 解決を確認する
  3. 安定性を監視する
  4. 解決策を記録する
  5. 再発防止計画を作成する
コピーして貼り付けるプロンプト
Use @incident-responder to implement resolution

トラブルシューティングチェックリスト

  • システム情報を収集済み
  • リソースを分析済み
  • ログを確認済み
  • ネットワークをテスト済み
  • サービスを確認済み
  • 問題を解決済み
  • ドキュメントを作成済み

品質ゲート

  • 根本原因を特定済み
  • 修正を検証済み
  • 監視を設定済み
  • ドキュメントを完成済み

関連するワークフローバンドル

  • os-scripting - OS スクリプティング
  • bash-scripting - Bash スクリプティング
  • cloud-devops - DevOps

制限事項

  • このスキルは、タスクが上記のスコープに明確に一致する場合にのみ使用してください。
  • 出力を、環境固有の検証、テスト、専門家によるレビューの代替として扱わないでください。
  • 必要な入力、権限、安全境界、成功基準が欠けている場合は、作業を中断して確認を求めてください。

コメント

Markdown 対応