Tóm tắt nhanh:
ak-teamdựng một Agent Team của runtime: một lead chia việc, nhiều teammate chạy song song, mỗi người có context riêng và nhắn tin trực tiếp với nhau. Lead gộp kết quả, tự kiểm lại rồi báo bạn và chuyển sangak-journal. Runtime không có tính năng team thì nó dừng và báo lỗi, không lặng lẽ đổi sang subagent thườ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 có một việc lớn chia được thành nhiều luồng độc lập: từ 3 luồng trở lên, hoặc nhiều giả thuyết cần tranh luận. Không cần cho việc nhỏ hoặc tuần tự như một lượt lint hay một chuỗi plan rồi code rồi test: dùng subagent thường.
flowchart LR
A["Việc lớn, chia được nhiều luồng độc lập"] --> B["ak-team"]
X["Việc nhỏ hoặc tuần tự"] --> Y["Subagent thường"]
B --> C["Báo cáo tổng hợp hoặc code đã gộp và kiểm"]
C --> D["ak-journal"]
B --> E["Dừng: runtime không có tính năng team"]Trước mỗi team, bạn cần rõ 4 điều:
| Điều | Câu hỏi | Ví dụ |
|---|---|---|
| Mẫu làm việc | Team này làm loại việc gì? | research, cook, review hoặc debug |
| Quyền sở hữu file | Ai được sửa file nào? | Dev 1 giữ src/api/*, dev 2 giữ src/ui/*, tester chỉ giữ file test |
| Vai trò của lead | Ai chia việc, gộp kết quả và chịu trách nhiệm câu trả lời cuối? | Teammate báo "xong", lead vẫn đọc báo cáo và chạy test chung |
| Team hay subagent thường | Việc này có đáng dựng cả một team không? | Từ 3 luồng độc lập trở lên thì dùng team |
Teammate đang idle nghĩa là đang chờ, chưa phải đã xong. Lead nhìn trạng thái việc chung và tin nhắn, không đoán theo chuyện ai đang im lặng.
Prompt mẫu cho triển khai song song từ plan:
/ak-team cook plans/<tên plan>/plan.md --devs 2 --worktree --plan-approval
Ràng buộc: dev 1 chỉ sửa src/api/*, dev 2 chỉ sửa src/ui/*.
Xong khi: test chung pass sau khi gộp cả hai phần.| Cờ | Để làm gì | Từ ak |
|---|---|---|
--devs, --researchers, --reviewers, --debuggers | Đặt số người trong team | 1.0.0 |
--delegate | Lead chỉ điều phối, không tự làm | 1.0.0 |
--plan-approval, --no-plan-approval | Bật hoặc tắt bước duyệt plan trước khi sửa code | 1.0.0 |
--worktree | Mỗi teammate viết code trong worktree riêng | 1.0.0 |
Phần dưới đây là bản chi tiết: luồng chạy, 5 tình huống thật 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-team: dựng team agent chạy song song cho việc lớ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-team". 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-team
