Openclaw向けDrift Testing

OpenAPI仕様を使用して仕様のドリフトを検出し、双方向契約テスト(Bi-Directional Contract Testing)をサポートする強力なAPI検証ツールです。

kevinrvaz

v1.0.0

Apr 15, 2026

インストール

概要情報

Skill.md

インストール＆ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。


                  npx clawhub@latest install drift-testing

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル

~/.openclaw/skills/

ワークスペース

<project>/skills/

優先順位：ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。


                  Clawhubを使って drift-testing をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください（npm i -g clawhub）。

ダウンロードをご希望ですか？

ZIPアーカイブで生のスキルファイルを取得します。

Drift Testing とは？

drift-testing skillは、APIの実装をOpenAPI仕様と同期させるために設計されたOpenclaw Skills向けの包括的なツールセットです。Drift CLIを活用して双方向契約テスト(BDCT)を実行し、プロバイダーの実装が文書化された契約を正確に反映していることを保証します。このskillは、CI/CDパイプライン内でAPIの一貫性を維持し、破壊的変更を防ぎ、プロバイダー検証を自動化する必要がある開発者にとって極めて重要です。

単なる検証を超えて、このskillはカバレッジ分析、自動フィードバックループ、複雑な状態管理のためのLuaベースのスクリプトなど、APIテストのためのライフサイクル全体を提供します。本番環境に対してテストする場合でも、ローカルのPrism mock serverに対してテストする場合でも、このOpenclaw Skillsユーティリティは、エンドポイントが完全に網羅され、定義された基準に準拠していることを保証します。

Drift Testing のユースケース

APIの実装がOpenAPI仕様と一致していることを検証し、仕様のドリフトを防止します。
PactFlowエコシステム内で双方向契約テスト(BDCT)を実装します。
既存のOpenAPIドキュメントからテストスケルトンやスキャフォールドを自動生成します。
特定のレスポンスコードに対するテストケースの欠落を特定し、完全なエンドポイントカバレッジを確保します。
全てのテストが通過するまで実行される自動リトライループを使用してAPIの障害をデバッグします。

Drift Testing の仕組み

このskillは、提供されたOpenAPI仕様を分析し、利用可能な全ての操作、メソッド、レスポンスコードを特定します。
ユーザーはdrift initコマンドを使用して環境を初期化し、設定、データセット、フック(hook)ファイルをスキャフォールディングします。
テストケースはYAMLで記述され、特定の操作を予期されるステータスコードとパラメーターにマッピングします。
Drift CLIは、ターゲットサーバーURLまたはローカルのmock serverに対してテストを実行します。
カバレッジスクリプトは、実行されたテストを仕様と比較し、エンドポイントまたはレスポンスコード検証におけるギャップを報告します。
APIが完全に検証されるまで、失敗したテストと欠落しているカバレッジを反復するために、フィードバックループ(run_loop.sh)を使用できます。

Drift Testing のセットアップ

npxを介してDrift CLIを使用するか、プロジェクトにローカルインストールできます。

# インストールなしでnpxを使用
npx @pactflow/drift --help

# 開発チーム向けのローカルインストール
npm install --save-dev @pactflow/drift

# 新しいDriftプロジェクトの初期化
drift init

Drift Testing のデータスキーマとタクソノミー

このskillは、Openclaw Skillsユーザーのために、設定とテストデータを特定のディレクトリ構造に編成します。

ファイル	用途
`drift.yaml`	ソース、プラグイン、グローバル認証設定を定義するメイン設定ファイル。
`drift.lua`	ライフサイクルフック(例: `operation:started`)とヘルパー関数を含むLuaスクリプト。
`*.dataset.yaml`	テスト式で使用される外部化されたテストデータと変数。
`*.tests.yaml`	操作対象と期待されるレスポンスを含むメインテストスイート。

Drift Testing の高度な機能

Luaライフサイクルフック: http:request、operation:started、operation:finishedの複雑な動作をスクリプト化して、状態を管理したりデータをシード(seed)したりします。
双方向契約テスト: 結果をPactFlowにパブリッシュして、分散システム全体で契約の完全性を維持します。
自動カバレッジ分析: 統合されたPythonスクリプトを使用して、テストスイートをOpenAPI仕様と突き合わせて100%検証します。
Mock Server統合: Prism mock serverを組み込みでサポートしており、ライブバックエンドなしでAPIロジックをテストできます。
並列実行: ネイティブのCLIフラグを使用してテストスイートを並列実行し、CI/CDの実行時間を最適化します。