> ## Content Index
> Fetch the complete content index at: https://aihub.vnpay.vn/llms.txt
> Use this file to discover other available public pages before exploring further.

# Condition-Based Waiting: Chấm dứt cảnh test "lúc pass lúc fail", cho bộ test ổn định và nhanh hơn
- URL: https://aihub.vnpay.vn/condition-based-waiting-cham-dut-canh-test-luc-pass-luc-fail-cho-bo-test-on-dinh-va-nhanh-hon/
- Published: 2026-08-19T03:24:53.000Z
- Updated: 2026-10-01T03:18:33.000Z
- Description: Trị dứt điểm các bài test "lúc pass lúc fail": thay khoảng chờ cứng bằng cách chờ đúng điều kiện — test ổn định hơn và chạy nhanh hơn.
- Author: Nguyễn Ngọc Hải
- Tags: Tài nguyên, Claude Skills

## Vì sao cần skill này

Trong lập trình, có một loại lỗi khiến ai cũng đau đầu: **test "chập chờn" (flaky test)** — cùng một bài kiểm thử, chạy lần này thì pass, lần khác lại fail mà không đổi gì. Thủ phạm quen thuộc là các **khoảng chờ cứng**: lập trình viên viết "chờ 50 mili-giây rồi kiểm kết quả", *đoán* rằng ngần đó thời gian là đủ. Trên máy nhanh thì đủ; nhưng khi hệ thống tải nặng, hoặc khi chạy song song trên máy chủ CI, 50ms lại *chưa* đủ — thế là test fail vô cớ.

Hệ quả: kết quả test không đáng tin, đội phát triển mất niềm tin vào chính bộ test của mình, và tốn thời gian "chạy lại cho may". **Condition-Based Waiting** giải quyết đúng gốc rễ đó với một nguyên tắc đơn giản: **chờ đúng *điều kiện* bạn thực sự quan tâm, thay vì đoán nó mất bao lâu.**

## Skill này làm được gì

Skill dạy Claude thay các khoảng chờ cứng bằng cơ chế **"chờ theo điều kiện" (polling)** — kiểm tra liên tục cho tới khi điều kiện thật sự xảy ra thì đi tiếp. So sánh trực quan:

```
❌ TRƯỚC: đoán thời gian
chờ 50ms → kiểm kết quả (hy vọng nó đã sẵn sàng)

✅ SAU: chờ điều kiện
chờ tới khi "kết quả đã có" → rồi mới kiểm
```

Kèm theo, skill cung cấp:

- **Hàm chờ tổng quát (`waitFor`)** — kiểm điều kiện mỗi 10ms, kèm *thời hạn tối đa (timeout)* để không lặp vô tận, và báo lỗi rõ ràng nếu quá hạn.
- **Bảng mẫu nhanh** cho các tình huống thường gặp: chờ một sự kiện xuất hiện, chờ trạng thái đạt "sẵn sàng", chờ đủ số lượng phần tử, chờ một file được tạo, hay chờ một điều kiện phức hợp.
- **Các lỗi thường mắc & cách sửa:** kiểm quá dày (mỗi 1ms → tốn CPU) → nên 10ms; quên timeout → phải luôn có; đọc dữ liệu cũ (cache trước vòng lặp) → phải lấy dữ liệu *mới* trong mỗi lần kiểm.
- **Khi nào khoảng chờ cứng LÀ đúng:** nếu bạn *đang kiểm thử chính hành vi thời gian* (debounce, throttle…) thì dùng chờ cứng là hợp lý — nhưng skill yêu cầu *chờ điều kiện kích hoạt trước*, dựa trên thời gian *đã biết* (không phải đoán), và **ghi chú giải thích vì sao**.

Về hiệu quả thực tế, tài liệu skill dẫn một phiên gỡ lỗi: sửa 15 test chập chờn, **tỷ lệ pass từ 60% lên 100%**, và **chạy nhanh hơn 40%** (vì không còn phải chờ "dư" thời gian).

## Giải quyết vấn đề gì — cho ai ở VNPAY

Cần nói thẳng để dùng đúng: **đây là skill rất hẹp và thuần kỹ thuật.**

**Đối tượng — lập trình viên và kỹ sư QA của Khối Công nghệ.** Nếu bạn viết **kiểm thử tự động** (unit test, integration test) cho các thao tác bất đồng bộ (async) và gặp cảnh test chập chờn, đây là công cụ trị đúng bệnh. Với môi trường fintech — nơi bộ test đáng tin và pipeline CI ổn định là điều kiện để phát hành an toàn — giá trị của việc "hết flaky test" là rất thực. Đây là "người anh em" của các skill Root Cause Tracing, Writing Plans và Verification Before Completion — cùng bộ kỹ năng làm việc kỷ luật trên codebase.

