Cách Viết program.md Tốt: Hướng Dẫn Thực Hành Cho Hướng Dẫn AI Agent

Autoresearch của Andrej Karpathy đã chứng minh rằng một file Markdown được viết tốt có thể chỉ đạo AI agent để thực hiện các khám phá khoa học thực sự qua đêm. Nhưng không phải tất cả các file program.md đều như nhau.

Chất lượng hướng dẫn Markdown trực tiếp quyết định chất lượng đầu ra của AI agent. Một program.md mơ hồ tạo ra các thí nghiệm ngẫu nhiên, không có hướng. Một cái chính xác tạo ra các cải tiến tập trung, tích lũy.

Cấu Trúc Của program.md Tốt

Mỗi program.md hiệu quả cần năm phần:

1. Bối Cảnh: Agent Cần Biết Gì?

Agent bắt đầu với không có hiểu biết về dự án của bạn. Bao gồm: dự án làm gì, codebase trông như thế nào, file chính và mục đích của chúng, thuật ngữ đặc thù theo miền.

2. Mục Tiêu: Agent Nên Tối Ưu Điều Gì?

Đây là phần quan trọng nhất. Agent cần mục tiêu rõ ràng, có thể đo lường.

Trong autoresearch: giảm val_bpb. Định nghĩa thành công theo các điều khoản mà agent có thể đánh giá: “Giảm thời gian tải trang xuống dưới 2 giây”, “Tăng độ phủ test lên trên 80%“.

3. Ràng Buộc: Agent Không Bao Giờ Nên Làm Gì?

Không có ràng buộc, agent sẽ tìm con đường kháng cự ít nhất — thường không phải những gì bạn muốn. Ví dụ: đừng chỉnh sửa file test hoặc code đánh giá, đừng thay đổi API công khai, đừng giới thiệu dependencies mới.

4. Chiến Lược: Agent Nên Tiếp Cận Vấn Đề Như Thế Nào?

Đây là nơi chuyên môn miền của bạn tỏa sáng. Bạn biết những hướng nào hứa hẹn và những hướng nào là ngõ cụt. Hướng dẫn chiến lược tốt: “Bắt đầu với điều chỉnh siêu tham số trước khi thay đổi kiến trúc.”

5. Đánh Giá: Agent Nên Đánh Giá Thành Công Như Thế Nào?

Xác định tiêu chí đánh giá: số liệu nào quan trọng, ngưỡng nào tính là cải tiến, khi nào agent nên dừng và báo cáo lại.

Lỗi Phổ Biến

• Quá mơ hồ: “Làm cho mô hình tốt hơn” không có hướng
• Quá cụ thể: “Thay đổi dòng 47 để dùng learning rate 3e-4” — bạn đáng lẽ phải thiết lập hướng, không phải ra lệnh triển khai
• Quên ràng buộc: Agent sẽ tìm con đường tắt không mong muốn
• Không lặp lại: program.md đầu tiên của bạn sẽ không hoàn hảo

Vòng Lặp Lặp Lại

1. Viết program.md ban đầu
2. Chạy agent
3. Xem xét những gì agent làm
4. Cập nhật hướng dẫn dựa trên những gì hoạt động
5. Lặp lại

---

Save chuyển đổi bất kỳ trang web nào sang Markdown sạch — hoàn hảo để xây dựng thư viện tham khảo hỗ trợ các file program.md hiệu quả. Dùng thử Save miễn phí.