Chạy nhiều AI agent sửa code song song trên cùng một repo: DeepSeek Harness AgentTeam + Git Worktree
Cách tôi dùng DeepSeek Harness (DSH) lúc nào cũng vấp cùng một vấn đề: một session chỉ làm được một module theo trình tự; mở hai session để chạy song song thì cả hai dùng chung một thư mục làm việc, git status lẫn vào nhau, muốn biết ai sửa file nào trước khi merge phải mò tay. Nên tôi muốn xác nhận một điều: tách việc và cô lập file ra riêng, có đứng vững được không.
Bản pre-release 0.2.2 có đúng hai plugin thử nghiệm cho hai nửa vấn đề đó — AgentTeam lo phân việc, Change Requests & Worktrees lo cô lập. Tôi giữ máy ở 0.2.2-rc.1, dựng một repo test riêng và cho hai sub-agent chạy song song trên hai module, từ đầu đến cuối.
Kết luận ngắn (ngày kiểm chứng 2026-11-17, phiên bản 0.2.2-rc.1): kết hợp này hoạt động, nhưng không phải mở lên là chạy. AgentTeam giao việc cho các teammate có tên; git worktree cho mỗi teammate một thư mục checkout và một branch riêng. Hai thứ bổ trợ nhau rất tự nhiên, nhưng trong bản pre-release chúng không tự nối với nhau — bạn phải ghi rõ việc tạo worktree trong prompt, còn commit và dọn dẹp là việc của bạn.
Đối tượng phù hợp ngay lúc này:
- Nên nâng cấp nếu bạn đã dùng DSH cho công việc hằng ngày, muốn nhiều sub-agent sửa các module khác nhau song song và chịu quản git.
- Chưa cần nếu chỉ muốn thử multi-agent trò chuyện hay giao việc điều tra — plugin đang dán nhãn thử nghiệm, API có thể đổi giữa các RC.
- Chưa nên nếu dùng Windows và không muốn xử sandbox — có một cạm bẫy quyền ghi ở dưới.
- Đừng dùng trên repo production — cả hai plugin đều đang thử nghiệm.
Vì sao nhiều session dùng chung một checkout sẽ đụng nhau
Đây là vấn đề của git chứ không phải của AI. Một thư mục checkout chỉ có một trạng thái working tree và một index. Hai tiến trình cùng sửa file trong một thư mục thì git status hiển thị hai đống thay đổi trộn lẫn vào nhau; nếu hai bên cùng sửa một file, bản lưu trước bị bản lưu sau ghi đè, không có bất kỳ cảnh báo nào. Nhiều agent dùng chung một checkout cũng y như hai kỹ sư giành cùng một thư mục trên cùng một máy.
git giải quyết chuyện này từ lâu: git worktree cho phép một repo gắn nhiều thư mục checkout, mỗi thư mục một branch, một index riêng. Va chạm trở nên bất khả thi về mặt vật lý. Đó chính là mảnh ghép mà plugin worktree của DSH đưa vào sidebar của session — và trùng khớp với lời chính chủ trong tài liệu AgentTeams: thành viên có thể dùng chung checkout, nên đường dẫn output hay worktree độc lập vẫn quan trọng.
Hai plugin này quản lý gì
- AgentTeam — quyết định ai làm gì. Session trở thành trưởng nhóm: chẻ mục tiêu thành các task có tên, kéo teammate lên, theo dõi trên bảng chung, teammate nhắn tin cho nhau, cuối cùng trưởng nhóm tổng hợp lại cho bạn.
- Change Requests & Work Trees — quyết định làm ở đâu. Sidebar theo dõi PR liên quan và thay đổi cục bộ, cô lập từng task trong worktree riêng.
Một cái lo phân việc, một cái lo cô lập file. Thiếu một trong hai là cả hệ thống khập khiễng.
Chuẩn bị: phiên bản, plugin, model và một cạm bẫy trên Windows
Máy tôi đã ở 0.2.2-rc.1 từ trước nên không nâng cấp lại lần nữa — số phiên bản hiện ở cuối trang cài đặt. Một quan sát: bước kiểm tra cập nhật lúc khởi động đã thấy 0.2.2-rc.3, kênh pre-release nhảy rất nhanh, đừng coi một RC bất kỳ là bản ổn định. Trong phần cài đặt không có công tắc "kênh dev/cập nhật" — chọn kênh bằng chính file cài đặt bạn chạy.

