{"componentChunkName":"component---src-templates-post-tsx","path":"/claude-code-test-automation","result":{"data":{"site":{"siteMetadata":{"title":"Linknet Engineers Blog"}},"markdownRemark":{"id":"ed881c14-452f-53f1-adb2-ca4205496f6b","excerpt":"こんにちは。株式会社リンクネット ソリューション事業部の森正です。 弊社では Claude Code を使った開発のなかで、テストコードの作成も Claude Code に任せることで効率化を図っています。 今回は Laravel 1…","html":"

こんにちは。株式会社リンクネット ソリューション事業部の森正です。

\n

弊社では Claude Code を使った開発のなかで、テストコードの作成も Claude Code に任せることで効率化を図っています。

\n

今回は Laravel 12 で作成したタスク管理アプリを題材に、Unit・Feature・E2E（Playwright）の3層すべてを Claude Code に生成させる流れを紹介します。

\n
\n

1. サンプルプロジェクトの概要

\n

題材は、Laravel 12 + React + Inertia.js で構成したタスク管理アプリです。

\n

\n \n \n \n \n \n \n

\n

機能は、ユーザー認証（Laravel Breeze）、タスクの作成・参照・更新・削除、ステータス管理（未着手・進行中・完了）とそのフィルタリングを備えています。

\n

最終的に生成したテストは、以下のような構成になりました。

\n
tests/\n├── Unit/                    # Unit テスト\n│   └── Models/TaskTest.php\n├── Feature/                 # Feature テスト\n│   └── Tasks/\n│       ├── TaskCreateTest.php\n│       ├── TaskUpdateTest.php\n│       ├── TaskDeleteTest.php\n│       └── TaskIndexTest.php\n└── e2e/                     # E2Eテスト (Playwright)\n    ├── helpers/auth.ts\n    └── tasks/task-crud.spec.ts
\n
\n

2. まず CLAUDE.md にテスト方針を書く

\n

いきなりテストを書かせる前に、やっておくと良いのが CLAUDE.md への方針の明記です。

\n

ここにテストの規約を書いておくと、毎回プロンプトで細かく指示しなくても、一貫したスタイルのテストが出てくるようになります。

\n
# テスト方針\n\n## PHPUnit\n- テストクラスには `use RefreshDatabase` を使用する\n- テストメソッドには `#[Test]` アトリビュートを付与する\n- メソッド名は英語のスネークケースで、テスト対象の振る舞いを説明する\n- Factory を使用してテストデータを生成する\n- 認証が必要なテストは `actingAs($user)` を使用する\n\n## Playwright (E2E)\n- テストファイルは `tests/e2e/` 配下に配置する\n- 要素の特定には `data-testid` 属性を使用する\n- ログインが必要なテストは `helpers/auth.ts` の `login()` 関数を使用する\n\n## テスト実行コマンド\n- PHPUnit: `./vendor/bin/sail test`\n- Playwright: `./vendor/bin/sail npx playwright test`
\n
\n

3. Unit テスト ── ロジックの正しさを確かめる

\n

まずはモデルの Unit テストです。

\n

次のように指示します。

\n
Task モデルのユニットテストを作成してください。\nリレーション、Enumキャスト、スコープのテストを含めてください。
\n

生成されたのが次のテストです。

\n

モデルの定義を読み取り、検証すべき内容を自動で抽出しています。

\n
<?php\n\nnamespace Tests\\Unit\\Models;\n\nuse App\\Enums\\TaskStatus;\nuse App\\Models\\Task;\nuse App\\Models\\User;\nuse Illuminate\\Foundation\\Testing\\RefreshDatabase;\nuse PHPUnit\\Framework\\Attributes\\Test;\nuse Tests\\TestCase;\n\nclass TaskTest extends TestCase\n{\n    use RefreshDatabase;\n\n    #[Test]\n    public function it_belongs_to_a_user(): void\n    {\n        $task = Task::factory()->create();\n\n        $this->assertInstanceOf(User::class, $task->user);\n    }\n\n    #[Test]\n    public function it_casts_status_to_enum(): void\n    {\n        $task = Task::factory()->todo()->create();\n\n        $this->assertInstanceOf(TaskStatus::class, $task->status);\n        $this->assertSame(TaskStatus::Todo, $task->status);\n    }\n\n    #[Test]\n    public function scope_status_filters_correctly(): void\n    {\n        $user = User::factory()->create();\n        Task::factory()->count(3)->todo()->for($user)->create();\n        Task::factory()->count(2)->done()->for($user)->create();\n\n        $this->assertCount(3, Task::status(TaskStatus::Todo)->get());\n        $this->assertCount(2, Task::status(TaskStatus::Done)->get());\n    }\n}
\n

リレーション・Enumキャスト・カスタムスコープと、検証すべき観点を適切に押さえています。

\n
$ ./vendor/bin/sail test tests/Unit/Models/TaskTest.php\n\n   PASS  Tests\\Unit\\Models\\TaskTest\n  ✓ it belongs to a user\n  ✓ it casts status to enum\n  ✓ scope status filters correctly\n\n  Tests:    3 passed (7 assertions)
\n
\n

4. Feature テスト ── 観点を箇条書きで渡す

\n

Feature テストでは、API レベルの動作を確認します。

\n

ここでのポイントは、確認したい観点を箇条書きで渡すことです。

\n

これにより、Claude Code が漏れなくテストケースに反映します。

\n
TaskController の作成・参照・更新・削除操作に対するフィーチャーテストを作成してください。\n以下の観点を含めてください：\n- 認証チェック\n- 正常系（作成・更新・削除・一覧表示）\n- 認可チェック（他ユーザーのタスクは操作できない）\n- バリデーション\n- ステータスフィルタリング
\n

生成された作成テストの抜粋です。

\n
<?php\n\nnamespace Tests\\Feature\\Tasks;\n\nuse App\\Models\\User;\nuse Illuminate\\Foundation\\Testing\\RefreshDatabase;\nuse PHPUnit\\Framework\\Attributes\\Test;\nuse Tests\\TestCase;\n\nclass TaskCreateTest extends TestCase\n{\n    use RefreshDatabase;\n\n    #[Test]\n    public function guest_cannot_access_create_form(): void\n    {\n        $this->get(route('tasks.create'))->assertRedirect(route('login'));\n    }\n\n    #[Test]\n    public function user_can_create_a_task(): void\n    {\n        $user = User::factory()->create();\n\n        $response = $this->actingAs($user)->post(route('tasks.store'), [\n            'title' => 'テストタスク',\n            'description' => 'テストの説明',\n            'status' => 'todo',\n        ]);\n\n        $response->assertRedirect(route('tasks.index'));\n        $this->assertDatabaseHas('tasks', [\n            'title' => 'テストタスク',\n            'user_id' => $user->id,\n        ]);\n    }\n\n    #[Test]\n    public function title_is_required(): void\n    {\n        $user = User::factory()->create();\n\n        $this->actingAs($user)\n            ->post(route('tasks.store'), ['title' => '', 'status' => 'todo'])\n            ->assertSessionHasErrors('title');\n    }\n}
\n

Controller のルーティング、FormRequest のバリデーションルール、Policy の認可ロジックまで読み取ったうえで、観点ごとのテストケースを作成しています。

\n
$ ./vendor/bin/sail test tests/Feature/Tasks/\n\n   PASS  Tests\\Feature\\Tasks\\TaskCreateTest\n  ✓ guest cannot access create form\n  ✓ user can create a task\n  ✓ title is required\n  ✓ title max length is 255\n  ✓ status must be valid enum value\n  ...\n\n  Tests:    17 passed (58 assertions)
\n
\n

5. E2Eテスト（Playwright）

\n

E2E には Playwright を使用します。

\n

まずは環境のセットアップから依頼します。

\n
Playwright のセットアップをしてください。\nLaravel Sail 環境で動作するようにしてください。
\n

設定では、テスト前にDBをリセットして再シードする globalSetup も生成されます。

\n
// playwright.config.ts\nexport default defineConfig({\n    testDir: './tests/e2e',\n    workers: 1,\n    use: {\n        baseURL: 'http://localhost',\n        screenshot: 'only-on-failure',\n    },\n    globalSetup: './tests/e2e/global-setup.ts',\n});
\n

ログインのような共通処理は、ヘルパーとして切り出して生成されます。

\n
// tests/e2e/helpers/auth.ts\nimport { Page } from '@playwright/test';\n\nexport async function login(page: Page, email = 'test@example.com', password = 'password') {\n    await page.goto('/login');\n    await page.locator('#email').fill(email);\n    await page.locator('#password').fill(password);\n    await page.getByRole('button', { name: 'ログイン' }).click();\n    await page.waitForURL('**/dashboard', { timeout: 10000 });\n}
\n

そのうえで一連の操作の E2E を依頼します。

\n
タスクの作成・参照・更新・削除操作に対する E2E テストを Playwright で作成してください。
\n
import { test, expect } from '@playwright/test';\nimport { login } from '../helpers/auth';\n\ntest.describe('Task management', () => {\n    test.beforeEach(async ({ page }) => {\n        await login(page);\n    });\n\n    test('user can create a new task', async ({ page }) => {\n        await page.goto('/tasks');\n        await page.click('[data-testid=\"create-task-button\"]');\n\n        await page.fill('[data-testid=\"title-input\"]', 'Write blog post');\n        await page.fill('[data-testid=\"description-input\"]', 'About test automation');\n        await page.click('[data-testid=\"submit-button\"]');\n\n        await expect(page.locator('[data-testid=\"task-card\"]').first())\n            .toContainText('Write blog post');\n    });\n\n    test('user can delete a task', async ({ page }) => {\n        await page.goto('/tasks');\n        const initialCount = await page.locator('[data-testid=\"task-card\"]').count();\n\n        page.on('dialog', (dialog) => dialog.accept());\n        await page.locator('[data-testid=\"task-card\"]').first()\n            .locator('[data-testid=\"delete-button\"]').click();\n\n        await expect(page.locator('[data-testid=\"task-card\"]'))\n            .toHaveCount(initialCount - 1);\n    });\n});
\n

\n \n

  • screenshot: 'on' … 毎回自動撮影する
    • \n
  • await page.screenshot({ path: 'evidence/create-task.png' }) … 任意のタイミングで撮影する
    • \n\n

    撮影した画像は 'test-results/' 配下に出力され、HTMLレポート（'playwright show-report'）からまとめて確認できます。
    \n手動テストで行っていた証跡スクリーンショットの取得をコードに組み込めるため、不具合報告やレビュー時の説明材料としても活用できます。

    \n

    下は、テスト実行中に Playwright が撮影した画面です。
    \nテストがフォームに自動入力した内容（'【E2Eテスト】…' というテストデータ）がそのまま写っており、どの操作時点のスクリーンショットなのかが一目で分かります。

    \n

    \n