doctor について
doctorは、oh-my-claudecodeのインストール問題を診断・修正するスキルです。プラグインのバージョン、旧式フック、設定ファイル、キャッシュを確認し、了承後に修正します。
主な機能
- 01プラグインのバージョンとキャッシュ確認
- 02旧式フックとスクリプトの検出
- 03CLAUDE.md設定の検証
- 04旧式インストールファイルの確認
- 05了承後の問題修正
活用シーン
- 01未インストールや古いプラグインの診断
- 02重複フックや古いキャッシュの検出
- 03OMC設定の不足確認
- 04旧式インストールファイルの整理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ yeachan-heo/ oh-my-claudecode --skill doctorインストール後、Claude Code で/doctorを入力して読み込まれたか確認します。
詳細
Doctor Skill
注:このガイドに記載されているすべての ~/.claude/... パスは、環境変数 CLAUDE_CONFIG_DIR が設定されている場合、それに従います。
タスク:インストールの診断を実行する
あなたは OMC Doctor です。インストールの問題を診断して修正します。
ステップ 1:プラグインのバージョンを確認する
# Get installed version
INSTALLED=$(ls ~/.claude/plugins/cache/omc/oh-my-claudecode/ 2>/dev/null | sort -V | tail -1)
echo "Installed: $INSTALLED"
# Get latest from npm
LATEST=$(npm view oh-my-claude-sisyphus version 2>/dev/null)
echo "Latest: $LATEST"
診断:
- インストール済みのバージョンがない場合:CRITICAL - プラグインがインストールされていません
- INSTALLED != LATEST の場合:WARN - プラグインが古くなっています
- 複数のバージョンが存在する場合:WARN - 古いキャッシュがあります
ステップ 2:settings.json のレガシーフックを確認する
~/.claude/settings.json を読み取り、次のようなエントリを含む "hooks" キーがあるか確認します:
bash $HOME/.claude/hooks/keyword-detector.shbash $HOME/.claude/hooks/persistent-mode.shbash $HOME/.claude/hooks/session-start.sh
診断:
- 見つかった場合:CRITICAL - レガシーフックが重複の原因になっています
ステップ 3:レガシー Bash フックスクリプトを確認する
ls -la ~/.claude/hooks/*.sh 2>/dev/null
診断:
keyword-detector.sh、persistent-mode.sh、session-start.sh、またはstop-continuation.shが存在する場合:WARN - レガシースクリプトがあります(混乱の原因になる可能性があります)
ステップ 4:CLAUDE.md を確認する
# Check if CLAUDE.md exists
ls -la ~/.claude/CLAUDE.md 2>/dev/null
# Check for OMC marker
grep -q "oh-my-claudecode Multi-Agent System" ~/.claude/CLAUDE.md 2>/dev/null && echo "Has OMC config" || echo "Missing OMC config"
診断:
- ファイルがない場合:CRITICAL - CLAUDE.md が設定されていません
- OMC マーカーがない場合:WARN - CLAUDE.md が古くなっています
ステップ 5:古いプラグインキャッシュを確認する
# Count versions in cache
ls ~/.claude/plugins/cache/omc/oh-my-claudecode/ 2>/dev/null | wc -l
診断:
- バージョンが 1 つを超える場合:WARN - 複数のキャッシュ済みバージョンがあります(クリーンアップを推奨)
ステップ 6:curl でインストールされたレガシーコンテンツを確認する
プラグインシステム導入前に curl でインストールされたレガシーエージェント、コマンド、スキルを確認します:
# Check for legacy agents directory
ls -la ~/.claude/agents/ 2>/dev/null
# Check for legacy commands directory
ls -la ~/.claude/commands/ 2>/dev/null
# Check for legacy skills directory
ls -la ~/.claude/skills/ 2>/dev/null
診断:
~/.claude/agents/に oh-my-claudecode 関連のファイルがある場合:WARN - レガシーエージェントがあります(現在はプラグインから提供されています)~/.claude/commands/に oh-my-claudecode 関連のファイルがある場合:WARN - レガシーコマンドがあります(現在はプラグインから提供されています)~/.claude/skills/に oh-my-claudecode 関連のファイルがある場合:WARN - レガシースキルがあります(現在はプラグインから提供されています)
次のようなファイルを確認します:
- agents/ 内の
architect.md、researcher.md、explore.md、executor.mdなど - commands/ 内の
ultrawork.md、deepsearch.mdなど - skills/ 内の oh-my-claudecode 関連の
.mdファイル
レポート形式
すべての確認を実行した後、レポートを出力します:
## OMC Doctor Report
### Summary
[HEALTHY / ISSUES FOUND]
### Checks
| Check | Status | Details |
|-------|--------|---------|
| Plugin Version | OK/WARN/CRITICAL | ... |
| Legacy Hooks (settings.json) | OK/CRITICAL | ... |
| Legacy Scripts (~/.claude/hooks/) | OK/WARN | ... |
| CLAUDE.md | OK/WARN/CRITICAL | ... |
| Plugin Cache | OK/WARN | ... |
| Legacy Agents (~/.claude/agents/) | OK/WARN | ... |
| Legacy Commands (~/.claude/commands/) | OK/WARN | ... |
| Legacy Skills (~/.claude/skills/) | OK/WARN | ... |
### Issues Found
1. [Issue description]
2. [Issue description]
### Recommended Fixes
[List fixes based on issues]
自動修正(ユーザーが確認した場合)
問題が見つかった場合、ユーザーに「これらの問題を自動的に修正しますか?」と尋ねます。
はいの場合、修正を適用します:
修正:settings.json のレガシーフック
~/.claude/settings.json から "hooks" セクションを削除します(ほかの設定はそのまま保持します)
修正:レガシー Bash スクリプト
rm -f ~/.claude/hooks/keyword-detector.sh
rm -f ~/.claude/hooks/persistent-mode.sh
rm -f ~/.claude/hooks/session-start.sh
rm -f ~/.claude/hooks/stop-continuation.sh
修正:古いプラグイン
rm -rf ~/.claude/plugins/cache/oh-my-claudecode
echo "Plugin cache cleared. Restart Claude Code to fetch latest version."
修正:古いキャッシュ(複数のバージョン)
# Keep only latest version
cd ~/.claude/plugins/cache/omc/oh-my-claudecode/
ls | sort -V | head -n -1 | xargs rm -rf
修正:CLAUDE.md がない/古い
GitHub から最新のファイルを取得し、~/.claude/CLAUDE.md に書き込みます:
WebFetch(url: "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claudecode/main/docs/CLAUDE.md", prompt: "Return the complete raw markdown content exactly as-is")
修正:curl でインストールされたレガシーコンテンツ
レガシーエージェント、コマンド、スキルのディレクトリを削除します(現在はプラグインから提供されています):
# Backup first (optional - ask user)
# mv ~/.claude/agents ~/.claude/agents.bak
# mv ~/.claude/commands ~/.claude/commands.bak
# mv ~/.claude/skills ~/.claude/skills.bak
# Or remove directly
rm -rf ~/.claude/agents
rm -rf ~/.claude/commands
rm -rf ~/.claude/skills
注:oh-my-claudecode 関連のファイルが含まれている場合にのみ削除します。ユーザー独自のエージェント、コマンド、スキルがある場合は、警告し、削除する前に確認します。
修正後
修正を適用した後、ユーザーに次のように伝えます:
修正を適用しました。変更を有効にするには、Claude Code を再起動してください。