Generate Combinatorial Test Data

$generate-combinatorial-test-data — Sinh Test Data Cho Ma Trận Kết Hợp

> Dùng khi: Đã có ma trận kết hợp (từ $generate-cross-module-test-plan) và cần tạo test data thực tế bằng cách chạy qua nhiều modules trên browser, hoặc sinh bộ data có cấu trúc sẵn sàng cho automation.

> BẮT BUỘC (MANDATORY): Trước khi bắt đầu, PHẢI nạp và đọc kỹ: > - Skill: .agents/skills/test-data-generator/SKILL.md — Quy tắc sinh data (xem phần Multi-Step Pipeline) > - Skill: .agents/skills/ui-debug-agent/SKILL.md — Inspect DOM khi chạy browser > - Workflow: .agents/skills/generate-cross-module-test-plan/SKILL.md — Hiểu cấu trúc ma trận đầu vào

---

Mối quan hệ với các workflows khác

$generate-cross-module-test-plan     →  Ma trận kết hợp (input)
        ↓
$generate-combinatorial-test-data    →  Bộ test data (workflow này)
        ↓
$generate-manual-testcases-rbt       →  Test cases chi tiết
        ↓
$generate-automation-from-testcases  →  Automation scripts

---

2 Modes

| Mode | Khi nào dùng | Output | |------|-------------|--------| | GENERATE (mặc định) | Sinh bộ data có cấu trúc từ ma trận — KHÔNG chạy browser | File JSON/CSV/Markdown với data cho mỗi bộ kết hợp | | PIPELINE | Cần tạo data THẬT trên hệ thống bằng cách chạy qua từng module trên browser | Data thật đã tạo + IDs + screenshots evidence |

> Agent tự chọn mode: > - User nói "sinh data", "generate data" → GENERATE > - User nói "tạo data trên hệ thống", "chạy tạo data", "setup data thật" → PIPELINE > - Nếu không rõ → hỏi user

---

Input cần từ User

| Input | Bắt buộc | Mô tả | |-------|----------|-------| | Ma trận kết hợp | ✅ | File .md / bảng Markdown từ $generate-cross-module-test-plan | | URL ứng dụng | ✅ (PIPELINE) | Để agent chạy browser tạo data | | Credentials | ⚠️ PIPELINE | Nếu app cần đăng nhập | | Output format | ❌ | json (mặc định), csv, markdown, code (TS/Java/Python) | | Ngôn ngữ data | ❌ | Tiếng Việt / Tiếng Anh (mặc định: theo context) |

---

Các bước thực hiện

Bước 1: Đọc & Parse Ma Trận Kết Hợp

1. Đọc file ma trận từ user cung cấp:

• File local → view_file
• Inline trong chat → parse trực tiếp
• URL → read_url_content

1. Parse và validate:

• Xác định danh sách dimensions (D1, D2, D3...)
• Xác định values của mỗi dimension
• Đọc expected template/formula cho mỗi bộ
• Đếm tổng số bộ kết hợp cần sinh data

1. Trình bày tóm tắt:

```markdown 📊 Ma trận đã đọc:

• Dimensions: 5 (Đối tác, Thanh toán, Thuế, Công nợ, Nguồn TS)
• Tổng bộ kết hợp: 20 (Pairwise)
• Mode: GENERATE / PIPELINE

Bắt đầu sinh data? (Y/N) ```

---

Bước 2: Phân Tích Fields & Data Requirements Mỗi Module

1. Với mỗi module trong chuỗi, xác định fields cần data:

``markdown | Module | Field | Type | Required | Constraints | Data Source | |--------|-------|------|----------|-------------|-------------| | Đối tác | partner_name | string | ✅ | max: 200 | Random + prefix | | Đối tác | partner_type | select | ✅ | enum: [TC, CN, HKD] | Từ dimension D1 | | Đối tác | tax_id | string | ✅ | 10-13 digits | Random unique | | Thanh toán | currency | select | ✅ | enum: [VND, USD] | Từ dimension D2 | | Thanh toán | amount | number | ✅ | min: 1 | Business-relevant values | | Thuế | tax_type | select | ✅ | enum: [PIT, VAT, NT, MT] | Từ dimension D3 | | ...| ... | ... | ... | ... | ... | ``

1. Phân loại fields:

