動作確認（verify）

bengo-toolkit プラグインの各機能が正常に動作するか確認する。

モード

$ARGUMENTS の値に応じて3つのモードで動作する:

モード1: 接続テスト（引数なし）

MCP サーバの疎通と fixtures の存在を確認する。

手順: 0. プラグイン更新チェックはスキップする。Claude Code の /plugin install bengo-toolkit@llamadrive が marketplace.json の最新 version を見て更新する。 0.5. MCP サプライチェーン整合性（v3.3.0〜 必須）: python3 scripts/verify_mcp_integrity.py を実行し、.mcp.json の各依存パッケージの npm integrity が scripts/mcp_pinned.json と一致することを確認する。不一致の場合は他の検証に進まず、即座にサプライチェーン改ざんの可能性を報告する（機密文書処理を継続してはならない）。

1. mcp__xlsx-editor__get_workbook_info を任意の fixtures XLSX に対して呼び出し、応答を確認する。
2. mcp__docx-editor__get_document_info を任意の fixtures DOCX に対して呼び出し、応答を確認する。
3. mcp__agent-format__render_agent_file に同梱 fixture の絶対パス ${CLAUDE_PLUGIN_ROOT}/fixtures/agent-format/ping.agent を渡して、応答（Loaded ping.agent (0 sections). Rendering inline. 等）が返ることを確認する。この MCP は任意項目（family-tree / lawsuit-analysis / env の成果物は自己完結 HTML で生成するため、本 MCP は MCP Apps でのインライン描画にのみ使う）。未設定/未応答なら WARNING 扱いで先に進む。
   • 注: render_agent_inline（data 引数）は使わない。 agent-format 0.1.9〜最新 0.2.3 で、data が型無し宣言のため MCP クライアントが文字列化して渡し、サーバ側の typeof data === "object" 判定に落ちて、どんな有効な .agent を渡しても常に missing or non-array sections を返す既知の upstream 不具合がある。実描画に使う render_agent_file（path 引数）はファイルを読んで JSON.parse するため正常に動作する。実スキル（family-tree / lawsuit-analysis / env）も render_agent_file を使っている。 3.5. 自己完結 HTML 描画エンジン（family-tree / lawsuit-analysis の成果物経路、必須）: python3 skills/_lib/agent_html/build_html.py host が cli または inline を返し、skills/_lib/agent_html/dist/renderer_bundle.js と renderer_styles.css が存在することを確認する。bash tests/agent_html.sh を実行すれば、極小の .agent から生成した HTML に connect-src 'none'（CSP）と描画エンジンが inline されること・外部リソースを一切参照しないことまで一括検証できる。
4. Glob で fixtures/ 配下の各サブディレクトリにファイルが存在することを確認する。
5. Glob で templates/_schema.yaml が存在することを確認する。
6. Glob で skills/*/SKILL.md を検索し、見つかったスキルを列挙する。件数はハードコードしない — Glob の結果をそのまま使う。

出力:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  bengo-toolkit 動作確認レポート
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  [1] xlsx-editor MCP ............. OK
  [2] docx-editor MCP ............. OK
  [3] agent-format MCP ............ OK（任意・インライン描画用）
  [3b] 自己完結HTML描画エンジン ... OK
  [4] fixtures .................... OK ({N} dirs)
  [5] templates ................... OK
  [6] skills ...................... OK ({M} skills)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  結果: 全項目 OK
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

{N} と {M} は Glob の結果から動的に決まる。ハードコードしない。

MCP サーバが応答しない場合は、そのサーバが設定されていない旨と設定方法を案内する。

モード2: 個別テスト（スキル名指定）

$ARGUMENTS に template-fill, family-tree, typo-check, lawsuit-analysis, inheritance-calc, law-search のいずれかが指定された場合、該当スキルの機能テストを実行する。

共通手順:

1. fixtures/{skill-name}/ 配下のテストファイルを確認する。
2. ファイルが不足している場合は、不足ファイルを報告して終了する。
3. テストファイルを使用して該当スキルのワークフローを実行する。
4. 出力結果を fixtures/{skill-name}/expected-*.json と比較する。
5. 結果を報告する。

template-fill テスト:

• fixtures: source-complaint.pdf, template-complaint.xlsx, template-complaint.yaml, expected-output.json
• 実行: template-complaint.yaml を templates/ にコピー → /template-fill を実行 → 出力XLSXのセル値を expected-output.json と比較
• 成功基準: フィールド正答率 ≥ 90%

family-tree テスト:

• fixtures: koseki-simple.pdf, expected-simple.json
• 実行: /family-tree を実行 → 抽出された persons/relationships を expected-simple.json と比較
• 成功基準: 人物抽出 ≥ 95%、関係抽出 ≥ 90%

typo-check テスト:

• fixtures: brief-with-errors.docx, brief-clean.docx, expected-corrections.json
• 実行: /typo-check を brief-with-errors.docx に実行 → 検出結果を expected-corrections.json と比較
• 成功基準: 適合率 ≥ 85%、再現率 ≥ 75%

lawsuit-analysis テスト:

• fixtures: complaint.pdf, answer.pdf, expected-timeline.json, expected-characters.json
• 実行: /lawsuit-analysis を実行 → 抽出結果を expected JSONs と比較
• 成功基準: タイムライン再現率 ≥ 80%、人物再現率 ≥ 90%

モード3: 全テスト（all 指定）

fixtures/ 配下にテストデータが揃っているスキル全ての機能テストを順次実行する。実行件数はハードコードしない — fixtures が存在するスキルだけを動的に列挙する。

出力（例）:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  bengo-toolkit 動作確認レポート（全テスト）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  [1] MCP サーバ接続 ............. OK
  [2] /template-fill ............. OK (15/15 fields)
  [3] /family-tree ............... OK (4/4 persons, 3/3 rels)
  [4] /typo-check ................ OK (P:92% R:80%)
  [5] /lawsuit-analysis .......... OK (6/6 events, 3/3 chars)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  結果: {合格}/{実行} OK
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

WARNING がある場合はその詳細を表示する。

Fixtures がない場合

fixtures ディレクトリにテストファイルがない場合は:

1. 接続テスト（モード1）のみ実行する。
2. 「テスト用 fixtures が未設定です。fixtures/ ディレクトリにテストファイルを配置してください。」と案内する。
3. 各スキルに必要な fixtures ファイルの一覧を表示する。

比較ロジック

文字列比較

• 完全一致ではなく意味的一致で判定する。
• 日付フォーマットの差異（「令和5年」vs「2023年」）は一致とみなす。
• 全角/半角の差異は一致とみなす。

数値比較

• カンマの有無を無視する。
• 全角/半角を正規化して比較する。

テーブルデータ比較

• 行の順序を無視し、内容で照合する。
• 一致率 = 正しく抽出された行数 / expected の行数。