**Với Phòng Quản trị dự án (PM, P&T):** thành thật mà nói, skill này **gần như không dùng trực tiếp** trong công việc của phòng — bạn không viết test. Điều duy nhất có thể mang đi là *tinh thần*: **hãy chờ/đo đúng tín hiệu thật, thay vì đoán mò theo thời gian**. Ví dụ, đừng cho rằng "chắc bên kia đã xong sau 2 ngày" mà hãy xác nhận bằng một tín hiệu cụ thể (đã bàn giao, đã duyệt). Nhưng liên hệ này khá gián tiếp — bài này chủ yếu hữu ích cho **đội kỹ thuật**.

## Đặt kỳ vọng đúng

- **Đây là một "khuôn mẫu code" (pattern), không phải công cụ dùng chung.** Nó chỉ phát huy khi bạn đang viết/sửa kiểm thử tự động.
- **Ví dụ viết bằng TypeScript/JavaScript.** Skill khai "áp dụng mọi ngôn ngữ", nhưng mã mẫu là JS/TS; team dùng ngôn ngữ khác (Java, Go, Python…) vẫn áp được *nguyên lý*, phải chuyển mã sang cú pháp tương ứng.
- **Không phải "thần chú" xoá mọi flaky test.** Nó trị đúng loại flaky do *đoán thời gian*; các nguyên nhân khác (dữ liệu dùng chung, thứ tự chạy test…) cần cách xử lý riêng.

## Điều kiện để dùng

- Hợp nhất khi chạy trong **Claude Code**, làm việc trực tiếp trong codebase có bộ test.
- Cần gói Claude hỗ trợ Skills và code/agent (**Pro, Max, Team hoặc Enterprise**).

## Hướng dẫn upload skill lên Claude Desktop

Sau khi tải file skill về, làm theo 3 bước:

**Bước 1 — Mở Customize.** Trong giao diện Claude Desktop, bấm **"Customize"** ở **góc trên bên trái**.

**Bước 2 — Mở menu Add.** Trong màn hình Customize, bấm vào **dropdown của phần "Add"** ở **góc trên bên phải**.

**Bước 3 — Upload skill.** Chọn **"Upload skill"**, rồi trỏ tới file skill của bạn.

> **Lưu ý về định dạng file:** skill cần ở dạng thư mục chứa `SKILL.md` (ở đây kèm cả file `example.ts` minh hoạ). Nếu tải về từ site nội bộ dưới dạng `.zip`, cứ upload file `.zip` đó — bên trong đã là đúng cấu trúc skill.

Upload xong, skill nằm sẵn trong danh sách kỹ năng và Claude tự biết khi nào cần gọi.

## Các cách gọi skill lên

**1\. Để Claude tự nhận diện (khuyên dùng).** Mô tả triệu chứng, Claude sẽ khớp với skill:

> *"Test này lúc pass lúc fail, nhất là khi chạy song song — giúp tôi làm nó ổn định."* 
>  
> *"Thay các setTimeout trong test này bằng cách chờ đúng điều kiện giúp tôi."*

**2\. Gọi đích danh:**

> *"Dùng Condition-Based Waiting để refactor các test dùng khoảng chờ cứng trong file này."*

**3\. Rà soát cả bộ test:**

> *"Tìm các test đang dùng setTimeout/sleep tuỳ tiện và đề xuất chuyển sang chờ theo điều kiện."*

**Gợi ý dùng hiệu quả:** nếu một khoảng chờ cứng *thật sự* cần thiết (đang kiểm thử hành vi thời gian), hãy yêu cầu Claude **ghi chú rõ vì sao** — đúng tinh thần của skill: không cấm tuyệt đối, nhưng mọi khoảng chờ cứng phải có lý do được giải thích.

## Lưu ý cho môi trường VNPAY

- Skill này không truy cập dữ liệu hay chạy thao tác nguy hiểm — nó chỉ cải thiện cách viết test. Rủi ro thấp.
- Với hệ thống liên quan **giao dịch/tài chính**, một bộ test ổn định, đáng tin là nền tảng để phát hành an toàn — nhưng kết quả vẫn cần đội kỹ thuật rà soát theo quy trình nội bộ.

*(Đây là khuyến nghị chung; team cần đối chiếu với chính sách nội bộ hiện hành của VNPAY.)*

## Tóm lại

Condition-Based Waiting trị đúng một nỗi khổ quen thuộc của dân phát triển: những bài test "lúc pass lúc fail" do đoán mò thời gian. Bằng cách **chờ đúng điều kiện thay vì chờ một số giây tuỳ tiện**, nó giúp bộ test vừa *đáng tin hơn* vừa *chạy nhanh hơn*. Đây là một skill hẹp nhưng sắc — giá trị nằm gọn ở **đội lập trình và QA của VNPAY**; với phần còn lại của phòng, thứ đáng lấy chỉ là một nguyên lý nhỏ: *hãy chờ tín hiệu thật, đừng đoán mò*.

---

Download file:

[exampleexample.zip3 KBdownload-circle](https://aihub.vnpay.vn/content/files/2026/08/example.zip "Download")

---

**References**

1. Anthropic *Agent Skills — Claude Platform Docs*. Available at: [https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview?ref=aihub.vnpay.vn) (Accessed: 19/08/2026).
2. Skill nguồn: `Condition-Based Waiting` (tải từ GitHub), kèm file `example.ts`.