mcpField
D
docs-check

docs-check

github.com/oliver-kriskaテスト・品質57145 回インストール6 日前に更新
リポジトリ

docs-check について

docs-checkは、Claude Codeプラグインのエージェント、スキル、フック、設定を現行ドキュメントに照らして検証するスキルです。キャッシュしたドキュメントとの比較とローカルの構造チェックを行い、対象コンポーネントも指定できます。

主な機能

  1. 01エージェント、スキル、フック、設定の検証
  2. 02Claude Codeドキュメントの取得とキャッシュ
  3. 03構造チェックのみのクイックモード
  4. 04指定コンポーネントに絞った検査
  5. 05問題の報告とPRの提案

活用シーン

  1. 01ドキュメント変更によるプラグインへの影響確認
  2. 02ドキュメント取得なしでローカル構造を検査
  3. 03フックまたは設定だけを確認
  4. 04プラグインコンポーネント向けの新機能を調査

インストール

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

$npx skills add https://github.com/oliver-kriska/claude-elixir-phoenix --skill docs-check

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

同梱ファイルreferences/doc-pages.mdreferences/validation-rules.md

詳細

プラグインドキュメント互換性チェック

プラグインのエージェント、スキル、フック、設定が最新の Claude Code ドキュメントと互換性があるか検証し、破壊的変更を検出して新機能を見つけます。

使い方

/docs-check                    # Full validation (all components)
/docs-check --quick            # Structural checks only (no docs fetch, no tokens)
/docs-check --focus=agents     # Validate only agents
/docs-check --focus=skills     # Validate only skills
/docs-check --focus=hooks      # Validate only hooks
/docs-check --focus=config     # Validate only plugin.json/marketplace.json

アーキテクチャ（OTP スーパービジョンパターン）

┌─────────────────────────────────────────────────────────────────┐
│  /docs-check (skill entry point)                                │
│   │                                                             │
│   ├─ Step 1: bash scripts/fetch-claude-docs.sh (zero tokens)    │
│   │          Always fetches all 9 doc pages (~420KB)             │
│   │                                                             │
│   └─ Step 2: delegate to orchestrator (reads from cache only)   │
│       │                                                         │
│       │  docs-validation-orchestrator (opus)                    │
│       │                                                         │
│       │  SCAN → READ CACHE → SPAWN WORKERS → COMPRESS → REPORT │
│       │   │         │              │             │          │   │
│       │   ↓         ↓              ↓             ↓          ↓   │
│       │ inventory  pre-fetched  4 parallel    context    report │
│       │ plugin     docs-cache   subagents     supervisor       │
│       │ components              (sonnet)      (haiku)          │
│       └─────────────────────────────────────────────────────────┘
└─────────────────────────────────────────────────────────────────┘

実行

ステップ 1：ドキュメントを取得する（自動）

必ず最初に実行してください。 すべてのドキュメントページをダウンロードしてキャッシュします。24 時間以内にキャッシュ済みのページはスキップします。トークンコストはゼロです。curl のみで実行します。

# --quick mode: skip this step entirely (structural checks only)
# All other modes: always fetch
bash scripts/fetch-claude-docs.sh
ステップ 2：オーケストレーターに委任する

ドキュメントがキャッシュされたら、委任します。オーケストレーターはキャッシュのみを読み取り、キャッシュファイルが見つからない場合はクラッシュします。

Task(subagent_type: "docs-validation-orchestrator")

プロンプトでユーザーのフラグ（--quick、--focus）を渡します。

オーケストレーターの処理内容

  1. インベントリ — plugins/elixir-phoenix/ をスキャンして既存のコンポーネントを確認します
  2. キャッシュ済みドキュメントを読み取る — .claude/docs-check/docs-cache/ から読み取ります（取得は行いません）
  3. ワーカーを起動する — コンポーネントの種類ごとに Sonnet サブエージェントを 1 つずつ、並列で起動します
  4. 圧縮する — ワーカーが 3 つ以上の場合、context-supervisor（Haiku）を使用します
  5. 構造チェック — 高速なローカルチェックを必ず実行します
  6. 報告と対応 — レポートを作成し、問題が見つかった場合は PR を提案します

絶対遵守事項

  1. すべてのドキュメントを事前に取得する — 条件付きの取得や部分ダウンロードは行いません
  2. scripts/fetch-claude-docs.sh を使用する — ドキュメント取得の唯一の情報源です
  3. ドキュメントはプロンプト内でワーカーに渡す — 実行時に取得しません
  4. ワーカーには Sonnet を使用する — 比較タスクに Opus を使うのは無駄です
  5. 構造チェックは必ず実行する — ドキュメントの取得に失敗した場合も実行します
  6. 破壊的変更はブロッカーとして扱う — 目立つように報告します

参考資料

  • references/validation-rules.md — コンポーネントごとの検証チェックリスト
  • references/doc-pages.md — コンポーネントと URL の対応表

コメント

Markdown 対応