| Loại | Mô tả | Cách sinh data | |------|-------|----------------| | Dimension fields | Giá trị thuộc dimension trong ma trận | Lấy từ bộ kết hợp (không random) | | Supporting fields | Fields bắt buộc nhưng không phải dimension | Sinh random + unique + traceable | | Computed fields | Tự tính từ formula | Tính theo business rules | | Reference fields | ID/code từ module trước | Copy từ output module trước |

---

Bước 3: Sinh Test Data — Mode GENERATE

> Thực hiện khi mode = GENERATE (mặc định)

1. Với mỗi bộ kết hợp trong ma trận, sinh 1 bộ data đầy đủ:

``json { "combination_id": "COMBO_01", "dimensions": { "D1_partner_type": "Tổ chức", "D2_payment_type": "VND", "D3_tax_type": "VAT 10%", "D4_debt_type": "Thông thường", "D5_asset_source": "Quỹ A" }, "module_data": { "module_1_partner": { "partner_name": "auto_combo01_tc_1712049200", "partner_type": "Tổ chức", "tax_id": "0123456789", "address": "Số 1 Nguyễn Huệ, Q1, HCM" }, "module_2_payment": { "currency": "VND", "amount": 100000000, "payment_date": "2026-04-15", "description": "Thanh toán combo01" }, "module_3_tax": { "tax_type": "VAT", "tax_rate": 10, "tax_amount": 10000000 }, "module_4_debt": { "debt_type": "Thông thường", "advance_amount": 0 } }, "expected_output": { "template": "BB_TC_VND_VAT", "formula": "Amount × 1.10", "computed_total": 110000000, "expected_fields": ["partner_name", "tax_id", "amount", "tax_amount", "total"] } } ``

1. Sinh đủ data cho TẤT CẢ bộ kết hợp → đóng gói vào 1 file output

1. Đảm bảo data rules:

• Unique per combo (không trùng giữa các bộ)
• Traceable: prefix auto_combo{XX}_{dimension_short}
• No real PII
• Computed values phải đúng theo formula

---

Bước 3P: Sinh Test Data — Mode PIPELINE (chạy thật trên browser)

> Thực hiện khi mode = PIPELINE

1. Mở browser bằng MCP:

`` browser_navigate → URL ứng dụng browser_resize → 1920 × 1080 ``

1. Loop qua từng bộ kết hợp:

``` FOR each combo in matrix: FOR each module in chain:

1. Navigate → module URL
2. browser_snapshot → xác nhận state
3. Điền data theo bộ combo:

• Dimension fields → chọn giá trị theo combo
• Supporting fields → sinh random + traceable

1. Submit / Save
2. browserwaitfor → confirm success
3. browser_snapshot → capture kết quả
4. Extract output (ID, code...) → lưu cho module tiếp theo

END FOR

// Ở module cuối — verify output

1. Capture biên bản / output cuối
2. browsertakescreenshot → evidence
3. Ghi nhận: comboid, createdids, templatefound, formulaverified

END FOR ```

1. Xử lý lỗi trong pipeline:

| Lỗi | Cách xử lý | |-----|-----------| | Submit fail (validation) | Screenshot → ghi log → skip combo → báo user | | Module load chậm | browser_wait_for với timeout tăng dần | | Session expired | Re-login → retry từ module bị fail | | Data trùng | Sinh lại data unique, retry | | Combo không hợp lệ (constraint) | Skip → đánh dấu "INVALID" trong report |

1. Giới hạn pipeline:

• Tối đa 30 bộ kết hợp / phiên chạy (tránh timeout)
• Nếu > 30 → chia batch, hỏi user "Tiếp tục batch tiếp?"
• Sau mỗi 10 bộ → báo progress cho user

---

Bước 4: Đóng Gói Output & Báo Cáo

Output cho Mode GENERATE:

Tạo artifact file(s) theo format user yêu cầu:

JSON (mặc định):

{
  "feature": "Biên bản thanh toán đối tác",
  "generated_at": "2026-04-15T17:00:00Z",
  "strategy": "pairwise",
  "total_combinations": 20,
  "dimensions": ["partner_type", "payment_type", "tax_type", "debt_type", "asset_source"],
  "data_sets": [
    { "combination_id": "COMBO_01", "dimensions": {...}, "module_data": {...}, "expected_output": {...} },
    { "combination_id": "COMBO_02", ... }
  ]
}

