AiChatGPT CODEX AI bài số 10 : AGENTS.md là gì và cách tạo chỉ dẫn project

Nhóm: Prompt · Khóa học: Free · Course ID: 59

1. Trọng tâm bài học

AGENTS.md là tài liệu chỉ dẫn dành cho coding agent trong repository. Hãy dùng nó để ghi build command, test command, convention, vùng không được sửa và yêu cầu bàn giao.

2. Cách làm đúng

Codex nên được xem như một cộng tác viên kỹ thuật có khả năng thao tác trên codebase. Bạn vẫn phải xác định phạm vi, cung cấp tiêu chí hoàn thành và review thay đổi trước khi đưa vào production.

3. Ví dụ thực hành

# AGENTS.md
## Build
dotnet build MyApp.sln

## Test
dotnet test tests/MyApp.Tests

## Rules
- WinForms controls cố định phải nằm trong Designer.cs.
- Không sửa migration cũ.
- Không commit secrets.
- Sau mỗi task: build + liệt kê file thay đổi.

4. Đọc kết quả của Codex

• Kiểm tra file nào đã được đọc/sửa.
• Đọc diff thay vì chỉ đọc phần tóm tắt.
• Kiểm tra command/build/test mà agent đã chạy.
• Nếu agent đưa giả định, xác minh giả định đó trong source hoặc tài liệu.

5. Lỗi thường gặp

• Giao nhiệm vụ quá rộng nhưng không có tiêu chí Done.
• Cho phép refactor ngoài phạm vi khi chỉ cần fix bug.
• Không đưa log thật và để agent đoán lỗi.
• Chấp nhận code chỉ vì build qua mà không review hành vi.

6. Bài tập

1. Áp dụng ví dụ vào một repository thử nghiệm.
2. Viết lại yêu cầu sao cho có Scope, Constraints và Done criteria.
3. So sánh diff trước/sau và ghi lại một điểm bạn phải tự review.

7. Ghi chú Free

Codex hiện có quyền truy cập trên ChatGPT Free, nhưng hạn mức phụ thuộc gói và có thể thay đổi. Giáo trình không gắn một con số hạn mức cố định vào bài để tránh nhanh lỗi thời.