Khi cả đội đều dùng agent: luật trong đầu một người không đủ cho cả đội

Mọi thứ bạn học cho riêng mình rạn ra khi ba người, ba con agent cùng đụng một chỗ — vì mỗi agent chỉ đọc được luật của chủ nó

Đọc6 phút đọc
Chủ đềlam-viec-nhom · quy-uoc · review
TL;DR

Lời khuyên "làm việc với agent" thường ngầm giả định một người. Khi cả đội đều dùng agent trên cùng một chỗ chung, ba vấn đề mới hiện ra mà người-một-mình không bao giờ gặp: quy ước phân kỳ (mỗi agent một luật trong đầu chủ nó), trách nhiệm mờ (ai chịu cho cái agent viết ra), và tri thức ngầm không truyền được (người giỏi không nói ra được mình đang làm gì). Cú dịch là kéo cái luật ra khỏi đầu từng người và đặt vào một chỗ chung, viết ra, mà mọi agent đều đọc.

Ba người trong đội, ba con agent, một codebase chung. Sáng thứ Hai bạn mở lên: mọi thứ chạy được, test xanh. Nhưng đọc kỹ thì nó như ba người xa lạ cùng viết — chỗ này một kiểu đặt tên, chỗ kia một kiểu xử lý lỗi, chỗ nọ một lối cấu trúc khác hẳn.

Mà đúng là ba người xa lạ thật. Không phải ba đồng nghiệp của bạn — họ hiểu nhau. Là ba con agent, mỗi con chạy theo cái luật nằm trong đầu của riêng chủ nó. Và ba cái đầu đó chưa bao giờ ngồi lại thống nhất với nhau điều gì.

01Lời khuyên cho một người rạn ra ở quy mô đội

Gần như mọi điều khôn ngoan về làm việc với agent — kể cả phần lớn cái garden này — đều ngầm hình dung một cảnh: bạn, một con agent, một việc. Bạn học cách ra lệnh cho nó, cách gài cổng, cách kèm nó. Tất cả đều đúng. Và tất cả đều sống trong đầu bạn.

Cái "sống trong đầu bạn" đó chính là chỗ rạn. Khi chỉ có mình bạn, một bộ quy ước trong đầu là đủ — bạn là người duy nhất ra lệnh, nên agent của bạn nhất quán theo bạn. Thêm người thứ hai với con agent của họ, và đột nhiên có hai bộ quy ước trong hai cái đầu, không cái nào biết cái nào. Mỗi con agent vẫn nhất quán — với chủ của nó. Nhưng cái chung, thứ cả ba cùng đụng vào, thì bắt đầu kéo về ba hướng.

Cú lật là chỗ này: ở quy mô đội, vấn đề không còn là "agent của tôi có làm tốt không". Là "agent của cả đội có kéo về cùng một hướng không". Một con agent giỏi gấp đôi mà kéo lệch hướng hai người kia chỉ làm cái chung rối nhanh gấp đôi.

Luật trong đầu từng người

Mỗi người mang một bộ quy ước riêng, không viết ra
Agent mỗi người đọc đúng luật của chủ — ba agent, ba kiểu
Cái chung kéo về ba hướng; càng nhiều agent càng phân kỳ nhanh

Luật nằm trong chỗ chung

Một bộ quy ước viết ra, nằm cùng chỗ với việc chung
Mọi agent đọc cùng một luật — bất kể chủ nó là ai
Cái chung kéo về một hướng; thêm người không thêm hỗn loạn

Khác biệt không phải "đội kỷ luật hơn". Là cái luật chuyển chỗ ở: từ trong đầu từng người — nơi không ai khác đọc được — sang một chỗ chung mà mọi agent đều với tới.

02Ba vấn đề chỉ hiện ra khi có đội

Khi từ một người thành một đội, ba thứ mới mọc lên. Chúng không phải phiên bản khó hơn của vấn đề cũ — chúng là vấn đề mới, chỉ tồn tại khi có nhiều người cộng nhiều agent.

