技能 claude-code-debug
🔧
Claude Codeの拡張機能、フック、エージェントが動作しなくなることがあります。このスキルは、ステップバイステップのトラブルシューティングガイドと診断コマンドを提供し、共通の問題を迅速に特定・修正します。スキルが読み込まれない、フックが実行されない、またはエージェントが使用されない場合に使用してください。
支援: Code(CC)
1
下載技能 ZIP
2
在 Claude 中上傳
前往 設定 → 功能 → 技能 → 上傳技能
3
開啟並開始使用
測試它
正在使用「claude-code-debug」。 スキルが有効化されません
預期結果:
- .claude/skills/skill-name/にスキルディレクトリが存在するか確認
- SKILL.mdが大文字と小文字的区别も含めて正確に存在するか確認
- YAMLフロントマターが---で始まりと終わりになっているか確認
- name:フィールドがディレクトリ名と完全に一致しているか確認
- トリガーキーワードを追加: Triggers on: keyword1, keyword2
- claude --debugを実行してスキルの読み込みエラーを確認
安全審計
安全v2 • 1/10/2026
This skill is a pure documentation resource containing troubleshooting guides, diagnostic commands, and decision trees for Claude Code. No executable code, no network calls, no file system access beyond reading its own markdown files. All content is transparent documentation meant to help users debug their Claude Code setup.
4
已掃描檔案
562
分析行數
0
發現項
2
審計總數
未發現安全問題
審計者: claude 查看審計歷史 →
品質評分
45
架構
100
可維護性
81
內容
31
社群
100
安全
70
規範符合性
你能建構什麼
スキルが読み込まれない
正しくファイル構造とYAMLフロントマターを使用しているにもかかわらず、新しくインストールしたスキルが有効化されない場合
フックが実行されない
settings.jsonで構成したフックスクリプトが実行されない、または期待通りにツールをブロックしない場合
MCPサーバーの問題
Model Context Protocolサーバーが接続できない場合、またはツールが使用できない場合
試試這些提示
基本的なデバッグ依頼
私のClaude Codeスキルが有効化されません。どのようにトラブルシューティングすればよいですか？
フックの問題
私のフックスクリプトがツール使用時に実行されません。どのような診断ステップに従えばよいですか？
エージェントの問題
Claude Codeが私のカスタムエージェントを使用しません。正しく構成されていることを確認するにはどうすればよいですか？
MCPデバッグ
私のMCPサーバーが接続されません。問題を特定するためのデバッグフローを案内してください。
最佳實務
- 'claude --debug'を実行して詳細な読み込みと権限情報を表示
- 保存前に'jq .'でJSONファイルを検証
- フックスクリプトを信頼する前に手動でテスト
避免
- YAMLフロントマターの検証ステップをスキップ
- フック構成で$CLAUDE_PROJECT_DIRなしで相対パスを使用
- 特定のトリガーキーワードを追加せずにスキルが有効化されると想定
常見問題
このスキルは何的工具を使用しますか？
このスキルはBashツールとReadツールを使用して、診断コマンドの実行と設定ファイルの表示帮助你。
このスキルの制限は何ですか？
このスキルはガイダンスのみを提供します。システムでコマンドを実行したり、設定ファイルを変更したりすることはできません。
これはClaude Codeとどのように統合されますか？
デバッグシナリオを説明するとスキルが有効化されます。あなたが自分で実行するコマンドを文書化して提供します。
私のデータは安全ですか？
はい。このスキルは文書のみを読み取り、コマンドを提案します。あなたのファイルにアクセスしたり、どこかにデータを送信したりすることは決してありません。
なぜフックが実行されないのですか？
一般的な原因: スクリプトが実行可能でない(chmod +x)、間違ったツール名 matcher (大文字小文字を区別)、settings.jsonに無効なJSON。
ビルトインのデバッグとどう異なりますか？
このスキルは基本的な/hooksや/agentsコマンドを超えた包括的なデシジョンツリーと例を提供します。