Tóm tắt nhanh:
ak-predictcho 5 persona (kiến trúc, bảo mật, hiệu năng, UX, người phản biện) phân tích riêng đề xuất của bạn, rồi ra phán quyết GO, CAUTION hoặc STOP kèm rủi ro và việc nên làm. Làm tiếp thì sangak-planrồiak-cook; cần đào sâu rủi ro thì sangak-scenario. Nó không viết code và không tự đổi phạm vi bạn đã chốt.
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 sắp làm một thay đổi lớn hoặc rủi ro và muốn biết nó hỏng ở đâu trước khi viết dòng code nào. Không cần khi thay đổi nhỏ, ít rủi ro; bug thì dùng ak-debug, việc đã quyết xong thì sang thẳng ak-plan.
flowchart LR
A["Đề xuất thay đổi"] --> B["ak-predict"]
B --> C["Phán quyết + báo cáo rủi ro"]
C -->|"GO, CAUTION"| D["ak-plan rồi ak-cook"]
C -->|"Cần đào sâu rủi ro"| E["ak-scenario"]
C -->|"STOP"| F["Thiết kế lại hoặc bổ sung thông tin"]
C -->|"--chain"| G["Vòng tinh chỉnh hoặc vòng truy vấn yêu cầu"]Bốn khái niệm cần nắm:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| 5 góc nhìn | Ai soi đề xuất của tôi, và mỗi người hỏi gì? | Kiến trúc hỏi có thêm phụ thuộc chéo không. Bảo mật hỏi chỗ nào bị lạm dụng. Hiệu năng hỏi có truy vấn N+1 không. UX hỏi màn hình lỗi trông ra sao. Người phản biện hỏi "sao không làm gì cả?" |
| Bằng chứng cho từng phát hiện | Một lo ngại cần gì để được tính? | "WebSocket làm rò kết nối" chỉ được tính khi có chỗ trong code, giả định đi kèm, và một đường hỏng cụ thể (ví dụ tab đóng mà server không dọn kết nối). Năm cái tên persona khác nhau không có nghĩa là năm bằng chứng độc lập. |
| Phán quyết | Làm tiếp, làm cẩn thận, hay dừng? | GO khi bằng chứng ủng hộ thiết kế và không còn rủi ro nghiêm trọng. CAUTION khi có lo ngại nhưng đã có cách giảm. STOP khi còn một vấn đề nghiêm trọng chưa giải được. |
| Phạm vi đã duyệt | Nó có tự cắt hay đổi việc tôi đã chốt không? | Phạm vi đã duyệt là "thêm multi-tenancy cho bảng orders". Persona đề xuất bỏ hẳn tính năng thì báo cáo ghi đó là một quyết định để bạn chọn, không tự đổi phạm vi. |
Chỉ cần một điều sau là đủ STOP: lỗ hổng vượt quyền hoặc lộ dữ liệu không có cách giảm, thiết kế không hợp với kiến trúc tới mức phải làm lại nhiều, độ trễ hay số truy vấn bùng nổ không có đường vòng, hoặc một giả định sai làm hỏng cả cách tiếp cận.
Prompt mẫu cho một tính năng rủi ro:
/ak-predict "Thêm thông báo thời gian thực bằng WebSocket cho app <tên app>.
Hiện server chạy REST sau load balancer, có khoảng <số> người dùng đồng thời."| Cờ | Để làm gì | Từ ak |
|---|---|---|
--files | Chỉ cho persona vùng code bị ảnh hưởng | 1.0.0 |
--chain | Chạy thêm một vòng sau phán quyết | 1.0.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, đ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-predict: năm chuyên gia soi thay đổi trước khi code" 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-predict". 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-predict
