skill-integration-tester

スキル統合テスター

概要

CLAUDE.md で定義された複数スキルのワークフロー（Daily Market Monitoring、 Weekly Strategy Review、Earnings Momentum Trading など）を、各ステップを順番に実行して検証します。 ステップ N の出力とステップ N+1 の入力の間で、JSON スキーマの互換性に関するスキル間データ契約を確認し、ファイル命名規則を検証して、受け渡しの問題を報告します。合成フィクスチャを使ったドライランモードに対応しています。

使用する場面

• CLAUDE.md の複数スキルワークフローを追加または変更した後
• スキルの出力形式（JSON スキーマ、ファイル命名）を変更した後
• パイプラインの互換性を確認するため、新しいスキルをリリースする前
• 連続するワークフローステップ間の受け渡しの問題をデバッグする場合
• スキルスクリプトに関するプルリクエストの CI 事前チェックとして

前提条件

• Python 3.9+
• API キーは不要です
• サードパーティ製 Python パッケージは不要です（標準ライブラリのみを使用）

ワークフロー

ステップ 1：統合検証を実行する

プロジェクトの CLAUDE.md に対して検証スクリプトを実行します。

python3 skills/skill-integration-tester/scripts/validate_workflows.py \
  --output-dir reports/

このスクリプトは、Multi-Skill Workflows セクションからすべての **Workflow Name:** ブロックを解析し、各ステップの表示名をスキルディレクトリに対応付けて、存在、契約、命名を検証します。

ステップ 2：特定のワークフローを検証する

名前の一部を指定して、単一のワークフローを対象にします。

python3 skills/skill-integration-tester/scripts/validate_workflows.py \
  --workflow "Earnings Momentum" \
  --output-dir reports/

ステップ 3：合成フィクスチャでドライランする

各スキルで想定される出力の合成フィクスチャ JSON ファイルを作成し、実データを使わずに契約の互換性を検証します。

python3 skills/skill-integration-tester/scripts/validate_workflows.py \
  --dry-run \
  --output-dir reports/

フィクスチャファイルは reports/fixtures/ に書き込まれ、_fixture フラグが設定されます。

ステップ 4：結果を確認する

生成された Markdown レポートを開いて人が読みやすい形式の概要を確認するか、JSON レポートを解析してプログラムから利用します。各ワークフローには、次の内容が表示されます。

• ステップごとのスキル存在チェック
• 受け渡し契約の検証（PASS / FAIL / N/A）
• ファイル命名規則への違反
• ワークフロー全体のステータス（valid / broken / warning）

ステップ 5：受け渡しの問題を修正する

FAIL となった受け渡しごとに、次を確認します。

1. 提供側スキルの出力に、必須フィールドがすべて含まれていること
2. 利用側スキルの入力パラメーターが、提供側の出力形式を受け入れること
3. 提供側の出力と利用側の入力で、ファイル命名パターンに一貫性があること

出力形式

JSON レポート

{
  "schema_version": "1.0",
  "generated_at": "2026-03-01T12:00:00+00:00",
  "dry_run": false,
  "summary": {
    "total_workflows": 8,
    "valid": 6,
    "broken": 1,
    "warnings": 1
  },
  "workflows": [
    {
      "workflow": "Daily Market Monitoring",
      "step_count": 4,
      "status": "valid",
      "steps": [...],
      "handoffs": [...],
      "naming_violations": []
    }
  ]
}

Markdown レポート

ワークフローごとのセクションで構成され、ステップの検証、受け渡しステータス、命名規則への違反を表示するレポートです。

レポートは reports/ に、ファイル名 integration_test_YYYY-MM-DD_HHMMSS.{json,md} で保存されます。

リソース

• scripts/validate_workflows.py -- メインの検証スクリプト
• references/workflow_contracts.md -- 契約の定義と受け渡しパターン

主な原則

1. API キーは不要です -- すべての検証はローカルかつオフラインで実行されます
2. 非破壊的です -- SKILL.md と CLAUDE.md のみを読み取り、スキルは変更しません
3. 決定論的です -- 同じ入力からは常に同じ検証結果が得られます