Tóm tắt nhanh:
ak-advisehỏi bạn từng câu một cho tới khi hai bên hình dung cùng một kết quả, vẽ bản xem trước để bạn xác nhận, rồi mới khuyên: nên làm gì, không nên làm gì, đánh đổi, kèm bản giao việc. Lời khuyên chuyển sangak-brainstormhoặcak-planrồiak-cook, hoặc dừng để bạn tự quyết. Nó không viết code và không tự làm theo lời khuyên của nó.
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 có một ý tưởng còn mơ hồ, một plan cần ý kiến thứ hai, một issue cần trả lời, hoặc một quyết định lớn mà chọn sai thì phải làm lại nhiều tuần. Không cần khi bạn muốn sửa code ngay, hoặc cần so sánh cách làm rồi chuyển thẳng sang plan: lúc đó dùng ak-brainstorm.
flowchart LR
A["Ý tưởng, plan hoặc URL"] --> B["ak-advise"]
B --> C["Bản chốt + bản xem trước"]
C --> D["Lời khuyên + bản giao việc"]
D --> E["ak-brainstorm"]
D --> F["ak-plan rồi ak-cook"]
D --> G["Dừng, bạn tự quyết"]Nó dựng 4 thứ, theo thứ tự:
| Bước | Câu hỏi | Ví dụ |
|---|---|---|
| Phỏng vấn từng câu | Điều gì code và tài liệu không trả lời được, mà chỉ bạn biết? | "Làm xong, bạn muốn gõ lệnh gì và thấy dòng nào trên màn hình?" |
| Bản chốt | Hai bên đã hiểu cùng một việc chưa? | Vấn đề viết lại, yêu cầu đánh số, mục tiêu, xong nghĩa là ("trang giá đọc từ API mới, file giá cứng đã xoá, test e2e pass"), ngoài phạm vi, ràng buộc |
| Bản xem trước | Kết quả cuối trông thế nào, hoặc chạy ra sao? | Sơ đồ luồng thanh toán sau khi làm, ghi rõ đây là trạng thái đề xuất, các giả định được đánh dấu để bạn sửa |
| Bản giao việc | Muốn giao cho skill khác làm tới cùng thì dán gì? | Một khối text gồm mục tiêu, xong nghĩa là, ngoài phạm vi, ràng buộc, và vài điều kiện hẹp mới được dừng lại hỏi |
Quyết định là của bạn: nó phản biện mạnh nhưng không đè lên lựa chọn bạn đã chốt, chỗ bất đồng được ghi thành đánh đổi. Khi lời khuyên định hình kiến trúc, nó so chi phí làm sẵn chỗ nối hẹp với giữ code cụ thể, và xếp lớp trừu tượng chỉ để phòng xa vào mục không nên làm.
Prompt mẫu cho ý tưởng còn mơ hồ:
/ak-advise Tôi muốn trang quản trị của <tên app> dễ dùng hơn cho nhân viên mới.
Hiện tại họ hay hỏi lại cách xuất báo cáo.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--html | Trang HTML tự chứa của lời khuyên để xem, gửi người khác | 1.0.0 |
--md | Báo cáo Markdown đọc được mà không cần xem cuộc trò chuyện | 1.0.0 |
--wiki | Đăng báo cáo lên AgentWiki, mặc định riêng tư, kèm link chia sẻ | 1.0.0 |
--github | Bình luận lời khuyên lên issue, PR, hoặc tạo issue mới | 1.0.0 |
--agent | Chạy cả vòng hỏi đáp trong agent advisor, giữ phiên chính gọn | 1.1.0 |
--ultra | Chạy 5 bản lời khuyên độc lập, giữ nguyên một bản thắng | 2.13.0 |
--yagni | Chất vấn và đề xuất cắt phần không cần cho kết quả | 2.8.0 |
--no-antv, --no-diagram-design, --no-editorial-visuals | Tắt hình minh hoạ trong trang HTML | 2.13.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 6 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-advise: hỏi tới khi hiểu đúng ý, rồi khuyên thẳng" 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-advise". 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-advise
