Trình dựng test theo kịch bản
Biên dịch một kịch bản hành vi viết bằng Markdown thành test tất định trong đúng stack test mà repo đang dùng.
Lập trìnhTrung cấp★ 168⑂ 6Điểm AI 9/10Cập nhật lần cuối: 16 thg 8, 2026
Làm được gì
- Bắt buộc "hiểu repo trước khi viết code": đọc AGENTS.md, README, hướng dẫn đóng góp, cấu hình test, các test lân cận và điền đủ các mục như bề mặt sản phẩm, lệnh chạy, test runner, chiến lược fixture, lệnh kiểm tra.
- Chuẩn hóa yêu cầu dạng văn xuôi thành kịch bản Given/When/Then với nguyên tắc: một hành vi, một lý do fail.
- Lập bảng ánh xạ tiền điều kiện, hành động, oracle (kết quả quan sát được) và cleanup sang fixture, API công khai, CLI runner hoặc browser runner của repo.
- Chọn harness hẹp nhất phù hợp (web, API, CLI, desktop, mobile) và viết test theo đúng style code xung quanh.
- Giữ truy vết hai chiều giữa file kịch bản Markdown và file test (ID kịch bản trong tên test hoặc comment).
- Chạy test riêng lẻ, rồi suite liên quan, rồi lint/type/build/test bắt buộc, sau đó báo cáo bằng chứng.
Phù hợp với ai
- Dev và QA cần chuyển tiêu chí nghiệm thu (acceptance criteria) thành test tự động
- Nhóm muốn tái hiện lỗi hồi quy mà người dùng thấy được trước khi sửa
- Người đóng góp open-source phải thêm test vào codebase lạ
Ví dụ sử dụng
- Biên dịch điều kiện "chạy lệnh CLI với session hết hạn thì hiện hướng dẫn đăng nhập lại" thành test pytest dùng subprocess runner có sẵn.
- Viết test Playwright cho kịch bản "nhận lời mời workspace rồi tên xuất hiện trong danh sách thành viên", dùng test-id ổn định của dự án.
- Từ một bug report, tạo test tích hợp API fail trước khi fix và pass sau khi fix để chặn hồi quy.
Lưu ý: skill chủ động từ chối hoặc chia nhỏ các kịch bản quá rộng, phụ thuộc đánh giá cảm quan, hay cần thanh toán/xác nhận thậ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/tamdogood/builder-essential-skills/HEAD/skills/build-scenario-tests/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 Claude Skill Mart. Copy thư mục skills/build-scenario-tests từ repo GitHub tamdogood/builder-essential-skills vào ~/.claude/skills/build-scenario-tests/ 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/tamdogood/builder-essential-skills.git && mkdir -p ~/.claude/skills && cp -r builder-essential-skills/skills/build-scenario-tests ~/.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à về thư mục home:
cd ~ - Clone repo:
git clone https://github.com/tamdogood/builder-essential-skills.git - Tạo thư mục skills nếu chưa có:
mkdir -p ~/.claude/skills - Copy riêng skill này:
cp -r builder-essential-skills/skills/build-scenario-tests ~/.claude/skills/ - Kiểm tra các thư mục con
references/vàexamples/đã được copy:ls ~/.claude/skills/build-scenario-tests - Khởi động lại Claude Code và thử yêu cầu: "biến tiêu chí nghiệm thu này thành scenario test".
- Nên chạy trong thư mục gốc của dự án đã có sẵn test runner để skill phát huy tốt nhất.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT