Cộng đồng phát triển phần mềm đang chứng kiến việc áp dụng nhanh chóng định dạng AGENTS.md , một định dạng tệp markdown chuẩn hóa được thiết kế để cung cấp hướng dẫn và ngữ cảnh cho các AI coding agent. Với hơn 20.000 dự án mã nguồn mở đã triển khai định dạng này, nó đại diện cho một sự thay đổi đáng kể trong cách các nhà phát triển cấu trúc kho lưu trữ của họ để hỗ trợ AI.
Thống kê về việc áp dụng:
- Các dự án sử dụng định dạng: Hơn 20.000 dự án mã nguồn mở
- Kho lưu trữ OpenAI: 88 tệp AGENTS.md trên các gói khác nhau
- Những nhà áp dụng lớn: OpenAI Codex , Apache Airflow , Temporal SDK , PlutoLang
Vấn Đề Chuẩn Hóa và Giải Pháp
Sự xuất hiện của AGENTS.md giải quyết một bối cảnh phân mảnh nơi các công cụ AI coding khác nhau sử dụng các tệp hướng dẫn độc quyền riêng của họ. Claude Code sử dụng CLAUDE.md , Cursor có các tệp .cursor, và các agent khác sử dụng nhiều quy ước đặt tên khác nhau. Sự không nhất quán này buộc các nhà phát triển phải duy trì nhiều tệp hướng dẫn cho các công cụ khác nhau, tạo ra chi phí không cần thiết và sự nhầm lẫn.
Định dạng AGENTS.md nhằm thống nhất cách tiếp cận này bằng cách thiết lập một vị trí duy nhất, có thể dự đoán được nơi tất cả các AI coding agent có thể tìm thấy hướng dẫn cụ thể cho dự án. Định dạng này cố ý đơn giản - nó chỉ là markdown chuẩn không có trường bắt buộc hoặc cấu trúc cứng nhắc, cho phép các nhà phát triển bao gồm bất kỳ thông tin nào họ cho là cần thiết cho các dự án cụ thể của họ.
Định dạng tệp Agent hiện tại theo từng công cụ:
- Claude Code: CLAUDE.md
- Cursor: tệp .cursor
- Jules (Google): AGENTS.md
- Gemini Code Assist: Tên tệp tùy chỉnh (có thể cấu hình)
- Factory: Nhiều định dạng khác nhau
- Codex: AGENTS.md
Cuộc Tranh Luận Cộng Đồng Về Việc Tách Biệt Khỏi Các Tệp README
Một điểm thảo luận quan trọng trong cộng đồng nhà phát triển tập trung vào việc liệu AGENTS.md có nên tồn tại riêng biệt với các tệp README.md truyền thống hay không. Một số nhà phát triển cho rằng thông tin thường được tìm thấy trong AGENTS.md - như lệnh build, quy trình kiểm thử và quy ước coding - sẽ có giá trị tương đương đối với những người đóng góp là con người và nên được tích hợp vào tài liệu hiện có như các tệp README.md hoặc CONTRIBUTING.md.
Tuy nhiên, những người ủng hộ định dạng riêng biệt chỉ ra các cân nhắc thực tế xung quanh việc quản lý ngữ cảnh cho các hệ thống AI. Không giống như con người có thể đọc có chọn lọc các phần liên quan, các AI agent thường xử lý toàn bộ tài liệu, khiến các hướng dẫn ngắn gọn, có mục tiêu trở nên hiệu quả hơn và tiết kiệm chi phí hơn về mặt sử dụng API.
Mọi người quá lười để viết tài liệu cho người khác, nhưng thật buồn cười là họ lại sẵn sàng làm điều đó cho robot.
Quan sát này làm nổi bật một hiện tượng thú vị nơi phản hồi tức thì và việc sử dụng nhất quán bởi các AI agent cung cấp động lực mạnh mẽ hơn để duy trì tài liệu so với các tài liệu hướng đến con người truyền thống có thể không được đọc.
Triển Khai Kỹ Thuật và Cấu Trúc Phân Cấp
Định dạng này hỗ trợ triển khai phân cấp, cho phép các dự án đặt các tệp AGENTS.md trong các thư mục con để kiểm soát chi tiết hơn. Khi xung đột xảy ra giữa các cấp độ khác nhau, tệp gần nhất với mã được chỉnh sửa sẽ được ưu tiên, với các lời nhắc người dùng rõ ràng ghi đè mọi thứ khác.
Một số nhà phát triển đã đề xuất các cách tiếp cận tinh vi hơn, gợi ý cấu trúc dựa trên thư mục với các tệp chuyên biệt cho các khía cạnh khác nhau như xác thực, hiệu suất và kiểm thử. Điều này sẽ cho phép các AI agent chỉ truy cập ngữ cảnh liên quan mà không xử lý thông tin không cần thiết, có khả năng cải thiện độ chính xác phản hồi và giảm sử dụng token.
Hướng dẫn triển khai AGENTS.md:
- Vị trí: Thư mục gốc của repository
- Định dạng: Markdown tiêu chuẩn không yêu cầu trường bắt buộc
- Cấu trúc phân cấp: Hỗ trợ các tệp lồng nhau trong thư mục con
- Giải quyết xung đột: Tệp gần nhất với mã được chỉnh sửa sẽ được ưu tiên
- Ví dụ nội dung: Lệnh build, quy trình kiểm thử, quy ước lập trình, hướng dẫn bảo mật
Áp Dụng Trong Ngành và Hỗ Trợ Công Cụ
Các nhà cung cấp lớn trong lĩnh vực AI coding đang bắt đầu phù hợp với tiêu chuẩn AGENTS.md . Agent Jules của Google đã hỗ trợ định dạng này, và các công cụ khác đang thêm khả năng tương thích. Nỗ lực chuẩn hóa bao gồm sự hợp tác giữa các đội từ OpenAI , Google , Cursor và các nền tảng phát triển AI nổi bật khác.
Tính linh hoạt của định dạng đã góp phần vào thành công áp dụng của nó. Các dự án có thể bao gồm mọi thứ từ các lệnh build đơn giản đến hướng dẫn kiến trúc phức tạp, cân nhắc bảo mật và quy trình triển khai. Việc thiếu các yêu cầu cứng nhắc có nghĩa là các đội có thể điều chỉnh định dạng theo nhu cầu cụ thể của họ trong khi duy trì khả năng tương thích trên các công cụ AI khác nhau.
Tác Động Tương Lai Đối Với Quy Trình Phát Triển
Việc áp dụng rộng rãi AGENTS.md phản ánh một sự thay đổi rộng lớn hơn trong thực hành phát triển phần mềm khi các trợ lý AI coding trở nên phổ biến hơn. Các nhà phát triển đang khám phá ra rằng việc tạo ra các hướng dẫn rõ ràng, có cấu trúc cho các AI agent thường cũng có lợi cho các thành viên nhóm là con người, dẫn đến tài liệu dự án tổng thể tốt hơn.
Khi định dạng tiếp tục phát triển, cộng đồng đang khám phá các tính năng bổ sung như chỉ thị import cho các hướng dẫn được chia sẻ và tích hợp tốt hơn với các công cụ phát triển hiện có. Thành công của AGENTS.md có thể báo hiệu sự khởi đầu của các cách tiếp cận chuẩn hóa hơn đối với sự hợp tác giữa con người và AI trong phát triển phần mềm.
Tham khảo: AGENTS.md