Dùng Codex Subagents chia việc rà mã và nghiên cứu cho nhóm phần mềm nhỏ có kiểm chứng

Bạn nhận một pull request lớn, trong khi nhóm chỉ có hai người rà mã. Codex Subagents chia việc đọc thay đổi thành các nhánh: một nhánh tìm rủi ro, một nhánh xem kiểm thử, một nhánh đối chiếu tài liệu. Trong khoảng 30 đến 45 phút, bạn sẽ có danh sách phát hiện kèm vị trí và bằng chứng để trưởng nhóm kiểm tra. Cần một kho mã có Git, quyền dùng Codex và một thay đổi rõ để rà.

Đây là cách dùng nhiều luồng nghiên cứu, không phải cách giao ba người cùng sửa một tệp. Tài liệu Subagents của OpenAI khuyên bắt đầu bằng việc đọc nhiều, như khám phá mã, chạy kiểm thử, phân loại lỗi và tóm tắt. Mỗi subagent dùng tài nguyên riêng, nên có thể tốn nhiều token hơn một phiên đơn.

Chuẩn bị

Mở kho mã trong Codex desktop, CLI hoặc tiện ích IDE. Theo tài liệu hiện hành, Codex hỗ trợ luồng subagent trên các bề mặt này; giao diện để xem luồng có thể khác nhau. Nếu mới dùng dòng lệnh, hãy bắt đầu từ hướng dẫn Codex CLI đọc, sửa và kiểm chứng một repo lạ.

Chốt nhánh cần rà, lệnh kiểm thử và tài liệu nền. Dùng git status để ghi nhận thay đổi chưa lưu trước khi giao việc.

Nhóm cần quy tắc chung về cách báo lỗi và mức độ nghiêm trọng. Có thể lưu ở AGENTS.md; xem cách thống nhất quy tắc làm việc trong Codex. Hãy yêu cầu bằng chứng cụ thể, không coi cảm giác “trông nguy hiểm” là phát hiện. Nếu bạn chưa rõ agent khác chatbot ở đâu, bài nền tảng về AI agent giải thích ngắn gọn.

Làm từng bước

1. Tách các câu hỏi có thể trả lời độc lập

Với pull request thay đổi đăng nhập và thông báo, đừng giao ba subagent cùng “rà toàn bộ và sửa luôn”. Chia thành ba câu hỏi không cần chờ nhau:

1. Đúng sai và bảo mật: Luồng đăng nhập có bỏ qua kiểm tra quyền, lộ dữ liệu hoặc xử lý sai trường hợp lỗi không?
2. Kiểm thử và hồi quy: Trường hợp nào đã được kiểm tra, trường hợp nào còn thiếu, bài test hiện tại có thực sự bắt được lỗi không?
3. Tài liệu và hành vi bên ngoài: Thay đổi có khớp API, tài liệu framework và kỳ vọng của người dùng không?

Giao mỗi nhánh một đầu ra giống nhau: phát hiện, tệp và dòng, bằng chứng, mức độ ảnh hưởng, điểm chưa chắc. Mỗi nhánh chỉ đọc; người chính chờ đủ kết quả rồi tổng hợp. Thay đổi nhỏ có thể chỉ cần một phiên Codex.

2. Giao nhiệm vụ song song bằng một yêu cầu rõ ràng

Trong chat Codex desktop, IDE hoặc phiên CLI tương tác, gửi yêu cầu trực tiếp như sau. Thay phần trong ngoặc vuông bằng thông tin của dự án:

Hãy dùng ba Codex subagent để rà [nhánh hoặc pull request] so với [nhánh gốc].
Agent 1 chỉ kiểm tra tính đúng đắn, quyền truy cập và lỗi có thể ảnh hưởng người dùng.
Agent 2 chỉ kiểm tra khoảng trống kiểm thử và nguy cơ hồi quy. Có thể đọc hoặc chạy các bài test sẵn có, không sửa tệp.
Agent 3 chỉ đối chiếu tài liệu chính thức của [framework hoặc API] với phần mã đã đổi. Nếu không truy cập được tài liệu, hãy nói rõ giới hạn.
Các agent không sửa mã, không commit, không đẩy nhánh và không dùng cùng một tệp để ghi kết quả.
Mỗi phát hiện phải có đường dẫn tệp, vị trí, bằng chứng và cách kiểm tra lại. Nếu không tìm thấy lỗi, hãy nói đã kiểm tra những gì và còn bỏ ngỏ gì.
Hãy đợi cả ba hoàn tất, gộp các phát hiện trùng nhau, xếp theo mức ảnh hưởng và chỉ đề xuất sửa sau khi xác minh.

