Trả lời nhanh: Khi cả đội cùng dùng agent, vấn đề lớn nhất không phải công cụ mà là code sinh ra mỗi người một kiểu. Cách xử lý gồm ba lớp đặt trong repo để ai cũng chịu chung ràng buộc: file quy ước dự án cho chuẩn code, skill dùng chung cho quy trình lặp lại, và quyền cùng hook cho hàng rào an toàn. Thêm một quy ước xã hội quan trọng: người gửi thay đổi chịu trách nhiệm về nó, dù ai viết ra cũng vậy.
Một người dùng agent thì mọi thứ đơn giản. Năm người cùng dùng, mỗi người một thói quen, thì sau vài tháng repo có năm phong cách khác nhau và không ai nhớ vì sao. Bài này nói cách đặt ràng buộc chung mà không biến nó thành gánh nặng.
Ba lớp đặt trong repo
File quy ước dự án chứa chuẩn code, cấu trúc thư mục và vùng cấm. Đây là lớp ai cũng chịu và nó quyết định code sinh ra có giống nhau hay không, theo bài CLAUDE.md.
Skill dùng chung chứa quy trình lặp lại của đội: cách dựng một màn hình theo mẫu, cách viết mô tả thay đổi, cách rà soát trước khi gộp. Cách quản lý ở quy mô đội nằm ở bài skill dùng chung.
Quyền và hook là hàng rào an toàn, đặt trong repo để mọi người cùng một mức bảo vệ, theo bài về cấu hình.
Nguyên tắc phân chia xuyên suốt: thứ gì làm sai gây hậu quả thì để trong repo, thứ gì là gu riêng thì để ngoài.
Tránh mỗi người một kiểu
Đây là vấn đề thật và nó tích tụ âm thầm. Bốn cách chặn:
- Chỉ một màn hình hoặc một mô đun làm mẫu trong file quy ước. Một câu tham chiếu tới mẫu có tác dụng hơn mười dòng mô tả trừu tượng.
- Để công cụ định dạng tự động lo phần hình thức. Đừng ghi quy ước về dấu nháy hay khoảng trắng vào file quy ước; hãy để công cụ tự làm và chạy nó trong hook sau mỗi lần sửa.
- Cấm thêm thư viện khi chưa hỏi. Không có dòng này thì sau vài tháng dự án có ba thư viện làm cùng một việc.
- Rà soát tập trung vào tính nhất quán, không chỉ vào đúng sai.
Quy ước xã hội quan trọng nhất
Người gửi thay đổi chịu trách nhiệm về thay đổi đó. Không có ngoại lệ cho việc agent viết ra.
Nghe hiển nhiên nhưng nó cần được nói rõ, vì có một xu hướng tự nhiên là giải thích các lỗi bằng câu công cụ viết vậy. Khi điều đó thành thói quen, chất lượng xem lại tụt xuống rất nhanh.
Hai hệ quả thực dụng của quy ước này:
- Bạn phải hiểu code mình gửi. Nếu không giải thích được vì sao một đoạn được viết như vậy, đừng gửi.
- Phần mô tả thay đổi phải do bạn duyệt. Agent soạn được bản nháp, nhưng bạn là người xác nhận nó đúng.
Với đội mới bắt đầu dùng agent, hãy nói rõ điều này ngay từ đầu. Nó định hình cách cả đội làm việc hơn bất kỳ cấu hình kỹ thuật nào.
Vài thói quen nên thống nhất
Không phải quy tắc cứng, chỉ là những thứ khi cả đội cùng làm thì mọi thứ trơn hơn:
- Mở phiên mới khi đổi việc. Vừa rẻ hơn vừa cho kết quả sát hơn.
- Bắt lập kế hoạch với việc đụng nhiều file. Bắt hiểu nhầm sớm, theo bài plan mode.
- Commit trước khi giao việc lớn. Có điểm quay lui.
- Làm trên nhánh riêng, nhất là khi chạy nhiều phiên song song.
- Chia sẻ lệnh tắt hữu ích vào repo thay vì giữ riêng.
Điểm cuối tạo ra hiệu ứng cộng dồn: một người viết một lệnh rà soát tốt thì cả đội dùng được, và chất lượng chung lên theo.
Bảo trì theo thời gian
Kho quy ước và skill của đội cũng cần dọn như mã nguồn. Ba việc hằng quý:
- Xóa phần đã sai. Quy ước cho một công cụ không còn dùng là thông tin sai, và thông tin sai hại hơn không có gì.
- Gộp phần trùng lặp. Hai skill cùng nói về một việc thì giữ cái tốt hơn.
- Kiểm tra file quy ước còn ngắn không. Vượt một trăm dòng thì tách phần quy trình sang skill.
Với đội đông, nên có một người chịu trách nhiệm cho kho này, giống vai trò người giữ tài liệu kiến trúc. Không cần chức danh, chỉ cần một người để hỏi khi phân vân nên đặt một quy ước mới ở đâu.
Và nếu đội chạy nhiều phiên agent song song, hãy tính tới việc đặt chúng trên một máy chung thay vì trên từng laptop, theo bài thiết kế đội subagent.
Ba lớp cấu hình và ai sở hữu lớp nào
| Lớp | Đặt ở đâu | Ai quyết định |
|---|---|---|
| Ràng buộc kỹ thuật của dự án | Trong kho mã, đi qua yêu cầu gộp mã | Cả đội thống nhất |
| Quy trình riêng của một nhóm nhỏ | Thư mục con của phần nhóm đó phụ trách | Nhóm đó tự quyết |
| Sở thích cá nhân về cách trình bày | Cấu hình riêng trên máy từng người | Từng người tự quyết, không đưa vào kho mã |
Nhầm lớp là nguyên nhân của hầu hết tranh cãi. Sở thích cá nhân lọt vào kho mã sẽ bị người khác sửa lại, còn ràng buộc kỹ thuật nằm trên máy cá nhân thì người mới vào không có.
Quy ước xã hội quan trọng hơn quy ước kỹ thuật
- Người mở yêu cầu gộp mã chịu trách nhiệm cho mã đó, bất kể ai hay công cụ nào viết ra. Không có ngoại lệ cho mã sinh tự động.
- Ghi rõ trong mô tả phần nào được sinh tự động, để người xem lại biết soi kỹ chỗ nào.
- Không gộp mã mà chính bạn không giải thích được. Đây là quy ước có giá trị nhất và cũng hay bị phá nhất.
Giữ tệp luật chung không phình ra
# Tep luat chung cua du an nen duoi mot man hinh cuon # Moi dong phai tra loi duoc: bo dong nay di thi hong gi# Neu khong tra loi duoc thi do la so thich, khong phai luat # Xem lai moi quy:# - bo luat da het hieu luc vi du an doi huong# - bo luat chua ai vi pham bao gio, no khong con la rang buoc that# - gop cac dong noi cung mot y # Coi tep luat nhu ma nguon:git log --oneline -- CLAUDE.md# Neu mot thang khong ai sua thi hoac no rat tot, hoac khong ai doc noQuy ước của đội hỏng dần thế nào
Quy ước của đội hỏng dần theo cách rất giống nhau: có người vội nên bỏ qua một bước, không ai nói gì, lần sau thêm người bỏ qua. Cách chống hiệu quả nhất không phải là thêm luật mà là đặt một buổi mười lăm phút mỗi tháng để cả đội xem lại đúng ba câu hỏi: luật nào đang bị bỏ qua, luật nào không còn cần, và có việc gì lặp lại nhiều lần mà chưa có quy ước.
Câu hỏi thường gặp
Làm sao để code sinh ra giống nhau giữa các thành viên?
Đặt file quy ước trong repo, chỉ một mô đun làm mẫu, để công cụ định dạng tự động lo phần hình thức, và cấm thêm thư viện khi chưa hỏi. Bốn việc đó giải quyết phần lớn sự khác biệt.
Ai chịu trách nhiệm khi code do agent viết có lỗi?
Người gửi thay đổi. Đây là quy ước cần nói rõ ngay từ đầu, vì nếu chấp nhận lời giải thích rằng công cụ viết vậy thì chất lượng xem lại sẽ tụt rất nhanh.
Có nên bắt cả đội dùng cùng một cấu hình không?
Chỉ phần ảnh hưởng tới kết quả: quy ước code, quyền, hook, skill chung. Sở thích trình bày và công cụ cá nhân thì để mỗi người tự quyết, ép vào chỉ gây khó chịu mà không được gì.
Đội bao nhiêu người thì cần quy ước chung?
Từ hai người trở lên đã nên có file quy ước trong repo. Từ năm người thì nên thêm skill dùng chung và một người chịu trách nhiệm bảo trì kho quy ước đó.