Lần đầu để Codex sửa code

Đừng bắt đầu bằng refactor lớn. Tác vụ đầu tiên nên nhỏ, có test hoặc cách kiểm chứng rõ, và có thể rollback bằng Git.

Chọn tác vụ đầu tiên

Tốt:

• Sửa lỗi chính tả trong README.
• Bổ sung một test nhỏ.
• Sửa một failing test đã có log rõ.
• Thêm validation đơn giản.

Không tốt:

• “Tối ưu toàn bộ codebase”.
• “Đổi framework”.
• “Sửa tất cả lỗi bảo mật”.
• “Deploy luôn lên production”.

Bước 1: Chỉ đọc lập bản đồ

Prompt:

Chỉ đọc repo. Hãy xác định stack, cấu trúc thư mục, lệnh test/build,
và đề xuất 3 tác vụ nhỏ phù hợp để Codex xử lý trước.

Bước 2: Giao việc nhỏ

Prompt mẫu:

Hãy sửa lỗi [mô tả] trong [file/module].
Không refactor ngoài phạm vi.
Sau khi sửa, chạy [lệnh test] và báo kết quả.

Bước 3: Quan sát quá trình

Trong lúc Codex chạy, chú ý:

• Nó có đọc đúng file không.
• Nó có chạy lệnh trong đúng thư mục không.
• Nó có xin quyền bất thường không.
• Nó có mở rộng phạm vi sửa không.

Nếu hướng đi sai, dừng và chỉnh prompt. Đừng để nó tiếp tục sửa trên giả định sai.

Bước 4: Kiểm tra diff

Sau khi xong:

git status
git diff

Đọc diff trước khi commit. Nếu có thay đổi ngoài phạm vi, yêu cầu Codex giải thích hoặc tự revert phần không liên quan.

Bước 5: Ghi lại trước commit

Một bàn giao tốt gồm:

• File đã sửa.
• Vì sao sửa.
• Lệnh đã chạy.
• Kết quả lệnh.
• Rủi ro còn lại.

Nếu lần đầu thất bại

Hãy giảm phạm vi:

• Chuyển sang chỉ đọc.
• Chỉ sửa một file.
• Cung cấp log lỗi cụ thể.
• Bỏ yêu cầu “tối ưu” hoặc “clean up”.
• Chạy test thủ công và đưa output cho Codex.

Chuẩn hoàn thành

Bạn hoàn thành bài này khi diff nhỏ, test liên quan chạy được hoặc lý do không chạy được được nêu rõ, và bạn hiểu toàn bộ thay đổi.

Bước tiếp theo: Dùng Codex trong VS Code