Markdown Table:

| Combo | Đối tác | Thanh toán | Thuế | Công nợ | Nguồn | Partner Name | Amount | Expected Template | Expected Total |
|-------|---------|-----------|------|---------|-------|-------------|--------|------------------|----------------|
| 01 | Tổ chức | VND | VAT | Thường | Quỹ A | auto_c01_tc | 100M | BB_TC_VND_VAT | 110M |
| 02 | ... | ... | ... | ... | ... | ... | ... | ... | ... |

Code (TypeScript example):

// test-data/payment-record.data.ts
export const combinatorialData = [
  {
    id: 'COMBO_01',
    partner: { name: `auto_combo01_${Date.now()}`, type: 'Tổ chức', taxId: '0123456789' },
    payment: { currency: 'VND', amount: 100_000_000 },
    tax: { type: 'VAT', rate: 10 },
    expected: { template: 'BB_TC_VND_VAT', total: 110_000_000 },
  },
  // ... more combos
];

Output cho Mode PIPELINE:

## Pipeline Execution Report

| # | Combo | Status | Module 1 ID | Module 2 ID | Module 3 ID | Output Template | Formula ✓ | Screenshot |
|---|-------|--------|------------|------------|------------|-----------------|-----------|------------|
| 1 | COMBO_01 | ✅ PASS | PTR-001 | PAY-001 | TAX-001 | BB_TC_VND_VAT | ✅ Match | combo01.png |
| 2 | COMBO_02 | ✅ PASS | PTR-002 | PAY-002 | TAX-002 | BB_TC_USD_PIT | ✅ Match | combo02.png |
| 3 | COMBO_03 | ❌ FAIL | PTR-003 | PAY-003 | — | — | — | combo03_fail.png |

### Summary
- ✅ Passed: 18/20
- ❌ Failed: 2/20 (COMBO_03: Tax module validation error, COMBO_17: Timeout)
- 📊 Data created: 18 partners, 18 payments, 18 tax configs, 18 biên bản

---

Data Rules (BẮT BUỘC)

| # | Rule | Mô tả | |---|------|-------| | 1 | Unique per combo | Mỗi bộ kết hợp dùng data riêng — không chia sẻ giữa combos | | 2 | Traceable | Prefix: auto_combo{XX}_{dimension_short}_{timestamp} | | 3 | Dimension values exact | Giá trị dimension PHẢI đúng như trong ma trận — KHÔNG random | | 4 | Supporting fields random | Fields không thuộc dimension → sinh random + unique | | 5 | Computed values verified | Giá trị tính toán phải đúng theo formula trong ma trận | | 6 | No real PII | KHÔNG dùng dữ liệu cá nhân thật | | 7 | Include expected output | Mỗi combo PHẢI có expected template + formula + computed values |

---

NGHIÊM CẤM

| ❌ Không được làm | ✅ Thay thế đúng | |-------------------|-----------------| | Random dimension values | Dimension values lấy chính xác từ ma trận | | Hardcode data giống nhau cho mọi combo | Data unique per combo với traceable prefix | | Bỏ qua expected output | Mỗi combo PHẢI có expected template + values | | Chạy pipeline > 30 combos / phiên không hỏi | Chia batch 30, hỏi user tiếp tục | | Bỏ qua combo fail, không report | Ghi log đầy đủ: combo nào fail, tại sao, screenshot | | Đọc .env để lấy credentials | Hỏi User hoặc dùng fixture sẵn có |

---

Checklist cuối

• [ ] Đã đọc và parse ma trận kết hợp đầy đủ
• [ ] Phân loại fields: dimension / supporting / computed / reference
• [ ] Data sinh ra unique per combo + traceable
• [ ] Dimension values đúng 100% so với ma trận
• [ ] Computed values đúng theo formula
• [ ] (PIPELINE) Screenshots evidence cho mỗi combo
• [ ] (PIPELINE) Report pass/fail cho mỗi combo
• [ ] Không chứa real PII
• [ ] Output file đúng format user yêu cầu

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: anhtester
• Source: anhtester/codex-testing-kit
• License: MIT
• Homepage: https://anhtester.com

Install and usage instructions live in the source repository linked above.