Claude Inspector
.claude/ディレクトリの包括的な検査を実行し、最適化推奨事項を提供します。
Usage
code
/claude-inspector
Or naturally: "inspect my .claude config", "check Claude Code setup", "audit settings"
Prerequisites
Required subagents (.claude/agents/):
- •
inspector-settings.md - •
inspector-hooks.md - •
inspector-memory.md - •
inspector-mcp.md - •
inspector-rules.md - •
inspector-classification.md
Error if missing: Report which subagent is unavailable and provide template to create it.
Critical: 並列実行
必ず6つのsubagentを単一のメッセージで並列起動してください。
code
// 単一メッセージで6つのTask toolを同時呼び出し Task(subagent_type: "inspector-settings", prompt: "...") Task(subagent_type: "inspector-hooks", prompt: "...") Task(subagent_type: "inspector-memory", prompt: "...") Task(subagent_type: "inspector-mcp", prompt: "...") Task(subagent_type: "inspector-rules", prompt: "...") Task(subagent_type: "inspector-classification", prompt: "...")
ワークフロー
Phase 1: プロジェクト情報収集
code
Use Glob to detect project type: - package.json → Node.js - requirements.txt/pyproject.toml → Python - go.mod → Go - Cargo.toml → Rust
Phase 2: 並列検査実行
| Subagent | 担当領域 |
|---|---|
| inspector-settings | settings.json最適化 |
| inspector-hooks | hooks推奨と自動化 |
| inspector-memory | CLAUDE.md品質チェック |
| inspector-mcp | MCP設定検証 |
| inspector-rules | Rulesディレクトリ活用 |
| inspector-classification | Skills/Subagents分類検証 |
Phase 3: 結果統合
各subagentからのJSON出力を統合し、優先度順にソート。
Phase 4: レポート生成
出力形式: JSON（スキーマは output-schema.json を参照）
優先度システム
| Priority | 基準 | 例 |
|---|---|---|
| Critical | セキュリティリスク、データ損失 | .envが未制限 |
| High | 効率に大影響、ベストプラクティス違反 | permissions未設定 |
| Medium | 便利機能、最適化 | hooks未活用 |
| Low | 軽微な改善 | color未設定 |
検査カテゴリ
| カテゴリ | 検査内容 |
|---|---|
| Settings | 基本設定、セキュリティ、settings.local.json分離 |
| Hooks | 既存hooks分析、セキュリティ、推奨hooks |
| Memory | CLAUDE.md存在・品質・構造、.gitignore連携 |
| MCP | .mcp.json検証、セキュリティ、推奨サーバー |
| Rules | ディレクトリ活用、既存分析、推奨Rules |
| Classification | Skills/Subagents分類、Frontmatter検証、誤分類検出 |
Quick Wins
すぐに実装できて効果の高い改善を抽出：
- •実装時間: 2-5分
- •影響度: High以上
- •具体的な手順付き
プロジェクトタイプ別対応
| タイプ | カスタマイズ |
|---|---|
| Node.js/TypeScript | npm hooks, ESLint連携, Node.js MCP |
| Python | 仮想環境チェック, pip hooks, Python MCP |
| Git連携 | Git hooks, GitHub MCP, Commit規約Rules |
制約事項
- •Read-only: 設定ファイルを変更しない（検査のみ）
- •並列実行必須: 6つのsubagentを同時起動
- •JSON出力: 構造化されたレポート
Error Handling
| Issue | Solution |
|---|---|
| subagentファイル未検出 | ls .claude/agents/inspector-*.md で確認 |
| 検査時間が長い | 大規模プロジェクトの場合は正常 |
| 結果統合エラー | 各subagentの出力を個別確認 |
References
- •output-schema.json - 出力JSONスキーマ
- •classification-criteria.md - 分類基準詳細
- •official-guidelines.md - 公式ガイドライン要約