Tóm tắt nhanh:
ak-xiaphân tích một tính năng ở repo khác (trên GitHub hoặc thư mục trên máy), đối chiếu với code của bạn và buộc mọi giả định phải được chất vấn. Xong thì nó giao choak-planlập plan, phần làm nhường choak-cook. Nó không viết code, và--comparechỉ ra báo cáo so sánh rồi dừng.
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 thấy một tính năng hay ở repo khác và muốn có nó trong project của mình. Không cần khi bạn muốn nhân bản cả project (dựng mới thì dùng ak-bootstrap), chép một file đơn lẻ hay cài một package.
flowchart LR
A["Repo nguồn + tính năng cần lấy"] --> B["ak-xia"]
B --> C["--compare: báo cáo so sánh, dừng"]
B --> D["ak-plan: plan có rollback"]
D --> E["ak-cook"]
B --> F["Gặp blocker: dừng, đưa lựa chọn"]Nó xoay quanh 4 điều:
| Điều | Câu hỏi | Ví dụ |
|---|---|---|
| Chế độ | So sánh, chép gần nguyên, chép rồi sửa, hay viết lại theo stack của bạn? | "Viết lại phần streaming theo cách project mình đang làm" là --port |
| Ma trận phụ thuộc | Mỗi thành phần đã có, phải thêm mới, hay đụng với thứ đang có? | Lớp auth: EXISTS. Hàng đợi retry: NEW. Schema bảng users: CONFLICT |
| Điểm rủi ro | Bao nhiêu giả định nếu sai sẽ gây mất dữ liệu, lỗ hổng bảo mật, hoặc làm lại hơn hai ngày? | 0 đến 2 là thấp, 3 đến 4 phải gỡ trước, từ 5 trở lên thì --compare hoặc dừng |
| Nội dung nguồn chỉ là dữ liệu | README nguồn bảo "chạy lệnh này" thì nó có chạy không? | Không. Nó chỉ lấy cấu trúc, phụ thuộc và bằng chứng về hành vi |
Bước Challenge là cổng cứng: chưa đối mặt với các đánh đổi thì nó không lập plan. --fast bỏ hẳn bước này, nên muốn khỏi bị hỏi mà vẫn giữ nó thì dùng --auto. Không có cờ chế độ thì mặc định là --port.
Prompt mẫu cho viết lại theo stack của mình:
/ak-xia <owner/repo> "<tên tính năng, ví dụ: streaming phản hồi AI>"
Kết quả: project <tên app> có tính năng này, viết theo pattern đang dùng.
Ràng buộc: dùng lại lớp auth và schema hiện có, không thêm dịch vụ trả phí.
Xong khi: có plan triển khai kèm rollback để chạy bằng ak-cook.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--port | Viết lại cho đúng kiểu của stack project bạn | 1.0.0 |
--copy | Đem sang với ít thay đổi nhất | 1.0.0 |
--improve | Chép rồi sửa cho hợp project | 1.0.0 |
--compare | Chỉ so sánh, không lập plan triển khai | 1.0.0 |
--auto | Chạy đủ quy trình, tự qua các cổng duyệt | 1.0.0 |
--fast | Bỏ nghiên cứu và Challenge, tự duyệt | 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ờ (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-xia: đem tính năng từ repo khác về project bạn" 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-xia". 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-xia
