testing

使用TDD与Pest(PHP)、Vitest(React)和Playwright(E2E)编写和管理测试。在编写功能测试、单元测试、组件测试或提高测试覆盖率时使用。专属于测试专家代理。

📖 中文导读:使用TDD与Pest(PHP)、Vitest(React)和Playwright(E2E)编写和管理测试。在编写功能测试、单元测试、组件测试或提高测试覆盖率时使用。专属于测试专家代理。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: testing description: | Write and manage tests using TDD with Pest (PHP), Vitest (React), pytest (Python), and Playwright (E2E). Use when writing feature tests, unit tests, component tests, visual regression tests, or improving test coverage. EXCLUSIVE to testing-expert agent. allowed-tools: Read, Edit, Bash, Grep, Glob, Write, mcp_context7, mcp_playwright, mcp_zai-mcp-server

Testing

Exclusive to: testing-expert agent

📚 Context7 (Memory) — Up-to-Date Docs

Lookup testing patterns and assertions:

mcp_context7_resolve-library-id(libraryName="pytest", query="fixtures async")
mcp_context7_query-docs(libraryId="/pytest-dev/pytest", query="parametrize examples")

🖼️ Visual Testing (Web Apps)

For UI/UX testing, use Playwright MCP to capture and Vision AI to analyze:

Capture Screenshots

mcp_playwright_browser_navigate(url="http://localhost:8000/[page]")
mcp_playwright_browser_take_screenshot(filename="test-screenshot.png")

Analyze with Vision AI

mcp_zai-mcp-server_analyze_image(
  image_path="test-screenshot.png",
  prompt="Analyze this UI: check layout, colors, spacing, alignment, accessibility issues"
)

Visual Regression Flow

  1. Capture baseline screenshot
  2. Make changes
  3. Capture new screenshot
  4. Use Vision AI to compare and validate

Validation Loop (MANDATORY)

After writing or modifying tests, always verify:

composer test           # PHP tests pass
npm run test           # JS tests pass (if applicable)

TDD Feedback Loop:

  1. Write test → Verify it FAILS (Red)
  2. Implement minimal code → Verify it PASSES (Green)
  3. Refactor → Verify it still PASSES
  4. Repeat for edge cases

Instructions (TDD Workflow)

Step Action Verification
1 Write failing test composer test --filter=NewTest → FAILS
2 Implement minimal code composer test --filter=NewTest → PASSES
3 Refactor composer test → ALL PASS
4 Add edge cases Repeat steps 1-3

Pest Patterns (Laravel)

Feature Test

test('user can create post', function () {
    $user = User::factory()->create();
    
    $this->actingAs($user)
        ->post('/posts', ['title' => 'Test'])
        ->assertRedirect('/posts');
        
    $this->assertDatabaseHas('posts', ['title' => 'Test']);
});

Unit Test

test('generates slug from title', function () {
    expect((new SlugGenerator)->generate('Hello World'))
        ->toBe('hello-world');
});

Vitest Patterns (React)

describe('PostForm', () => {
    it('submits with valid data', async () => {
        const onSubmit = vi.fn();
        render(<PostForm onSubmit={onSubmit} />);
        
        await userEvent.type(screen.getByLabelText(/title/i), 'Test');
        await userEvent.click(screen.getByRole('button', { name: /submit/i }));
        
        expect(onSubmit).toHaveBeenCalled();
    });
});

Test Commands

# Laravel
composer test
php artisan test --filter=PostTest
php artisan test --coverage

# React
npm run test
npm run test:watch
npm run test:coverage

Examples

  • "Write tests for PostController"
  • "Add unit tests for this service"
  • "Fix failing test"