Tóm tắt nhanh:
ak-excalidrawvẽ sơ đồ kiến trúc, luồng dữ liệu hay quy trình mà sau này bạn còn mở ra sửa được: trên canvas Excalidraw trực tiếp nếu máy có Excalidraw MCP, không thì thành file.excalidrawkèm ảnh PNG. Nói "diagram this repo" là nó tự đọc code và vẽ. Nó dừng ở sơ đồ, không chuyển cho skill khác, và không nhồi cả repo lớn vào một hình.
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 một sơ đồ còn sửa tiếp được: tổng quan kiến trúc repo, một luồng kỹ thuật để giải thích cho người khác, hoặc thêm một khối vào sơ đồ đã có. Không cần khi bạn chỉ muốn một danh sách hộp, mỗi thứ một hộp. Máy chưa cài gì thì lần đầu phải cài chế độ file hoặc canvas trước.
flowchart LR
A["Mô tả sơ đồ hoặc repo"] --> B["ak-excalidraw"]
B --> C["Canvas trực tiếp, xuất PNG, SVG, link"]
B --> D["File .excalidraw và ảnh PNG"]
B --> E["Chưa cài gì: hướng dẫn cài"]Bốn điều quyết định sơ đồ bạn nhận được:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Hai chế độ vẽ | Sơ đồ được vẽ ở đâu? | Có Excalidraw MCP và canvas ở http://localhost:3000 thì vẽ thẳng lên canvas. Không thì ghi file .excalidraw rồi dựng PNG bằng Chromium chạy ngầm, không cần server. |
| Sơ đồ phải nói được ý | Xoá hết chữ, hình còn cho thấy ý chính không? | Một bước ra nhiều đầu ra thì vẽ mũi tên toả ra, không xếp lưới thẻ giống nhau. Chỉ đóng hộp khi hộp mang nghĩa. |
| Giới hạn khi tự vẽ repo | Một sơ đồ chứa được bao nhiêu? | Tối đa 12 khối và 20 mũi tên. Nhiều hơn thì gom theo thư mục cấp đầu thành vùng, rồi đề nghị vẽ chi tiết từng vùng. |
| Vòng tự soát | Làm sao biết không có chữ bị cắt hay mũi tên nối sai? | Agent xem ảnh vừa dựng, sửa rồi dựng lại: chế độ file thường 2 đến 4 vòng, canvas tối đa 2 vòng. |
Đánh đổi cần biết: chế độ file chỉ dựng PNG, muốn SVG phải dùng canvas; còn canvas soát tối đa 2 vòng rồi trình bày kèm danh sách lỗi còn lại.
Prompt mẫu (vẽ kiến trúc repo):
/ak-excalidraw diagram this repo
Dự án: <tên app>. Lưu file vào docs/.
Xong khi: có file .excalidraw và ảnh PNG không có chữ bị cắt.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--export | Nhận png hoặc svg; chỉ khai báo, không mô tả hành vi | 2.15.0 |
--live | Cờ bật tắt; chỉ khai báo, không mô tả hành vi | 2.15.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ờ, 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-excalidraw: vẽ sơ đồ Excalidraw sửa được từ mô tả hoặc 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-excalidraw". 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-excalidraw
