Tóm tắt nhanh:
ak-graphifydùng công cụgraphifydựng một graph tri thức từ code, tài liệu, paper và ảnh, rồi bạn hỏi graph đó thay vì grep từng file. Báo cáo của graph thường được chuyển choak-plan, hoặc graph được mở cho Claude truy vấn qua MCP server. Nó không dựng graph cho câu hỏi chỉ hỏi một lần: tra một hàm hay một file nhỏ thì search thường nhanh hơ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 sẽ hỏi đi hỏi lại về quan hệ trong một dự án lớn, ví dụ module nào phụ thuộc module nào, nhất là trước khi lập plan cho một thay đổi lớn. Không cần khi chỉ tra một hàm hay một file nhỏ: search thường hoặc ak-scout nhanh hơn.
flowchart LR
A["Câu hỏi kiến trúc lặp lại"] --> B["ak-graphify"]
Q["Tra một hàm, một file nhỏ"] --> S["Search thường hoặc ak-scout"]
B --> C["graphify-out: báo cáo, graph.json, trang HTML"]
C --> D["ak-plan"]
C --> E["MCP server cho Claude truy vấn"]Trước khi chạy, nên nghĩ qua 4 điều:
| Khái niệm | Câu hỏi | Ví dụ |
|---|---|---|
| Có đáng dựng graph không | Câu hỏi này có lặp lại đủ nhiều để bù công dựng graph? | Tìm hàm parseInvoice ở đâu thì search thường. Hỏi nhiều lần "luồng thanh toán đi qua những module nào" thì dựng graph. |
| Dữ liệu nào rời máy | Phần nào xử lý tại máy, phần nào gửi cho model? | Code, audio và video xử lý tại máy. Tài liệu và ảnh gửi cho provider model bạn đang cấu hình, nên contracts/ chứa PDF nhạy cảm cần xem lại trước. |
| Độ tin của mỗi quan hệ | Quan hệ này lấy thẳng từ code hay do model đoán? | EXTRACTED đọc thẳng từ code, INFERRED do model suy ra kèm điểm tin cậy, AMBIGUOUS cần người kiểm. Cạnh INFERRED "billing phụ thuộc auth" nên đối chiếu với code trước khi dựa vào. |
| Graph cũ hay mới | Graph đang có còn khớp với code hiện tại không? | Đã có graphify-out/ từ tuần trước. Skill kiểm graph và cache dựng từ đâu, ở revision nào, rồi chỉ làm lại phần đã cũ. |
Đánh đổi chính: lần dựng đầu trên dự án lớn có thể chậm, tài liệu và ảnh được gửi cho provider model, và cạnh INFERRED cần đối chiếu với code trước khi bạn dựa vào.
Prompt mẫu (hiểu kiến trúc trước khi lập plan):
/ak-graphify <đường dẫn dự án>
Mục đích: nắm các module chính và phụ thuộc giữa chúng trước khi lập plan
tách module thanh toán. Chỉ code, không có docs hay ảnh cần gửi đi.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--mcp | Chỉ khai báo trong gợi ý đối số, không mô tả hành vi | 1.0.0 |
--report | Chỉ khai báo trong gợi ý đối số, không mô tả hành vi | 1.0.0 |
--watch | Tự dựng lại graph khi file thay đổi | 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ờ, 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-graphify: dựng graph tri thức từ code và tài liệu" 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-graphify". 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-graphify
