troubleshoot について
エージェント向けのトラブルシューティングスキルです。観察から調査、修正、検証までの手順で根本原因を特定し、解決策の記録を促します。根拠に基づく分析と所定の報告形式を用います。
主な機能
- 01体系的な根本原因分析
- 02複数の仮説の提示
- 03ドキュメントやログの確認
- 04修正結果の検証
- 05所定形式での分析記録
活用シーン
- 01コマンドや実行時エラーの診断
- 02盲目的な再試行を避けたタイムアウト調査
- 03再発防止に向けた修正の記録
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/troubleshootを入力して読み込まれたか確認します。
詳細
トラブルシューティング手順
次の体系的な根本原因分析プロセスに従ってください。失敗した理由を理解せずに、同じ方法を決して再試行しないでください。
手順
- 停止：同じコマンドを再実行しないでください
- 観察：実際に何が起きましたか？何が期待されていましたか？
- 仮説：何が原因として考えられますか？（2～3個の可能性を挙げてください）
- 調査：公式ドキュメント、ログ、スタックトレース、設定を確認してください
- 根本原因：症状ではなく、根本的な原因を特定してください
- 修正：根本原因に対処する解決策を実施してください
- 検証：修正が機能することを確認してください
- 学習：今後参照できるよう、解決策を記録してください
アンチパターン（厳禁）
- 「エラーが出ました。もう一度試してみましょう」
- 「再試行：1回目……2回目……3回目……」
- 「タイムアウトしたので、待ち時間を延ばしましょう」（根本原因を無視）
- 「警告はありますが動いているので問題ありません」（将来の技術的負債）
必須の形式
## Root Cause Analysis
**Error**: [Exact error message]
**Expected**: [What should have happened]
**Cause**: [Root cause with evidence]
**Fix**: [Solution addressing root cause]
**Prevention**: [How to prevent recurrence]
これを次に適用します：$ARGUMENTS
コメント
Markdown 対応