Tóm tắt nhanh:
ak-planđọc code thật rồi chia một việc đã rõ thành thư mục plan:plan.mdvà các file phase, mỗi phase có file đụng tới, bước làm và cách kiểm. Xong, nó báo đường dẫn plan và đề xuất chạyak-cook. Nó không viết code.
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 đã biết mình muốn làm gì và cần chia thành các bước làm được, kiểm được. Có thể đưa thẳng yêu cầu đã rõ, hoặc kết quả của ak-brainstorm.
flowchart LR
A["Yêu cầu đã rõ hoặc kết quả ak-brainstorm"] --> B["ak-plan"]
B --> C["plan.md và các file phase"]
C --> D["ak-plan validate hoặc red-team"]
C --> E["ak-cook"]
D --> EBốn điều cốt lõi:
| Điều | Câu hỏi | Ví dụ |
|---|---|---|
| Plan là các file | Plan nằm ở đâu, và đâu là bản chính? | plan.md làm mục lục, cạnh đó là các file phase. Chỉ mục của ak plan chỉ là bản dựng lại được |
| Chế độ | Plan cần sâu tới đâu? | Không cờ thì tự chọn. --fast bỏ research, --hard thêm research, red-team, validate |
| Phạm vi | Plan có được tự cắt bớt việc bạn yêu cầu không? | Không. Muốn cắt thì thêm --yagni hoặc nói rõ bỏ mục nào |
| Cổng kiểm | Plan đã đủ tin để bắt đầu code chưa? | validate đối chiếu plan với code thật, Failed: 0 thì đủ điều kiện cook |
Mỗi lần chỉ được một cờ chế độ: truyền hai cờ thì skill dừng và nêu tên cả hai. Ngoài viết plan mới, có ba lệnh con cho plan đã có: validate, red-team và archive (đóng plan trong chỉ mục, không xoá file).
Prompt mẫu cho tính năng mới:
/ak-plan Thêm xuất hoá đơn PDF cho trang đơn hàng của <tên app>.
Kết quả: người dùng bấm "Tải hoá đơn" và nhận file PDF đúng số liệu đơn.
Ràng buộc: không đổi schema bảng orders, dùng thư viện PDF đang có nếu có.
Không làm: gửi hoá đơn qua email.
Xong khi: có test cho nội dung PDF và nút tải chạy trên trang chi tiết đơn.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--fast | Plan nhanh, không research | 1.0.0 |
--hard | Research, scout, red-team, validate | 1.0.0 |
--deep | Scout theo từng phase cho thay đổi lớn | 1.0.0 |
--parallel | Phase chạy song song, file không trùng | 1.0.0 |
--two | So hai kiến trúc, bạn chọn một | 1.0.0 |
--debate | 3 plan độc lập, gộp thành một | 2.13.0 |
--ultra | 5 plan độc lập, chọn bản tốt nhất | 2.13.0 |
--auto | Tự chọn chế độ | 1.0.0 |
--tdd | Test viết trước trong mỗi phase | 1.0.0 |
--no-tasks | Không đồng bộ phase sang danh sách task | 1.0.0 |
--html | Plan dạng trang HTML để đọc | 1.0.0 |
--ak-render | Dựng plan.html bằng AK Render | 3.0.0-beta.5 |
--github | Tạo hoặc cập nhật issue GitHub cho plan | 1.0.0 |
--wiki | Đăng plan lên AgentWiki | 1.0.0 |
--advice | Giám sát bởi kongming, plan cho model yếu hơn chạy | 2.5.0 |
--yagni | Cắt phần không cần cho kết quả | 2.8.0 |
--skip-journal | Không ghi journal tự động | 2.9.0 |
--no-antv, --no-diagram-design, --no-editorial-visuals | Tắt lớp hình minh hoạ trong plan.html | 2.13.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-plan: chia việc đã rõ thành plan nhiều phase" 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-plan". 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-plan
