AI駆動開発のためのOpenClawを用いた契約テスト

OpenClawのようなAIコーディングエージェントを扱う際、契約テストは統合テストやエンドツーエンドテストの代替手段を提供します。システム全体をテストする代わりに、コンポーネント間のインターフェースと不変条件をテストし、エージェントがそれらの契約を満たすコードを生成します。

核となる考え方

エージェントを使用してコードを書く際、ワークフローは従来のテストから契約駆動開発へと移行します：

• 実装の前に契約/仕様を最初に書く
• 統合テストが動作を確認する代わりに、契約がインターフェースと不変条件を検証する
• 包括的なE2Eテストの代わりに最小限のE2Eスモークテスト
• 人間がほとんどのコードを書く代わりに、エージェントが実装を書く

AIの仕事は「コードが契約を満たすようにする」ことになります。

契約の例

契約は入力スキーマ、出力スキーマ、不変条件、エラー条件を定義します。Zodを使用したTypeScriptの例：

export const CreateUserRequest = z.object({
  email: z.string().email(),
  password: z.string().min(8)
})

export const CreateUserResponse = z.object({
  id: z.string().uuid(),
  email: z.string().email(),
  createdAt: z.string()
})

契約テストの例：

test("createUser contract", async () => {
  const req = CreateUserRequest.parse({
    email: "[email protected]",
    password: "password123"
  })
  
  const res = await createUser(req)
  expect(CreateUserResponse.parse(res)).toBeDefined()
})

AIは、これがパスする限り、サービス全体を再生成できます。

AIエージェントのための契約テストパターン

一般的なプロジェクト構造：

contracts/
  user.contract.ts
  order.contract.ts

tests/
  contract/
    user.test.ts
src/
  services/
    userService.ts

ワークフロー：契約を定義し、エージェントが実装を生成し、契約テストを実行し、エージェントが失敗を修正します。これにより、AIエージェントが自己修正するために依存する緊密なフィードバックループが作成されます。

エージェントプロンプトの例

OpenClawエージェントのワークフロー内：

tests/contract内のすべてのテストがパスするようにサービスを実装してください。
契約定義は変更しないでください。実装ファイルのみを変更してください。

エージェントはnpm test PASS contract testsになるまで反復します。

コンシューマ駆動契約

コンシューマ駆動契約はAI開発に特に適しています。例：フロントエンドがPOST /usersを{ id: uuid, email: string }を期待して定義し、バックエンドエージェントはその契約を満たさなければなりません。一般的に使用されるツールにはPact、スキーマ検証、OpenAPI契約があります。

AIコーディングのための最小限のテストスタック

ほとんどの統合テストを置き換えるために：

contracts/
  openapi.yaml

tests/
  contract/
  invariants/
src/
  implementation

テストの分布：契約テスト（80%）、不変条件/プロパティテスト（15%）、最小限のE2Eスモークテスト（5%）。スモークテストの例：ユーザー登録が機能する、ユーザーログインが機能する。

追加のテクニック：プロパティテスト

エージェントはプロパティテストで劇的に改善されます。例：

fc.assert(
  fc.property(fc.string(), async (email) => {
    const user = await createUser({email})
    expect(user.email).toEqual(email)
  })
)

これにより、エージェントが学習するための探索空間が与えられます。

これがAIにより適している理由

エージェントは、マルチサービス調整、不安定なE2Eテスト、複雑な環境設定に苦労します。決定論的なフィードバック、小さな独立したタスク、スキーマと制約が与えられると優れた能力を発揮します。契約テストはAIフレンドリーなアーキテクチャにおける「基本的事実」となります：契約（真実）→テスト（検証）→エージェントが生成→実装。