Test — Chạy và tạo tests

Chạy test suite, đo coverage, UI testing qua browser, và verify implementations.

Cập nhật bộ claudekit mới: /test-gen đã bỏ, thay bằng /qa-full:tdd:verify (TDD tests + verify), /verify (confirm fix), /run (run command), /test-flakiness (detect flaky tests). Xem cấu trúc skill mới để biết đầy đủ.

Cú pháp

/test                           # Chạy tất cả tests + coverage
/test ui https://localhost:3000 # UI testing trên browser
/verify                         # Verify fix không gây regression
/run "command"                  # Run arbitrary command + report
/test-flakiness                 # Detect flaky tests
/qa-full:tdd:verify             # TDD: write tests, verify pass

Luồng hoạt động bên trong

/test — Chạy tests

Bước 1: Pre-flight Checks

Chạy typecheck (tsc --noEmit) + lint (eslint) để bắt lỗi cú pháp trước.

Bước 2: Execute Test Suites

Tự động detect test framework (Jest/Vitest/Mocha/pytest/go test) và chạy. Hỗ trợ: unit tests, integration tests, e2e tests.

Bước 3: Coverage Analysis

Đo coverage: lines, branches, functions, statements. So sánh với target (mặc định 80%).

Bước 4: Analyze Failures

Nếu có failing tests → phân tích root cause. Kích hoạt ck-debug nếu cần investigation sâu.

Bước 5: UI Tests (nếu có frontend)

Kích hoạt ck:chrome-devtools cho:

Screenshots, responsive checks
Accessibility audits
Console error collection

Bước 6: Report

Tổng hợp kết quả thành QA report cấu trúc.

/verify — Confirm fix without regression

Bước 1: Typecheck

Chạy tsc --noEmit để xác nhận no type errors.

Bước 2: Lint

Chạy eslint để xác nhận no lint violations.

Bước 3: Build

Chạy build command để xác nhận compiles.

Bước 4: Tests

Chạy test suite — so sánh before/after.

Bước 5: Report

Tổng hợp verification report: status + changes.

Ví dụ thực tế

/test output
/verify output
/test-flakiness output

TEST RESULTS
├── Typecheck:  PASS
├── Lint:       PASS
├── Tests:      142 total | 138 pass | 4 fail
├── Coverage:
│   ├── Lines:      84%
│   ├── Branches:   72%
│   ├── Functions:  89%
│   └── Statements: 83%
└── Duration:   12.3s

FAILURES:
1. auth.service.spec.ts:45 — expect(token).toBeDefined() → undefined
   Root cause: Mock không trả token khi email valid
2. order.service.spec.ts:78 — timeout 5000ms exceeded
   Root cause: Database connection pool exhausted

VERIFICATION REPORT
├── Typecheck:  PASS
├── Lint:       PASS
├── Build:      PASS
├── Tests:      142 pass | 0 fail (previous: 4 fail)
└── Status:     VERIFIED — no regression

FLAKY TESTS DETECTED
├── Analyzed: 145 tests over 3 runs
├── Flaky:    3 tests
│   ├── [FLAKY] order.service.spec.ts:78 — timeout (2/3 runs fail)
│   ├── [FLAKY] cache.service.spec.ts:45 — race condition
│   └── [FLAKY] api.integration.spec.ts:12 — external API mock
└── Recommendation: Stabilize before merge

So sánh: /test vs /verify vs /qa-full:tdd:verify

Tính năng	`/test`	`/verify`	`/qa-full:tdd:verify`
Chạy tests	Có	Có	Có
Coverage analysis	Có (full report)	Không (minimal)	Có
Typecheck + Lint	Có	Có	Có
Before/after comparison	Không	Có	Không
TDD workflow	Không	Không	Có (tests first)
UI testing	Có (browser)	Không	Không
Kích hoạt khi nào	Nach mỗi code change	Sau `/fix`	Trong TDD workflow

So sánh với chat trực tiếp

Tiêu chí	`/test`	Chat trực tiếp
Pre-flight	Tự động typecheck + lint trước	Phải nhắc chạy thủ công
Coverage	Đo và report tự động	Phải hỏi riêng
UI testing	Browser automation (screenshots, a11y)	Không có khả năng
Framework detection	Tự động detect Jest/Vitest/pytest	Phải nói rõ framework
Failure analysis	Phân tích root cause, gọi `ck-debug`	Chỉ đọc error message
Report format	Structured QA report	Text tự do

Khi nào dùng / không dùng

Dùng	Không dùng
Sau khi implement feature	Khi muốn QA toàn diện (dùng `/qa-full:full`)
Pre-commit kiểm tra nhanh	Khi cần test theo PRD (dùng `/qa-full:check`)
Đo coverage hiện tại	Khi cần verify GitHub issue (dùng `/qa-full:verify-issue`)
Sau `/fix`, verify không regression	Khi cần TDD workflow (dùng `/cook --tdd`)
Detect flaky tests trước merge	Khi tests bị lỗi, cần fix (dùng `/fix`)

Test Framework hỗ trợ

Vitest (Unit)
React Testing Library
Playwright (E2E)

