Tóm tắt nhanh:
ak-previewlàm hai việc: mở một file hay thư mục Markdown có sẵn trong trình đọc trên trình duyệt, hoặc dựng mới một bản giải thích, sơ đồ, bộ slide, trang review diff, trang so plan với code hay bản tóm tắt dự án. Kết quả là file Markdown hoặc một file HTML tự chứa, lưu trong thư mục visuals cạnh plan. Cần sơ đồ SVG/PNG chất lượng đăng bài thì chuyển choak-tech-graph.
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 nhìn thay vì đọc chữ: đọc một tài liệu dài, hiểu một luồng code, có sơ đồ kiến trúc để chia sẻ, review một nhánh trước khi merge, trình bày plan bằng slide, hay nắm lại dự án sau một thời gian. Chỉ cần xem nhanh trong terminal thì dùng --ascii.
flowchart LR
A["File .md có sẵn"] --> P["ak-preview"]
B["Chủ đề, diff, plan, khoảng thời gian"] --> P
P --> C["Trình đọc Markdown trên trình duyệt"]
P --> D["File .md hoặc .html trong visuals/"]
D --> E["ak-tech-graph khi cần bản SVG/PNG để đăng"]
D --> F["Dừng, bạn xem và quyết định"]Bốn khái niệm cần nắm:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Xem hay tạo | Bạn muốn mở thứ đã có, hay dựng hình mới? | /ak-preview docs/guide.md mở trình đọc; /ak-preview --explain luồng đăng nhập viết file mới |
| Markdown hay HTML | Kết quả được xem bằng gì? | Không có --html: ra file .md xem qua server; có --html: ra một file .html mở thẳng |
| Nơi lưu file | File ra nằm ở đâu? | Có plan đang chạy thì vào thư mục visuals/ của plan, không thì vào plans/visuals/ |
| Đường dựng HTML | Ai lo bố cục và giao diện của trang HTML? | Mặc định skill tự viết HTML theo mẫu; với --ak-render nó viết .page.yaml để AK Render biên dịch |
Trùng tên file thì file cũ trong thư mục visuals bị ghi đè, không hỏi lại.
Prompt mẫu cho review một nhánh trước khi merge:
/ak-preview --html --diff <tên nhánh hoặc số PR>| Cờ | Để làm gì | Từ ak |
|---|---|---|
--html | Ra một file HTML tự chứa thay cho Markdown | 1.0.0 |
--explain | Giải thích trực quan một khái niệm hay một luồng code | 1.0.0 |
--slides | Dựng bộ slide trình chiếu | 1.0.0 |
--diagram | Một sơ đồ tập trung, có bản ASCII và bản Mermaid | 1.0.0 |
--ascii | Sơ đồ chỉ bằng ký tự, xem trong terminal | 1.0.0 |
--diff | Trang review trực quan cho một thay đổi | 1.0.0 |
--plan-review | Đặt plan cạnh code thật để soát | 1.0.0 |
--recap | Ảnh chụp ngữ cảnh dự án trong một khoảng thời gian | 1.0.0 |
--ak-render | Dựng trang HTML bằng AK Render | 3.0.0-beta.5 |
--no-antv, --no-diagram-design, --no-editorial-visuals | Tắt lớp hình minh hoạ trong trang HTML | 2.13.0 |
--stop | Dừng server xem đang chạy | 1.0.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-preview: xem Markdown và dựng giải thích, sơ đồ, slide" 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-preview". 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-preview
