Tóm tắt nhanh:
ak-explainđọc đúng chỗ trong nguồn, dựng một mô hình tư duy 5 phần và tách rõ điều đã kiểm với điều suy luận. Mặc định nó trả lời bằng Markdown; thêm--eli5để nói bằng ví von đời thường,--htmlđể có trang HTML có sơ đồ. Nó chỉ giải thích, không sửa code; muốn sửa thì nó chuyển sang skill sửa lỗi bạn đã cài.
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ần hiểu một khái niệm, một file code, một kiến trúc hay một thông báo lỗi trước khi đụng vào. Không cần khi bạn chỉ muốn nói lại câu trả lời vừa rồi cho dễ hiểu (việc của ak-bro) hoặc muốn mở một file HTML hay slide (việc của ak-preview).
flowchart LR
A["Chủ đề, file, lỗi cần hiểu"] --> B["ak-explain"]
B --> C["Giải thích Markdown trong chat"]
B --> D["Trang HTML có sơ đồ"]
B --> E["Muốn sửa: sang skill sửa lỗi đã cài"]Bốn khái niệm cần nắm:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Đã kiểm hay suy luận | Câu nào nó đã thấy trong nguồn, câu nào nó đoán? | "Đã đọc src/auth/refresh.ts: token làm mới mỗi 15 phút" khác với "Suy luận: có thể do cache ở proxy" |
| Mô hình 5 phần | Bạn cần nắm những gì để tự suy ra phần còn lại? | Event loop: ý chính trong 1 đến 2 câu, các thành phần, thứ tự chạy từ đầu vào tới đầu ra, một ví dụ nhỏ, rồi các giới hạn và chỗ dễ hỏng |
| Đơn giản mà không mất cảnh báo | Nói dễ hiểu hơn có làm mất rủi ro không? | Giải thích rm -rf bằng --eli5 vẫn phải nói rõ: xoá vĩnh viễn mọi thứ dưới đường dẫn, không lấy lại được |
| Đúng việc của nó | Yêu cầu này có thuộc ak-explain không? | "Nói lại câu trả lời vừa rồi cho dễ hiểu" là việc của ak-bro; "mở file HTML này" là việc của ak-preview |
Nội dung bạn đưa vào như file, log lỗi, mô tả issue được coi là dữ liệu: câu lệnh cài sẵn trong đó chỉ được giải thích, không được làm theo, và secret không bao giờ được đưa vào câu trả lời.
Prompt mẫu để hiểu một khái niệm:
/ak-explain Refresh token trong JWT hoạt động thế nào, và vì sao cần nó
khi đã có access token?| Cờ | Để làm gì | Từ ak |
|---|---|---|
--html | Một trang HTML giải thích bằng hình | 2.15.0 |
--ak-render | Dựng trang HTML bằng AK Render | 3.0.0-beta.5 |
--eli5 | Giải thích bằng lời đơn giản, ví von đời thường | 2.15.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, 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-explain: giải thích code, hệ thống, lỗi có dẫn chứ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-explain". 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-explain