OpenAI nêu ví dụ gần với cách này: chia rà pull request cho các agent xem bảo mật, khoảng trống kiểm thử và khả năng bảo trì. Trong CLI, lệnh /agent giúp xem và chuyển giữa các luồng. Trên desktop và IDE, bạn có thể mở luồng của từng subagent từ giao diện. Đừng chỉ đọc câu kết luận của luồng chính nếu một phát hiện có thể làm đổi quyết định phát hành.

3. Giữ ranh giới quyền và tài nguyên

Subagent kế thừa chính sách sandbox của phiên chính. Quyền mà phiên chính chưa có không tự xuất hiện khi bạn tạo luồng mới. Trước khi giao việc, kiểm tra chế độ quyền đang chọn và những công cụ có thể dùng. Nếu một nhánh chỉ cần đọc, nói rõ “không sửa” trong yêu cầu; khi dùng custom agent, có thể cấu hình nó ở chế độ chỉ đọc.

Một số thao tác có thể cần phê duyệt. Trong phiên CLI tương tác, yêu cầu phê duyệt của luồng khác có thể xuất hiện khi bạn đang xem luồng chính, nên hãy nhìn nhãn luồng trước khi quyết định. Trong luồng không tương tác, thao tác cần phê duyệt mới có thể thất bại và lỗi được báo về luồng chính. Không mở quyền rộng chỉ để ba nhánh chạy trơn tru.

Mỗi subagent dùng tài nguyên riêng; chia quá vụn có thể tăng chi phí. Mặc định, agent con kế thừa model và mức suy luận của agent chính nếu bạn không đặt riêng.

4. Đọc kết quả như một bản nháp kiểm toán

Khi các nhánh xong, yêu cầu luồng chính gộp phát hiện trùng và chỉ ra mâu thuẫn. Ví dụ, một agent nói thiếu test cho phiên hết hạn, agent khác chỉ ra test đã có ở thư mục khác. Đừng chọn kết luận nghe chắc chắn hơn. Mở đúng test, đọc điều kiện kiểm tra, chạy lại nếu cần và ghi kết quả.

Bạn có thể dùng yêu cầu tổng hợp:

Hãy gộp kết quả của ba subagent cho [pull request].
Với mỗi phát hiện, đưa: mức ảnh hưởng, tệp và dòng, bằng chứng từ mã hoặc test, kết quả kiểm tra lại, và người cần quyết định.
Đánh dấu “chưa xác minh” nếu chỉ có suy luận. Loại các phát hiện trùng nhau.
Chưa sửa mã. Kết thúc bằng ba việc cần kiểm tra thủ công trước khi duyệt.

Tự mở mã có tác động cao, chạy lại test và xem bản khác biệt. Hướng dẫn Codex Cloud mở pull request có kiểm chứng minh họa bước đối chiếu kết quả. Quyết định duyệt vẫn thuộc nhóm.

5. Chỉ sau khi xác minh mới giao sửa mã

Chọn một phát hiện đã kiểm chứng, chỉ định người sở hữu phần sửa, bài test chứng minh lỗi và phạm vi tệp được phép đổi. Nếu giao cho Codex sửa, hãy tách khỏi giai đoạn rà. Một người hoặc một luồng sở hữu thay đổi ở mỗi khu vực mã. Các nhánh sửa song song cùng thư mục dễ gây xung đột hoặc làm test đọc trạng thái đang đổi.

Sau khi sửa, chạy test, xem git diff và nhờ người khác đọc lại phần nhạy cảm. Nếu test không ổn định, ghi đúng là chưa xác minh.

Kết quả mẫu

