Trả lời nhanh: Đưa một AI agent vào dự án đang chạy thật khác hẳn thử nghiệm trên dự án cá nhân, vì mọi sai sót đều chạm tới khách hàng. Lộ trình an toàn theo tuần: tuần một chỉ đọc để vẽ bản đồ hệ thống, tuần hai dựng ba lớp an toàn gồm quy ước, quyền và hàng rào, tuần ba sửa những chỗ ít rủi ro nhất, và từ tuần bốn mở dần phạm vi. Ba việc tuyệt đối không giao trong tháng đầu: đổi cấu trúc database, sửa luồng thanh toán, và triển khai tự động.
Bài cuối của loạt này gom lại mọi thứ đã bàn thành một danh mục dùng được ngay. Nó dành cho tình huống phổ biến nhất: bạn muốn dùng agent trong một dự án đang phục vụ khách, và không muốn tuần đầu tiên trở thành một câu chuyện để kể lại.
Trước khi bắt đầu
Bốn điều kiện cần, kiểm tra đủ rồi hãy đi tiếp:
- Mã nguồn nằm trong Git và nhánh chính sạch.
- Có bản sao lưu database đã kiểm chứng, tức là bạn đã thử khôi phục nó ra một nơi khác, theo bài về chu kỳ sao lưu.
- Có danh sách luồng chính phải chạy được, viết ra giấy, để làm bộ kiểm thử thủ công.
- Có môi trường thử, dù đơn giản, theo bài máy chủ thử nghiệm.
Bốn thứ này không liên quan gì tới AI, chúng là điều kiện của mọi thay đổi an toàn. Nếu dự án của bạn thiếu, hãy làm chúng trước, và đó cũng là việc đáng làm dù bạn có dùng agent hay không.
Tuần một: chỉ đọc
Không cho sửa gì trong tuần đầu. Bốn việc chỉ đọc mà giá trị cao nhất:
- Vẽ bản đồ hệ thống và lưu vào tài liệu trong repo: các mô đun chính, luồng dữ liệu, những chỗ trông như phần lõi.
- Tìm chỗ nguy hiểm: chuỗi bí mật trong mã nguồn, chỗ nhận dữ liệu người dùng mà không kiểm tra, truy vấn ghép chuỗi.
- Liệt kê code chết để thu hẹp phạm vi bạn phải hiểu.
- Giải thích những đoạn khó hiểu mà bạn sắp phải đụng tới.
Kết quả tuần này là một bản đồ và một danh sách rủi ro. Cả hai đều đáng giá hơn bất kỳ dòng code nào, và chúng còn giúp bạn viết file quy ước ở tuần sau cho sát thực tế.
Tuần hai: ba lớp an toàn
Lớp một, file quy ước dự án. Chuẩn code, cấu trúc thư mục, và quan trọng nhất là vùng cấm. Giữ dưới một trăm dòng, theo bài CLAUDE.md.
Lớp hai, danh sách quyền. Bắt đầu chặt: chỉ cho phép vài lệnh đọc, rồi thêm dần những lệnh bạn thật sự dùng hằng ngày, theo bài về quyền.
Lớp ba, hàng rào chạy bằng mã. Hook chặn những lệnh không bao giờ được xảy ra: xóa đệ quy, đẩy code lên nhánh chính, lệnh chạm tới database sản xuất. Xem bài về hooks.
Ba lớp này mất một buổi và chúng là phần bảo vệ chính. Đừng bỏ qua lớp thứ ba với lý do đã có luật rồi: luật là lời khuyên, hàng rào mới là ràng buộc.
Tuần ba và bốn: mở dần
Tuần ba, sửa những chỗ ít rủi ro nhất. Tiêu chí chọn: ít người dùng chạm tới, dễ kiểm chứng, không đụng tới tiền. Một trang báo cáo nội bộ là ví dụ tốt.
Quy trình cho mỗi lần: tạo nhánh riêng, yêu cầu viết kiểm thử cho hành vi hiện tại, sửa, chạy lại kiểm thử cộng danh sách luồng chính, triển khai vào giờ vắng khách.
Tuần bốn trở đi, mở dần theo mức tin tưởng. Thêm việc, thêm quyền, nhưng luôn theo một nguyên tắc: chỉ mở rộng khi lần trước đã trơn tru. Nếu tuần vừa rồi có sự cố, hãy dừng lại ở mức hiện tại thêm một tuần.
Song song, dựng dần bộ kiểm thử theo thứ tự mức thiệt hại: phần tính tiền trước, rồi xác thực và phân quyền, rồi các luồng chính.
Ba việc không giao trong tháng đầu
Đổi cấu trúc database. Không quay lui được như code, và dữ liệu thật thì không có bản nháp. Chờ tới khi bạn hiểu rõ hệ thống và có kiểm thử che phần liên quan, theo bài thiết kế database.
Sửa luồng thanh toán. Ngay cả khi nó đang có lỗi. Đây là chỗ sai một lần là mất tiền thật và mất niềm tin của khách.
Triển khai tự động. Đừng cho agent chạm tới bước đưa code lên hệ thống thật. Nó đề xuất, bạn duyệt và triển khai, theo bài chạy agent trong CI.
Ba việc này đều làm được sau vài tháng. Điều kiện là bạn đã có bản đồ, có lưới an toàn, và đã thấy agent xử lý dự án của mình tốt tới đâu.
Danh mục rút gọn
Mười dòng, dán vào tài liệu nội bộ:
- Mã nguồn trong Git, nhánh chính sạch.
- Bản sao lưu database đã thử khôi phục.
- Danh sách luồng chính viết ra giấy.
- Có môi trường thử.
- Tuần một chỉ đọc, kết quả là bản đồ và danh sách rủi ro.
- File quy ước dưới một trăm dòng, có phần vùng cấm.
- Danh sách quyền bắt đầu chặt, mở dần.
- Hook chặn các lệnh không bao giờ được xảy ra.
- Mọi thay đổi trên nhánh riêng, người duyệt là người chịu trách nhiệm.
- Không giao database, thanh toán và triển khai trong tháng đầu.
Làm đủ mười dòng này thì tháng đầu của bạn sẽ nhàm chán, và đó chính là kết quả mong muốn. Phần thú vị là những tháng sau, khi agent đã hiểu dự án và bạn đã biết giao gì cho nó.
Điều kiện tiên quyết, không có thì đừng bắt đầu
| Điều kiện | Vì sao bắt buộc |
|---|---|
| Toàn bộ mã nằm trong kho quản lý phiên bản | Không có thì không có cách nào quay lui |
| Có bản sao lưu cơ sở dữ liệu đã thử khôi phục ít nhất một lần | Bản sao lưu chưa từng khôi phục thử là bản sao lưu chưa chắc dùng được |
| Có môi trường chạy thử tách khỏi bản phục vụ khách | Thử trên bản thật là đánh cược với dữ liệu của khách hàng |
| Có người chịu trách nhiệm cuối cho mỗi lần gộp mã | Không có thì trách nhiệm rơi vào khoảng không |
Bốn tuần đầu, theo thứ tự
- Tuần một, chỉ đọc. Hỏi về luồng nghiệp vụ, vẽ bản đồ tệp. Không sửa gì. Kết quả là hiểu biết, và nó dùng được lâu hơn mọi bản vá.
- Tuần hai, dựng ba lớp an toàn. Kiểm tra cú pháp tự động, bài kiểm thử cho luồng quan trọng nhất về tiền, và quy tắc không gộp thẳng vào nhánh chính.
- Tuần ba, việc sửa đầu tiên. Chọn một lỗi nhỏ, phạm vi rõ, không chạm dữ liệu. Đi hết quy trình từ đầu tới lúc gộp để cả đội thấy quy trình hoạt động ra sao.
- Tuần bốn, mở dần. Thêm một loại việc, giữ nguyên các rào. Chỉ mở rộng khi loại việc trước đã ổn định.
Ba việc để dành sau tháng đầu
# 1. Doi cau truc bang du lieu# Trong du an dang chay that, mot cot tuong bo di duoc# thuong co noi khac dang doc ma khong ai nho # 2. Sua phan xac thuc va phan quyen# Sai o day la lo hong, khong phai loi hien thi # 3. Nang phien ban nen tang# Can lam, nhung lam rieng thanh mot dot co ke hoach # Danh muc rut gon truoc moi lan gop ma:git diff main --stat # pham vi co dung mo ta khonggit diff main | grep -i "password\|secret\|token" | head -n 20# chay bo kiem thu day du, khong chi phan vua sua# doc lai phan cham vao du lieu bang mat, khong tin vao ket qua xanhCâu hỏi thường gặp
Có nên dùng agent trên dự án đang chạy thật không?
Có, nhưng theo lộ trình. Tuần đầu chỉ đọc, tuần hai dựng ba lớp an toàn, tuần ba sửa chỗ ít rủi ro, rồi mở dần. Đừng bắt đầu bằng việc giao sửa một chỗ quan trọng.
Ba lớp an toàn là gì?
File quy ước dự án cho chuẩn chung, danh sách quyền để giới hạn loại thao tác, và hook chạy bằng mã để chặn những lệnh không bao giờ được xảy ra. Lớp thứ ba là ràng buộc thật, hai lớp đầu là hướng dẫn.
Việc nào tuyệt đối không nên giao sớm?
Đổi cấu trúc database, sửa luồng thanh toán, và triển khai tự động lên hệ thống thật. Ba việc này sai một lần là hậu quả thật, và chúng đều chờ được vài tháng.
Chạy agent trên máy nào cho an toàn?
Trên một máy riêng với tài khoản ít quyền, không giữ khóa vào hệ thống sản xuất, làm việc trên bản sao repo và nhánh riêng. Như vậy dù có chuyện thì phạm vi ảnh hưởng vẫn nằm trong tầm kiểm soát.