1
Quy ước phân kỳ

Mỗi agent chạy theo luật trong đầu chủ nó. Không có bộ luật chung viết ra, ba agent sẽ đặt tên khác nhau, xử lý lỗi khác nhau, cấu trúc khác nhau — và cái chung rạn theo từng đường.

2
Trách nhiệm mờ

"Agent viết đấy chứ" không phải một cái cớ. Khi nửa số thay đổi là do agent đẻ ra, phải rõ ai là người đứng tên cho từng phần — vì con agent không chịu trách nhiệm được.

3
Tri thức ngầm kẹt lại

Người dùng agent giỏi biết việc nào nên giao, gài cổng ở đâu — nhưng cái biết đó nằm trong tay nghề, không nói ra. Đồng đội mới không thừa hưởng được, trừ khi nó được kéo ra thành cái dạy được.

Ba vấn đề, một gốc chung: cái từng đủ khi nằm trong đầu một người — quy ước, trách nhiệm, tay nghề — giờ phải được kéo ra ngoài và làm cho dùng chung được. Đội không hỏng vì thiếu người giỏi; nó hỏng vì cái giỏi không truyền sang nhau.

03Kéo cái luật ra khỏi đầu, đặt vào chỗ chung

Sợi chỉ chữa cho cả ba vấn đề trên là một: thứ gì từng sống trong đầu một người mà giờ cả đội cần, phải được viết ra và đặt vào chỗ chung. Không phải vì viết ra thì sang hơn — mà vì cái đầu thì không nhân bản được, còn một file thì mọi agent đều đọc được.

Quy ước phân kỳ chữa bằng một bộ luật chung, nằm cùng chỗ với việc, mà agent của mọi người cùng nạp. Trách nhiệm mờ chữa bằng một thói quen rõ: người bấm nút gộp là người đứng tên, "agent viết" không gỡ trách nhiệm đó. Tri thức ngầm chữa bằng cách biến cái tay nghề thành thứ dạy được — một lối vào để đồng đội mới đi theo, thay vì phải mò lại từ đầu cái bạn đã mò.

Đây cũng là chỗ cụm Đồ nghề & thiết lập lớn thêm một bậc: ở đó, CLAUDE.md là bộ luật sống cho agent của bạn; ở đây, nó thành bộ luật sống cho agent của cả đội — cùng một ý tưởng, nhưng giờ nó phải sống trong chỗ chung, được review như code, và đủ rõ để một người chưa từng ngồi cạnh bạn vẫn theo được.

04Cái giỏi của một người không tự thành cái giỏi của đội

Một người dùng agent cực giỏi không tự động làm cả đội giỏi theo. Cái giỏi đó, chừng nào còn nằm trong đầu anh ta, vẫn là tài sản của một người — và nó tan biến đúng cái ngày anh ta nghỉ phép, hoặc khi người thứ tư vào mà không ai kịp truyền lại.

Cái cần nhớ gọn trong một câu: khi cả đội đều dùng agent, thứ phải nhất quán không phải là con người — là cái luật họ cùng cho agent đọc. Người thì mỗi người một kiểu, và thế cũng được. Nhưng cái chung mà ba con agent cùng đụng vào thì phải kéo về một hướng — và hướng đó chỉ tồn tại khi nó được viết ra một chỗ, không phải nằm rải trong ba cái đầu chưa từng nói chuyện với nhau.


Ba mặt của làm việc nhóm với agent, mỗi mặt một bài: một bộ luật chung cho mọi agent · ai chịu trách nhiệm cho code agent viết · đưa đồng đội mới vào guồng agent.

c
Người viết

Mỗi câu chuyện ở đây gói một bài học đã trả giá để học.

craftagentmột người vừa xây vừa học

Bạn đang xây gì với agent? Muốn trao đổi, phản biện, hay cùng làm một thứ gì đó — viết cho mình một dòng.

56bài12cụmVI·ENsong ngữ

Nhận bài mới qua email

Ghi chép thực chiến về làm việc với AI agent — thi thoảng, không spam.