| name | claude-inspector |
| description | Comprehensive .claude/ directory inspector. Orchestrates multiple specialized subagents to analyze settings, hooks, memory, MCP, rules, and skills/subagents classification. Provides prioritized recommendations with examples and rationale. |
| allowed-tools | ["Task","Read","Glob"] |
Claude Inspector
.claude/ディレクトリの包括的な検査を実行し、最適化推奨事項を提供します。
Usage
/claude-inspector
Or naturally: "inspect my .claude config", "check Claude Code setup", "audit settings"
Prerequisites
Required subagents (.claude/agents/):
inspector-settings.mdinspector-hooks.mdinspector-memory.mdinspector-mcp.mdinspector-rules.mdinspector-classification.md
Error if missing: Report which subagent is unavailable and provide template to create it.
Critical: 並列実行
必ず6つのsubagentを単一のメッセージで並列起動してください。
// 単一メッセージで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: プロジェクト情報収集
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
