mcpField
C
cco-doctor

cco-doctor

github.com/egorfedorovエージェントワークフロー125130 回インストール2 日前に更新
リポジトリ

cco-doctor について

cco-doctorは、Claudeプラグインの状態を確認する診断スキルです。設定、ファイル、データ、モデルの予算設定、Node.jsのバージョンを検証し、任意でユニットテストも実行します。

主な機能

  1. 01プラグインマニフェストとpackageの確認
  2. 02バージョン整合性の検証
  3. 03フック設定とスクリプトの確認
  4. 04データ、設定、統計ファイルの検証
  5. 05Node.jsバージョンの確認
  6. 06任意のユニットテスト実行

活用シーン

  1. 01動作しないプラグインの診断
  2. 02利用前のプラグイン設定確認
  3. 03ヘルスチェックとユニットテストの実行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/egorfedorov/claude-context-optimizer --skill cco-doctor

インストール後、Claude Code で/cco-doctorを入力して読み込まれたか確認します。

詳細

CCO Doctor

ユーザーが /cco-doctor を実行するか、プラグインが「動作しない」と報告した場合は、簡易ヘルスチェックを実行します。

使い方

標準実行（高速 — 1 秒未満）：

node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js

テストスイート付き（低速 — すべての単体テストを実行）：

node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js --tests

チェック項目

  • プラグインマニフェストと package.json が存在する
  • バージョンが一致している（plugin.json と package.json）
  • hooks.json が有効な JSON で、想定されるすべてのイベントタイプが含まれている
  • すべてのフックスクリプトが src/ に存在する
  • データディレクトリ ~/.claude-context-optimizer/ に書き込み可能である
  • patterns.json のサイズが妥当である
  • グローバル統計ファイルを解析できる
  • ユーザー設定で、選択したモデルに適したモデルと予算が設定されている
  • Node のバージョンが >=18 の要件を満たしている

結果の説明

doctor の出力をわかりやすい言葉で説明します。fail があれば、ユーザーに修正方法を案内します。

  • バージョンが一致しない → npm run sync-version
  • patterns.json が大きすぎる → /cco-clean
  • 予算がモデルのコンテキストウィンドウを超えている → /cco-budget set <smaller> を実行するか、1M コンテキストのモデル（例：opus-5.5）を選択します
  • Node のバージョンが古すぎる → Node をアップグレードします

すべてが pass の場合は、「プラグインは正常です。現在のバージョンは Х.Y.Z です」と確認して終了します。

コメント

Markdown 対応