Giả sử một pull request giả định thêm tính năng gửi thông báo khi người dùng đăng nhập từ thiết bị mới. Ba subagent trả về:

Đây là tình huống minh họa, không phải kết quả được Codex bảo đảm. Đầu ra hữu ích là lỗi tái hiện được, khoảng trống test có bằng chứng và câu hỏi cần quyết định.

Mẹo để kết quả tốt hơn

Giao câu hỏi, không giao chức danh mơ hồ. “Bạn là chuyên gia bảo mật” chưa nói phải kiểm tra phần nào. Hãy nêu phạm vi, đầu ra và cách báo khi thiếu dữ liệu.

Đặt mẫu phát hiện chung. Tệp, dòng, bằng chứng, cách tái hiện, mức ảnh hưởng và điểm chưa chắc khiến ba nhánh dễ gộp hơn. Với việc rà lặp lại, ghi mẫu vào chỉ dẫn nhóm và cập nhật theo lỗi thực tế.

Cho phép câu trả lời “chưa tìm thấy”. Một subagent không cần tạo lỗi cho đủ phần việc. Yêu cầu nó nêu phạm vi đã kiểm tra và giới hạn truy cập.

Đo tác dụng. Ghi số phát hiện đúng, số báo nhầm và thời gian kiểm lại. Nếu kết quả không cải thiện, hãy sửa cách chia việc.

Giới hạn cần biết

Ba bản rà không tương đương ba người chịu trách nhiệm độc lập. Các agent có thể cùng hiểu sai một giả định hoặc cùng dựa vào test yếu. Người duyệt cần kiểm tra các phát hiện ảnh hưởng đến bảo mật, dữ liệu và hành vi người dùng. Việc chạy test có thể cho kết quả khác nhau nếu môi trường hoặc dữ liệu thử khác nhau.

Tài liệu Subagents của OpenAI phân biệt ChatGPT Work chạy trong môi trường lưu trữ với Codex cục bộ. Bài này nói về Codex trên kho mã. Đừng áp dụng lệnh hoặc cấu hình của Claude Code cho Codex.

Đừng gửi mã nguồn riêng, bí mật hoặc dữ liệu khách hàng cho nguồn ngoài mà nhóm chưa phê duyệt. Nếu nhánh nghiên cứu không có quyền truy cập tài liệu hiện hành, hãy ghi rõ “chưa đối chiếu nguồn” thay vì suy đoán API.

Câu hỏi thường gặp

Subagent có tự xuất hiện khi tôi mở Codex không? Các bản Codex hiện hành hỗ trợ luồng subagent, nhưng cách bắt đầu phụ thuộc bề mặt và chỉ dẫn áp dụng. Hãy yêu cầu giao việc song song trực tiếp; không dựa vào việc hệ thống luôn tự tách việc.

Tôi nên tạo bao nhiêu subagent cho một pull request? Chọn theo số câu hỏi thật sự độc lập. Với nhóm nhỏ, hai hoặc ba nhánh đọc thường dễ kiểm soát hơn việc chia theo từng tệp. Số tối ưu phải đo bằng kết quả và chi phí thực tế.

Agent con có quyền cao hơn phiên chính không? Không. Nó kế thừa chính sách sandbox của phiên chính; công cụ và thao tác vẫn chịu các giới hạn tương ứng. Hãy kiểm tra chế độ quyền trước khi giao việc.

Có thể cho ba agent cùng sửa mã để nhanh hơn không? Có tình huống nhiều nhánh ghi độc lập, nhưng rủi ro xung đột tăng. Với bài rà mã này, hãy để chúng đọc và báo bằng chứng; giao sửa sau khi xác minh, với chủ sở hữu tệp rõ ràng.

Nếu ba kết luận mâu thuẫn nhau thì chọn bản nào? Chưa chọn ngay. Mở mã và test liên quan, đối chiếu tài liệu chính thức, chạy lại trường hợp có thể tái hiện, rồi ghi điều vẫn chưa chắc chắn để người duyệt quyết định.

Nguồn chính: Subagents, Code review, AGENTS.md, OpenAI Learn. Nội dung đối chiếu ngày 5/10/2026. #Codex #Subagents #CodeReview #VibeCoding