Tóm tắt nhanh:
ak-testxác định thay đổi cần chứng minh điều gì, chạy check nhỏ nhất đủ tin, điều tra mọi test hỏng rồi báo rõ phạm vi đã kiểm. Đạt thì chuyển choak-git, lỗi cần điều tra sâu thì chuyển choak-debug. Nó không làm test xanh bằng cách nới test.
Công khai: mình là maintainer của AgentKit và có quan hệ affiliate: link AgentKit trong bài là link affiliate, mua qua link này bạn được giảm 30%.
Tóm tắt
Dùng khi bạn vừa làm xong một tính năng hoặc sửa một bug và cần bằng chứng nó chạy đúng. Ngoài chạy test, bạn dùng nó để tạo, tối ưu và soát cả bộ test.
flowchart LR
A["ak-cook hoặc ak-fix xong"] --> B["ak-test"]
B --> C["Test đạt trong phạm vi"]
C --> D["ak-git"]
B --> E["Test hỏng cần điều tra sâu"]
E --> F["ak-debug"]
B --> G["create, optimize, audit bộ test"]Mỗi lần chạy, nó trả lời 4 câu hỏi:
| Điểm | Câu hỏi | Ví dụ |
|---|---|---|
| Hợp đồng cần chứng minh | Thay đổi này phải đúng điều gì, theo yêu cầu nào? | API trả 403 khi user truy cập workspace khác, theo spec phân quyền |
| Lớp thấp nhất đủ tin | Check nhỏ nhất nào chứng minh được điều đó? | Logic tính giảm giá kiểm bằng unit test, không cần mở trình duyệt |
| Kết quả còn dùng lại được không | Lần chạy trước còn khớp với code hiện tại không? | Test pass hôm qua nhưng hôm nay có file sửa chưa commit, phải chạy lại |
| Năm thao tác | Bạn muốn chạy test, test giao diện, tạo, tối ưu hay soát bộ test? | /ak-test kèm mô tả, ui kèm URL, create, optimize, audit kèm phạm vi |
Báo cáo luôn mở đầu bằng kết luận: đã kiểm trong phạm vi, thấy vi phạm, hoặc chưa đủ bằng chứng. Một check bắt buộc bị bỏ qua không bao giờ được tính là đạt, và chạy lại không xoá lần hỏng đầu tiên.
Prompt mẫu cho lần kiểm sau khi code xong:
/ak-test Kiểm thay đổi tính phí theo gói ở <module billing>.
Kỳ vọng: gói Pro giảm 20%, gói Free không đổi giá.
Ràng buộc: không sửa test cũ cho khớp kết quả mới.Ba cờ dưới đây chỉ dùng với create, optimize, audit:
| Cờ | Để làm gì | Từ ak |
|---|---|---|
--advice | Agent cố vấn góp ý ở mốc quan trọng | 2.13.0 |
--ultra | 5 bản phân tích độc lập, một bước chấm | 2.13.0 |
--interview | Duyệt từng nhóm thay đổi trước khi áp dụng | 2.13.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống kèm prompt, giải thích từng cờ (dùng khi, không cần khi, nhận lại gì, đi kèm cờ nào), lịch sử thay đổi theo bản ak và các lỗi hay vấp. Bản chi tiết và trang trực quan dành cho subscriber. Agent của bạn cũng tìm được trong đó qua MCP của portal.
Mở khi tài khoản có quyền subscriber
Bài này dành cho subscriber
Khi tài khoản có quyền, toàn bộ bài, bản visual tương tác và lệnh gọi từ agent đều mở.
- Đăng nhập hoặc tạo tài khoản modernEngineerQuyền đọc gắn với email tài khoản.
- Chọn gói trên trang Bảng giáGói 1, 3 hoặc 12 tháng, trả bằng chuyển khoản VietQR. Quyền đọc mở khoảng một phút sau khi tiền về.
- Hoặc nhập mã Facebook subscriberNgười ủng hộ trang qua Facebook nhận mã kích hoạt qua tin nhắn mỗi tháng.
Đã là subscriber? Đăng nhập để đọc.
Dùng bài này trong agent của bạn
Lấy API keyChép đoạn dưới, dán vào Claude Code, Codex hay agent bạn đang dùng. Agent đọc bài rồi đối chiếu với repo đang mở.
Đọc bài "ak-test: chạy test đúng phạm vi, báo rõ đã kiểm gì" trên modernEngineer rồi áp dụng vào repo này.
1. Gọi tool content_get của MCP server modernengineer với locale "vi", slug "ak-test". Nếu chưa nối MCP server modernengineer, dừng lại và hướng dẫn tôi nối theo https://modernengineer.dev/vi/mcp.
2. Tóm tắt các bước chính của bài, chỉ ra bước nào áp dụng được cho repo này.
3. Đề xuất thay đổi cụ thể và hỏi tôi trước khi sửa file.Nối MCP cho Claude Code (một lần)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Đọc trọn bài qua MCP cần API key của tài khoản subscriber hoặc đã mua guide này. Không có quyền, agent sẽ chỉ đọc được phần mở đầu.
- Phiên bản
- v1.0.0
- Cập nhật
- 22/10/2026
- Giấy phép
- Bảo lưu mọi quyền
- Slug
- ak-test
