Thực thi tuần tự và song song

Codex làm việc tốt nhất khi tác vụ có vòng lặp rõ: đọc ngữ cảnh, lập bước xử lý, sửa phạm vi nhỏ, kiểm chứng và báo lại kết quả. Hiểu cơ chế này giúp bạn review dễ hơn và giảm rủi ro.

1. Thực thi tuần tự

Với một tác vụ thông thường, Codex thường đi theo thứ tự:

1. Đọc cấu trúc repo hoặc file liên quan.
2. Xác định điểm cần sửa.
3. Chạy lệnh kiểm tra nếu cần.
4. Sửa file.
5. Chạy test, build hoặc kiểm chứng.
6. Tóm tắt file đã đổi, kết quả kiểm chứng và rủi ro còn lại.

Prompt tốt:

Hãy đọc repo trước, tìm nguyên nhân test đang fail, chỉ sửa phần cần thiết.
Sau khi sửa hãy chạy test liên quan và tóm tắt diff.

Prompt yếu:

Sửa hết lỗi giúp tôi.

Tác vụ càng mơ hồ, Codex càng phải đoán. Khi đoán nhiều, phạm vi sửa dễ phình ra.

2. Khi nào nên song song

Song song phù hợp khi các phần việc độc lập:

• Đọc nhiều tài liệu nguồn khác nhau rồi tổng hợp.
• Kiểm tra nhiều module không phụ thuộc nhau.
• Chạy nhiều hướng debug riêng biệt.
• Làm nhiều task trên worktree/branch tách biệt.

Không nên song song khi bước sau phụ thuộc kết quả bước trước, hoặc khi nhiều tác vụ cùng sửa một file.

3. Cách giao việc song song an toàn

Hãy chia task theo đầu ra:

Hãy chia tác vụ thành ba nhánh độc lập:
1. kiểm tra lỗi build frontend,
2. kiểm tra lỗi test backend,
3. rà soát tài liệu deploy.
Mỗi nhánh chỉ đọc/sửa file trong phạm vi liên quan và báo kết quả riêng.

Nếu dùng Git, yêu cầu mỗi nhánh làm trên worktree hoặc branch riêng. Sau khi xong, bạn review từng diff trước khi hợp nhất.

4. Luôn yêu cầu kiểm chứng

Tác vụ chưa hoàn thành nếu chưa có bằng chứng kiểm chứng. Bằng chứng có thể là:

• pnpm test, npm test, pytest, cargo test.
• pnpm build hoặc build production.
• Screenshot UI.
• Log trước/sau.
• Link PR hoặc diff.
• Checklist tự kiểm tra.

Khi test không chạy được, Codex phải nói rõ lý do và phần nào chưa kiểm chứng.

5. Mẫu prompt thực dụng

Mục tiêu: sửa lỗi [mô tả lỗi].
Phạm vi: chỉ sửa trong [thư mục/file].
Không làm: không đổi API public, không format toàn repo, không cập nhật dependency nếu chưa cần.
Kiểm chứng: chạy [lệnh test/build].
Bàn giao: liệt kê file sửa, kết quả lệnh, rủi ro còn lại.

Bước tiếp theo: Quản lý quyền