import { describe, it, expect } from 'vitest';
import { getUserById } from './user.service';

describe('getUserById', () => {
  it('trả về user khi id hợp lệ', async () => {
    const user = await getUserById('user-1');
    expect(user).toBeDefined();
    expect(user?.id).toBe('user-1');
  });

  it('trả về null khi id không tồn tại', async () => {
    const user = await getUserById('invalid');
    expect(user).toBeNull();
  });
});

import { render, screen } from '@testing-library/react';
import { UserCard } from './UserCard';

describe('UserCard', () => {
  it('hiển thị tên user', () => {
    render(<UserCard name="John" email="john@test.com" />);
    expect(screen.getByText('John')).toBeInTheDocument();
  });
});

import { test, expect } from '@playwright/test';

test('đăng nhập thành công', async ({ page }) => {
  await page.goto('/login');
  await page.fill('[name="email"]', 'test@example.com');
  await page.fill('[name="password"]', 'password123');
  await page.click('button[type="submit"]');
  await expect(page).toHaveURL('/dashboard');
});

Kết hợp với QA

Mục đích	Lệnh Dev	Lệnh QA
Chạy tests	`/test`	`/qa-full:check`
Verify fix	`/verify`	`/qa-full:check` (bước 5)
Fix tests	`/fix` + `/verify`	`/qa-full:full` (bước 5)
TDD workflow	`/cook --tdd`	`/qa-full:tdd:verify`
Coverage report	`/test`	`/qa-full:audit`
Detect flaky tests	`/test-flakiness`	`/qa-full:regression-suite`

Coverage Thresholds

Metric	Target	Minimum
Lines	80%+	60%
Branches	75%+	55%
Functions	85%+	65%
Statements	80%+	60%

KHÔNG BAO GIỜ bỏ qua failing tests — fix root cause, không dùng mocks/cheats/tricks
Tất cả critical paths phải có test coverage
Validate happy path VÀ error scenarios
Tests phải isolation — không phụ thuộc lẫn nhau
Tests phải deterministic và reproducible
Flaky tests PHẢI fix trước merge — không accept flakiness

Chi tiết lệnh Test (Accordion)

/test — Run full test suite + coverage

Prefix: /testChạy tất cả tests + typecheck + lint + coverage analysis:

/test

Steps:

Typecheck (tsc --noEmit)
Lint (eslint)
Test execution (Jest/Vitest/pytest auto-detect)
Coverage measurement
Failure analysis (if any)

Output: Test results + coverage report + failure analysis.Khi dùng: Sau implement feature, pre-commit check, coverage monitoring.

/verify — Confirm fix without regression

Prefix: /verifyTypecheck + lint + build + test, so sánh before/after:

/verify

Output:

Typecheck: PASS/FAIL
Lint: PASS/FAIL
Build: PASS/FAIL
Tests: X pass, Y fail (compared to before)
Regression: detected or none

Khi dùng: Sau /fix hoặc manual code changes, xác nhận không gây regression.

/test-flakiness — Detect flaky tests

Prefix: /test-flakinessChạy tests múl lần (default 3 runs) để detect tests không stable:

/test-flakiness

Output:

Flaky tests list
Failure pattern (fail 2/3 runs, timeout, race condition, etc.)
Recommendation to stabilize

Khi dùng: Trước merge critical PRs, khi cần high-reliability test suite.

/run — Run arbitrary command + report

Prefix: /run "command"Chạy command bất kỳ (npm script, make target, shell) + capture output:

/run "npm run build:prod"
/run "yarn test --coverage"
/run "make lint"

Output: Command output + exit code + timing.Khi dùng: Custom commands, non-standard test runners, CI step verification.

/qa-full:tdd:verify — TDD: write tests, then verify

Prefix: /qa-full:tdd:verify hoặc /cook --tddTest-driven development: write tests first, implement code, verify pass:

/cook --tdd plans/payment-integration/plan.md

Workflow:

Generate test cases từ requirements
Tests fail (red)
Implement code to make tests pass (green)
Verify tất cả tests PASS

Output: TDD report + test results + implementation.Khi dùng: Critical code paths, payment/auth, high-risk modules.

​Test — Chạy và tạo tests

​Cú pháp

​Luồng hoạt động bên trong

​/test — Chạy tests

​/verify — Confirm fix without regression

​Ví dụ thực tế

​So sánh: /test vs /verify vs /qa-full:tdd:verify

​So sánh với chat trực tiếp

​Khi nào dùng / không dùng

​Test Framework hỗ trợ

​Kết hợp với QA

​Coverage Thresholds

​Chi tiết lệnh Test (Accordion)

Test — Chạy và tạo tests

Cú pháp

Luồng hoạt động bên trong

/test — Chạy tests

/verify — Confirm fix without regression

Ví dụ thực tế

So sánh: /test vs /verify vs /qa-full:tdd:verify

So sánh với chat trực tiếp

Khi nào dùng / không dùng

Test Framework hỗ trợ

Kết hợp với QA

Coverage Thresholds

Chi tiết lệnh Test (Accordion)