mcpField
D
doctor

doctor

github.com/yeachan-heoエージェントワークフロー40.4k36 回インストール2 日前に更新
リポジトリ

doctor について

doctorは、oh-my-claudecodeのインストール問題を診断・修正するスキルです。プラグインのバージョン、旧式フック、設定ファイル、キャッシュを確認し、了承後に修正します。

主な機能

  1. 01プラグインのバージョンとキャッシュ確認
  2. 02旧式フックとスクリプトの検出
  3. 03CLAUDE.md設定の検証
  4. 04旧式インストールファイルの確認
  5. 05了承後の問題修正

活用シーン

  1. 01未インストールや古いプラグインの診断
  2. 02重複フックや古いキャッシュの検出
  3. 03OMC設定の不足確認
  4. 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.sh
  • bash $HOME/.claude/hooks/persistent-mode.sh
  • bash $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 を再起動してください。

コメント