Tóm tắt nhanh:
ak-orchestratebiến một việc nhiều phần thành các job có thứ tự, chạy mỗi job thành một session độc lập, theo dõi và lưu lại để chạy tiếp được. Một trọng tài kiểm mọi kết quả rồi ghireport.md, diff chờ bạn tích hợp. Nó không tự gộp diff vào nhánh của bạn, và mặc định không dùng runtime nào ngoài runtime bạn đang chạy.
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 việc có nhiều phần làm riêng được: vài scout đọc code song song, hai job sửa hai module, một job review. Không cần cho một lần đọc code đơn giản: chia việc ra không đem lại gì thì skill khuyên làm thẳng trong một session.
flowchart LR
A["Việc lớn, nhiều phần độc lập"] --> B["ak-orchestrate"]
B --> C["Các session chạy theo stage"]
C --> D["Trọng tài C3 kiểm"]
D --> E["report.md và diff chờ tích hợp"]
B --> F["Làm thẳng một session nếu không đáng"]
D --> G["fail hoặc blocked: nói rõ lý do"]Mỗi lần chạy, nó trả lời 4 câu hỏi:
| Phần | Câu hỏi | Ví dụ |
|---|---|---|
| Phạm vi runtime | Job được phép chạy ở đâu? | Mặc định là session của runtime hiện tại; muốn Pi thì nêu tên, muốn mọi runtime thì thêm --cross-runtime |
| Tầng năng lực và tầng rủi ro | Job cần model mạnh cỡ nào, cần kiểm soát gì? | Scout là C1/R0, implement quan trọng là C3/R2, deploy hay xoá dữ liệu là R3 cần bạn duyệt |
| Worktree cho job ghi song song | Hai job cùng sửa code một lúc thì sao? | Mỗi job một worktree, một nhánh riêng; cùng sửa lockfile hay migration thì chạy lần lượt |
| Trọng tài | Ai kiểm kết quả trước khi báo xong? | Một session mới trên model mạnh nhất, so với expected_output, chạy check; thiếu artifact thì không pass |
Lưu ý quan trọng nhất: báo cáo của session chỉ là lời khai. Job chỉ được nhận khi artifact và check được kiểm, và trong một run đã chuẩn bị, job không bao giờ đổi runtime hay model.
Prompt mẫu cho nghiên cứu song song:
/ak-orchestrate Nghiên cứu 3 cách làm cache cho API của <tên dự án> rồi so sánh.
Kết quả: một báo cáo so sánh, mỗi nhận định có dẫn chứng từ code.
Ràng buộc: chỉ đọc, không sửa file nào.
Xong khi: trọng tài đối chiếu 3 báo cáo và loại nhận định không có bằng chứng.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--resume | Chạy tiếp một lần chạy bị ngắt | 1.0.0 |
--yes | Ghi nhận sự cho phép của bạn cho lần chạy | 1.0.0 |
--cross-runtime | Cho phép dùng runtime khác ngoài runtime hiện tại | 3.0.0-beta.33 |
--internal | Cờ cũ, đã bỏ | 1.1.0 |
Phần dưới đây là bản chi tiết: luồng chạy và thang dự phòng khi job lỗi, 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-orchestrate: chia việc thành nhiều session có trọng tài duyệt" 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-orchestrate". 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-orchestrate
