Kiểm thử hồi quy trình duyệt với agent-qa (Spring Boot 3)
Kỹ năng hướng dẫn Claude dùng agent-qa để kiểm thử hành trình người dùng trên trình duyệt của ứng dụng Spring Boot 3 đang chạy, và chỉ báo cáo dựa trên bằng chứng thực thi thật.
Lập trìnhNâng cao★ 338⑂ 54Điểm AI 8/10Cập nhật lần cuối: 2 thg 11, 2026
Kỹ năng này làm gì
- Cung cấp quy trình và quy tắc để Claude chạy kiểm thử hồi quy trên trình duyệt bằng CLI
agent-qađối với ứng dụng Spring Boot 3 đang chạy. - Bắt buộc 4 bước: chọn đúng target (phân biệt origin UI thật với reverse proxy, cổng API và cổng quản trị Actuator), thực thi giới hạn phạm vi (validate → dry-run → chỉ chạy thật khi được ủy quyền), thu thập bằng chứng (run ID, digest, runs overview, evidence theo step), và truy vết nguồn gốc bộ nhớ memidex.
- Giữ nguyên kim tự tháp kiểm thử: không thay thế MockMvc, test repository hay Testcontainers bằng kiểm thử trình duyệt.
- Bảo toàn xác thực, phân quyền, CSRF, ranh giới tenant và định dạng phản hồi — cấm tắt bảo mật chỉ để test chạy qua.
- Giữ thông tin đăng nhập trong
workspace.secretsFile, tham chiếu qua{{secret:NAME}}; cảnh báo rủi ro lộ dữ liệu trong ảnh chụp màn hình và video. - Không coi dry-run thành công hay exit 0 là "đã pass"; phải trích nguyên văn kết luận thật của lần chạy và báo cáo tình trạng không thể thực thi như một giới hạn riêng.
Dành cho ai
- Nhóm vận hành ứng dụng Spring Boot 3 có giao diện web và đang dùng (hoặc cân nhắc) công cụ kiểm thử bằng ngôn ngữ tự nhiên agent-qa.
- Kỹ sư QA/backend từng gặp cảnh AI báo "test đã pass" trong khi thực tế chỉ mới gọi health check.
- Tech lead muốn chặn trước việc agent tắt CSRF hoặc xác thực để test chạy qua.
- Không phù hợp với dịch vụ chỉ có API (chính kỹ năng này khuyên dùng kỹ năng kiểm thử HTTP/tích hợp thay thế).
Ví dụ sử dụng
- Kiểm tra luồng thanh toán: "Xác minh hành trình checkout trên bản build mới" → rà soát
tests/checkout.yaml, chạyagent-qa validate, rồi--dry-run, chỉ khi được ủy quyền mới chạy thật với--build-tag "$APP_BUILD_TAG", sau đó đọc digest và evidence theo step để báo cáo. - Phân loại nguyên nhân thất bại: Khi kết quả fail, phân biệt rõ lỗi ứng dụng, kỳ vọng sai trong test, lỗi môi trường (thiếu credential/hạ tầng) hay kết luận không chắc chắn của agent, kèm hành động tiếp theo nhỏ nhất.
- Đối chiếu bộ nhớ memidex: Khi bản ghi thành công cũ mâu thuẫn với lần chạy thất bại hiện tại, dùng
agent-qa runs knowledge RUN_ID --jsonvàknowledge inspectđể kiểm tra nguồn gốc và tính hợp lệ, nhưng không được sửa/xóa bộ nhớ trong lúc rà soát.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/rrezartprebreza/spring-boot-skills/HEAD/skills/spring-boot-3/agent-qa-browser-regression/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên AI Skill Mart. Copy thư mục skills/spring-boot-3/agent-qa-browser-regression từ repo GitHub rrezartprebreza/spring-boot-skills vào ~/.claude/skills/agent-qa-browser-regression/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/rrezartprebreza/spring-boot-skills.git && mkdir -p ~/.claude/skills && cp -r spring-boot-skills/skills/spring-boot-3/agent-qa-browser-regression ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và di chuyển tới thư mục bạn muốn lưu kỹ năng.
- Tải mã nguồn:
git clone https://github.com/rrezartprebreza/spring-boot-skills.git - Tạo thư mục kỹ năng của Claude:
mkdir -p ~/.claude/skills - Sao chép toàn bộ thư mục kỹ năng (kèm thư mục
examples/):cp -r spring-boot-skills/skills/spring-boot-3/agent-qa-browser-regression ~/.claude/skills/ - Nên chép thêm kỹ năng được tham chiếu để liên kết không bị hỏng:
cp -r spring-boot-skills/skills/spring-boot-3/testing-pyramid ~/.claude/skills/ - Chuẩn bị môi trường: cài Node.js 24+, cài CLI
agent-qa, tạoagent-qa.config.yamlvà cấu hìnhworkspace.secretsFileở thư mục dự án. - Khởi động lại Claude Code, rồi yêu cầu kiểu: "Dùng agent-qa kiểm tra hành trình checkout trên ứng dụng đang chạy".
- Luôn chạy thử trên môi trường test có thể xóa bỏ trước; chạy trên production chỉ khi có phê duyệt rõ ràng.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT