Chọn đúng Skill để kiểm tra UI

Một app có thể pass test suite và hoàn thành journey đã deploy nhưng vẫn làm customer bối rối. Các kết quả này không mâu thuẫn: mỗi workflow đặt một câu hỏi khác nhau và tạo ra một loại bằng chứng khác nhau.

Dùng hướng dẫn này khi chọn giữa ak-test, ak-web-testing và ak-agent-browser.

Bắt đầu từ câu hỏi cần trả lời

Quy tắc ngắn nhất:

• Chọn ak-test cho validation ở cấp code.
• Chọn ak-test ui để kiểm tra rộng UI đang chạy.
• Chọn ak-web-testing cho coverage journey bền vững, chạy lại được.
• Chọn ak-agent-browser để khám phá trực tiếp qua browser.

Hiểu phần giao nhau

ak-test là workflow validation rộng. Khi không có ui, Skill xác định scope được yêu cầu, chạy type-check hoặc analyze khi phù hợp rồi chạy các suite hiện có liên quan. Coverage và build verification chỉ được thêm khi cần; Skill không hứa chạy mọi gate có thể có trong mỗi lần gọi.

Với ui <URL>, ak-test chuyển sang workflow UI live. Skill có thể route browser work qua ak-agent-browser, ak-chrome-profile, ak-web-testing hoặc runner sẵn có của project rồi tạo QA report có cấu trúc.

ak-web-testing chuyên về test strategy và runner chạy lại được như Playwright, Vitest, axe, Lighthouse và k6. Hãy cung cấp journey đã biết, expected behavior, test data, environment cùng artifact cần giữ. Đây là lựa chọn mạnh nhất khi kết quả PASS hoặc FAIL cần được tái hiện về sau.

ak-agent-browser điều khiển trực tiếp một browser mới hoặc do tool quản lý. Skill hỗ trợ session tự động dài, snapshot, screenshot, tương tác form, lưu state và quay video. Workflow exploratory QA phù hợp khi chưa biết đầy đủ path từ đầu. Skill không tự tạo nhiều customer độc lập: persona review là contract trong prompt và phải có account, session, viewport cùng ranh giới reset rõ ràng.

So sánh trên cùng một deployed journey

Giả sử customer kết nối một provider, thấy trạng thái Connected, refresh trang và kỳ vọng kết nối vẫn còn.

Kiểm tra rộng UI đang chạy

/ak-test ui https://app.example.com

Kiểm tra connection flow trên desktop và mobile. Thu bằng chứng cho form,
responsive, accessibility và console. Chỉ dùng test account được cung cấp và
không thay đổi production data không liên quan.

Lần chạy này có thể phát hiện form mobile bị cắt, browser error hoặc độ tương phản kém. Đây là lượt quét hữu ích nhưng không tự biến mọi quan sát thành regression test lâu dài.

Biến journey thành test chạy lại được

/ak-web-testing e2e "Trên https://app.example.com, xác minh connected journey:
đăng nhập bằng test account đã duyệt, kết nối test provider, assert chính xác
trạng thái Connected, refresh rồi assert kết nối đó vẫn tồn tại. Chạy tuần tự
trên Chromium. Giữ Playwright trace và failure screenshot. Không liên hệ billing,
gửi message hoặc thay đổi production data không liên quan."

Chọn workflow này khi expected state đã rõ và cùng một check cần bảo vệ các release sau.

Review qua nhiều góc nhìn customer

/ak-agent-browser https://app.example.com

Chạy bốn lượt khám phá tách biệt: customer mới, customer quay lại, customer dùng
mobile và power user. Với mỗi lượt, dùng account hoặc browser session, viewport,
starting state và ranh giới reset đã duyệt. Chỉ tương tác qua UI hiển thị. Ghi
lại điểm gây bối rối, bước bị chặn, trạng thái bất ngờ và khả năng phục hồi.
Chụp screenshot tại trạng thái quan sát được và trả về bước tái hiện. Không bịa
hoặc dựng lại evidence sau lần chạy.

Đây là các lượt khám phá theo persona, không phải bốn customer thật hoặc bốn Agent độc lập. Dùng account hay session riêng khi persona cần server state hoặc browser state khác nhau.

Chọn đúng cách xác thực

ak-agent-browser dành cho công việc không phụ thuộc profile, trong browser mới hoặc do tool quản lý. Dùng ak-chrome-profile khi journey cần cookie, login state, Google account, tenant hay workspace đang mở trong Chrome thật của user. Khi có thể, hãy dùng auth fixture của project cho test cần chạy lại.

Chuyển khám phá thành coverage bền vững

1. Chạy ak-test trước deploy cho các code-level gate đã chọn.
2. Chạy ak-web-testing cho journey quan trọng cần assertion lặp lại được.
3. Dùng ak-test ui <URL> khi cần quét site live rộng hơn.
4. Dùng ak-agent-browser để tìm khoảng trống requirement chưa dự đoán được.
5. Chuyển functional regression đã xác nhận thành test ak-web-testing tập trung.

Giữ finding về customer friction trong product hoặc UX review nếu automated assertion không thể diễn đạt nó trung thực. Hãy dùng workflow nhỏ nhất có thể chứng minh rủi ro cần kiểm soát.

Yêu cầu bằng chứng rõ ràng

Chỉ gọi tên Skill không đảm bảo đúng loại report. Hãy nêu evidence contract:

• Target environment và journey chính xác;
• Test account, session, fixture, starting state và ranh giới cleanup;
• Trạng thái mong đợi sau từng action quan trọng;
• Browser, device, viewport và auth method;
• Screenshot, trace, video, visual diff hoặc console evidence cần giữ;
• Tách riêng pass, fail, blocked, skipped và unverified;
• Finding ID liên kết từng kết luận với evidence;
• Data và external service không được phép chạm tới.

ak-agent-browser có thể lưu browser artifact như screenshot và video nhưng không định nghĩa schema cho Markdown report. Hãy yêu cầu agent gọi Skill hoặc workflow ak-test ui materialize finding cùng artifact link thành report đã được review.

Tạo HTML showcase trực quan

ak-show-off tạo showcase có thiết kế; đây không phải forensic renderer. Workflow có thể research tài liệu hỗ trợ, viết lại content, thêm visual treatment và chụp screenshot mới của trang đã tạo. Các ảnh showcase phát sinh đó không phải evidence của app.

Trước tiên hãy review Markdown report và browser artifact gốc. Sau đó yêu cầu một lượt local chỉ để trình bày:

/ak-show-off artifacts/customer-review/report.md --no-publish --no-screenshots
--no-editorial-visuals --languages vi

Tạo HTML customer-review showcase local từ source này. Giữ nguyên mọi finding ID
và ảnh evidence gốc. Giữ finding blocked và unverified ở trạng thái rõ ràng.
Không thêm product finding, số liệu, screenshot hoặc claim không có trong source
đã review. Trả về đường dẫn HTML local.

Ngay cả với các control này, vẫn phải review HTML sinh ra so với source report. HTML chỉ chứng minh finding đã được trình bày, không kiểm chứng app thêm một lần nữa. Nếu cần renderer bảo toàn byte hoặc deterministic, hãy dùng report generator chuyên dụng thay vì ak-show-off.

Bảo vệ production

Trước khi test production, hãy xác định account cùng test-data namespace đã duyệt, thao tác ghi được phép, action bị cấm, isolation cho integration, cleanup ownership và điều kiện dừng. Không chạy load, destructive, security, payment hoặc irreversible lifecycle check lên production khi chưa có quyền chính xác cùng kế hoạch isolation.

Chọn nhanh