Bước một, bật cả hai công tắc plugin trong mục plugin thử nghiệm, mặc định đang tắt.

Bước hai, tạo session và chọn model. Tôi đi qua gateway Crazyrouter với deepseek-v4-flash. Base URL của nhà cung cấp chỉ cần một giá trị:
https://api.crazyrouter.com/v1
Kiểm chứng trước khi làm việc: request tới /v1/models trả về HTTP 200 với 173 model, deepseek-v4-flash có trong danh sách. Muốn tự kiểm tra tính khả dụng của model, xem danh mục model; trước khi bắt tay vào việc thì lướt qua danh mục model và điều kiện tính phí của gateway — điều kiện truy cập và model ID đều theo danh mục đó.
Bước ba, chọn chế độ truy cập — và đây là chỗ buổi test suýt chết. Chế độ mặc định "chỉ sửa trong workspace" không xin được quyền ghi (ACL) trên Windows của tôi: session kẹt ở 3% hơn mười phút, model tự chẩn đoán đây là vấn đề sandbox đã biết trên Windows. Tôi loại trừ filesystem trước — cả C: và D: đều NTFS, tức là hỗ trợ ACL; điểm kẹt nằm ở bước sandbox cấp quyền. Chuyển sang "toàn quyền" và xác nhận dialog thì mọi thao tác ghi trở lại bình thường. Cái giá là các thao tác nhạy cảm mất bước xác nhận, chỉ dùng chế độ này với task bạn tin tưởng. Nói thêm cho trung thực: prompt tôi gửi cho session viết bằng tiếng Trung; repo, code và test không phụ thuộc ngôn ngữ.

Thực tế: hai teammate, hai worktree
Repo test là repo public tôi dựng riêng: ba module độc lập — textutil, mathutil, datefmt — với điểm xuất phát là 8 test toàn fail. Task chỉ làm hai module, quy luật cố định ngay từ đầu:
- Teammate A nhận
textutil, branchfeature/textutil - Teammate B nhận
mathutil, branchfeature/mathutil - Mỗi bên tự
git worktree addmột worktree riêng, chỉ sửa file của mình - Không đụng bên kia, không merge, không push
Gửi task xong, agent chính xác nhận trạng thái repo, tạo task chung, rồi kéo hai teammate lên chạy song song. Header session hiện "2 sub-agent", bảng nhiệm vụ ở sidebar bắt đầu nhảy số.

Worktree có thật và riêng biệt: git worktree list thêm hai dòng — wt-textutil trên feature/textutil, wt-mathutil trên feature/mathutil — còn repo chính sạch suốt buổi. Tôi vào từng thư mục kiểm tra: mỗi bên chỉ có đúng file nguồn của mình bị sửa, không giao nhau. Chạy node --test riêng từng nơi, cả hai đều 3 pass 0 fail.
Bước commit là chỗ thấy rõ ranh giới. Teammate textutil tự commit, dưới đúng tên của nó (textutil-dev, short hash f650772, message gọn gàng). Teammate mathutil sửa xong, test qua, file staged — rồi dừng ở đó. Agent chính đang bận đợi report, hai tin nhắn tôi xếp hàng không gửi vào được. Tôi dừng lượt đang kẹt rồi tự vào wt-mathutil commit. Đó là ý của "tự dọn phần cuối": trong giao thức AgentTeam không có mục nào yêu cầu công việc phải thành git commit. Teammate đi được tới đâu tùy nó, còn branch sạch hay không là việc bạn phải tự kiểm.
Review lại là phần rẻ nhất của cả hệ thống. Một branch, một commit, một file — git show --stat đọc mỗi thứ trong một liếc mắt, không phải lục diff lẫn lộn. Tôi đưa một nhận xét review thật (hàm clamp không định nghĩa hành vi khi min > max), commit bản sửa trong wt-mathutil, chạy lại test: vẫn 3 pass 0 fail.
Lưu trữ: git worktree remove xóa hai thư mục, danh sách worktree co về còn repo chính, hai branch cùng commit nguyên vẹn. 8 test ở repo chính vẫn đỏ — đúng như tôi muốn: không có gì rò vào main trong thời gian cô lập, thời điểm merge hoàn toàn do tôi quyết.
Cái gì tự động, cái gì phải tự dọn
| Hạng mục | Kết quả thực tế | Tự động? |
|---|---|---|
| Chẻ task, kéo teammate, bảng nhiệm vụ | Chạy song song, bảng cập nhật liên tục | Tự động |
| Cô lập thư mục (worktree) | Hai teammate tự tạo riêng, không giao nhau | Bán tự động, phải ghi rõ trong prompt mới tạo |
| Chạy test | Mỗi bên tự chạy tới khi qua | Tự động |
| Git commit | Một teammate commit, một bên dừng ở staged | Không đảm bảo, phải tự dọn |
| Review theo branch | Một branch một commit một file, chi phí thấp thật | Nhờ hình dạng, không nhờ công cụ |
| Cập nhật branch sau review | Tôi nhận xét, commit sửa, test vẫn qua | Thủ công |
| Lưu trữ và dọn dẹp | Branch và commit giữ nguyên, thư mục worktree không tự xóa | Thủ công git worktree remove |
| Quyền ghi trên Windows | Chế độ mặc định xin ACL thất bại, toàn quyền bình thường | Cạm bẫy, phải tự xử |
Tính thời gian cho trung thực: từ gửi task tới khi hai module qua hết test, hai teammate mất hơn mười phút; cả session tính cả lượt agent chính bị kẹt là hơn hai mươi phút — chậm hơn tôi tự làm tuần tự. Cái song song mua được không phải thời gian đồng hồ mà là không phải canh chừng: chẻ việc, phân việc, theo dõi thuộc về trưởng nhóm, bạn chỉ xuất hiện lúc review và dọn dẹp. Module nhiều hơn thì khoảng cách này mới mở ra theo hướng có lợi.
Câu hỏi thường gặp
Teammate có làm bừa repo chính không? Không. Suốt buổi, git status của repo chính sạch, main đứng ở commit khởi tạo, 8 test đỏ nguyên vẹn — không có gì rò qua. Điều kiện là ghi rõ "không merge, không push" trong prompt.
Teammate có tự commit không? Có thể, dưới danh tính git có tên (bên quan sát được là textutil-dev dạng địa chỉ cục bộ), nhưng hành động commit không được đảm bảo — bên mathutil dừng ở staged. Phần dọn cuối là của bạn.
Nâng cấp có mất cấu hình không? Tôi không thực hiện nâng cấp nên không có kết quả kiểm chứng. Chỉ quan sát được bước kiểm tra cập nhật đã có rc.3, còn tài liệu plugin ghi rõ API có thể đổi giữa các RC; trước khi nâng cấp nên chụp lại cấu hình plugin.
Kẹt ở 3% thì làm gì? Xem chế độ truy cập trước. ACL của sandbox thất bại dưới chế độ mặc định y hệt một cục kẹt 0–3% kéo dài; chuyển "toàn quyền" là phục hồi ngay. Sau đó xác nhận ổ đĩa đều NTFS để loại trừ chuyện filesystem không hỗ trợ ACL.
Ai muốn tái hiện: repo test public ở zhouxiaoying416-sketch/dsh-agentteam-worktree-demo — ba module, ba file test, clone về là 8 test đỏ. Model đi qua gateway với tên deepseek-v4-flash, endpoint /v1/chat/completions; model ID theo danh mục của gateway.
Bộ kết hợp này tôi sẽ tiếp tục dùng, nhưng chỉ cho đúng một kịch bản nó đã chứng minh: refactor song song nhiều module. Việc một file một module thì mở một session thường sẽ nhanh và gọn hơn. Cả hai plugin đều dán nhãn thử nghiệm và API có thể đổi giữa các RC — với repo production, đợi bản ổn định.
All rights reserved