Llms.txt và MCP gần như không giúp ích gì cho AI viết code

Công nghệ20 tháng 11, 2026·7 phút đọc

Tác giả duy trì gói Backpack for Laravel cho biết llms.txt và máy chủ MCP mà nhóm ông xây dựng hầu như không cải thiện chất lượng khi AI viết bảng quản trị. Thay vào đó, những yếu tố giúp ích nhiều nhất là API ổn định, mã nguồn mở, kiến trúc đơn giản và các lệnh sinh mã tự động.

Llms.txt và MCP gần như không giúp ích gì cho AI viết code

Thời gian làm một bảng quản trị (admin panel) đơn giản đã giảm từ một đến hai ngày xuống còn một đến hai giờ. Đó là quan sát của người duy trì gói Backpack for Laravel, gói dựng bảng quản trị đã tồn tại 10 năm.

Với cách làm cũ, mỗi thao tác tạo, đọc, sửa, xóa (CRUD) mất 30 đến 60 phút: cài gói, sinh mã, cấu hình từng trường và cột, nối quan hệ rồi bấm thử từng màn hình. Giờ đây tác giả mô tả yêu cầu, tác nhân AI (agent) chạy các lệnh sinh mã, viết cấu hình, viết kiểm thử, còn người duy trì chỉ xem lại.

Một khách hàng ở New Zealand tháng 2/2026 chấm 10/10 với lời nhận xét một dòng: dễ dùng, nhất là khi có Claude ở bên cạnh. Tác giả cho rằng đây là trạng thái bình thường mới: lập trình viên không còn làm việc một mình với tài liệu.

Hai thứ được khuyên dùng nhưng ít tác dụng

llms.txt: Backpack có phát hành tệp này nhưng tác giả không thấy nó giúp được gì. Tác nhân hiếm khi tìm tới nó. Khi tìm tới, chúng chỉ thấy một mục lục trỏ về tài liệu mà chúng vốn đọc được. Nhóm đang cân nhắc bỏ.

Máy chủ MCP (Model Context Protocol, giao thức để tác nhân gọi công cụ bên ngoài): nhóm cũng đã dựng để tác nhân truy vấn tài liệu. Kết quả lẫn lộn. Tác nhân phải tự quyết định gọi nó và thường không gọi. Có lúc chúng gõ vào truy vấn chỉ hai từ, nên đương nhiên không nhận được kết quả hữu ích. Tác giả cho rằng MCP phù hợp với dữ liệu sống mà tác nhân không lấy được bằng cách khác, hoặc để dùng công cụ, chứ không dành cho tài liệu tĩnh.

Bài học: thứ gì tác nhân phải "nhớ" để đi lấy đều yếu. Thứ hiệu quả là thứ đã nằm ngay trước mặt nó, hoặc đã nằm sẵn trong đầu nó.

Bốn yếu tố thực sự tạo khác biệt

API ổn định. API lõi của Backpack gần như không đổi trong bốn năm qua. Kể cả phiên bản v8 đang làm cũng bắt đầu bằng việc bảo trì: nâng cấp và loại bỏ phụ thuộc, sửa chỗ thiếu nhất quán. Cách khai báo trường và cột giữ nguyên. Nhóm làm vậy để việc nâng cấp dự án cũ bớt đau, nhưng hệ quả phụ là nhiều năm mã Backpack lọt vào dữ liệu huấn luyện mô hình và vẫn còn đúng.

Khi tác nhân viết CRUD::column('name'), nó không tìm kiếm hay đoán mò, nó đã biết sẵn. Mỗi lần đổi tên hàm là một lần chia những gì mô hình học được thành "cách cũ" và "cách mới", và mô hình sẽ tiếp tục gợi ý cách cũ trong nhiều năm. Mặt trái là mô hình đôi khi viết theo mẫu của bản rất cũ. Nhóm xử lý bằng tệp hướng dẫn đặt trong dự án, không trông chờ mô hình tự cập nhật.

Lời khuyên: đánh dấu lỗi thời thay vì đổi tên, giữ chữ ký hàm cũ hoạt động được. Mỗi thay đổi phá vỡ tương thích khiến bạn trả giá hai lần, một với người dùng, một với mọi tác nhân đã học API cũ.

Mã nguồn mở. Gói lõi backpack/crud là mã nguồn mở. Nghĩa là 10 năm issue trên GitHub, pull request, hướng dẫn, câu trả lời Stack Overflow và bài blog đều thành dữ liệu huấn luyện, và đều tìm kiếm được khi tác nhân chịu đi tìm. Tác giả cho rằng đây là một lý do mới để chọn mã nguồn mở thay vì đóng.

Mã đọc được. Composer cài mọi thứ vào thư mục vendor/, kể cả các gói trả phí của Backpack. Không làm rối mã (obfuscation), không gọi API từ xa. Tác nhân mở được mã thật của bất kỳ tính năng nào, miễn phí hay trả phí, và thấy chính xác nó chạy thế nào. Trong thực tế, đọc vendor/ là cách tác nhân tự trả lời phần lớn câu hỏi về Backpack mà không cần ai nhắc.

Kiến trúc lỏng. Backpack cho phép ghi đè gần như mọi thứ bằng một hàm vô danh (closure) hoặc chỉnh nhỏ, không phải tạo lớp mới, đăng ký provider hay kế thừa nhiều tầng. Cần một cột tính toán thì chỉ một dòng. Thay đổi nhỏ nằm gọn trong một tệp, nên tác nhân cần ít ngữ cảnh hơn và ít chỗ để sai hơn. Kiến trúc chặt và trừu tượng nặng buộc tác nhân phải hiểu nhiều thứ mới sửa được một chút.

Hướng dẫn sẵn trong ngữ cảnh và lệnh sinh mã

Backpack thêm một plugin cho Laravel Boost. Chạy php artisan boost:install, chọn backpack/crud, là tác nhân nhận ngay hướng dẫn và kỹ năng (skill) trong ngữ cảnh: có tính năng nào, dùng đúng ra sao, theo mẫu nào của phiên bản đang cài. Kỹ năng được chia theo chủ đề (trường, cột, bộ lọc, thao tác, kiểm thử), nên tác nhân chỉ nạp phần cần dùng.

Cách này hiệu quả ở chỗ MCP thất bại, vì tác nhân không phải quyết định đi lấy gì. Thông tin đã có sẵn khi bắt đầu làm việc. Nó cũng khắc phục nhược điểm dữ liệu huấn luyện cũ, vì hướng dẫn khớp với phiên bản thực tế đang cài.

Về lệnh, php artisan backpack:crud Product tạo model, request, controller, route và mục menu trong một lần. Lệnh backpack:tests viết kiểm thử tính năng cho mọi CrudController theo PHPUnit hoặc Pest, còn backpack:tests:status cho biết controller nào chưa có kiểm thử. Còn nhiều lệnh nhỏ khác như backpack:field, backpack:column, backpack:filter, backpack:button.

Lệnh cho kết quả đúng giống nhau mỗi lần. Mã khuôn mẫu do tác nhân tự viết là một cơ hội mới để mắc lỗi nhỏ ở từng tệp. Thời gian của tác nhân nên dành cho phần đặc thù của dự án.

Đặt tên dễ đoán và tài liệu dạng Markdown

Khi tên gọi theo quy luật, tác nhân đoán đúng. Trường text đi với cột text. Trường select2 có anh em select2_multiple, nên select2_from_ajax cũng có select2_from_ajax_multiple. Trường date_picker đi với cột date_picker. Tác nhân đã thấy một cái là đoán đúng phần còn lại mà không cần mở tệp nào. Mỗi chỗ thiếu nhất quán là một chỗ tác nhân đoán sai và người duy trì phải trả giá lúc xem lại.

Tài liệu của Backpack nằm sau Cloudflare, và nhóm bật tính năng trả về Markdown thay vì HTML khi tác nhân yêu cầu. Tác nhân đọc nhanh hơn và ít nhiễu hơn. Lợi ích nhỏ, và miễn phí nếu bạn đã dùng Cloudflare.

Tác giả kết luận những thắng lợi lớn nhất không đến từ mẹo thông minh nào. Ổn định, mã mở, kiến trúc đơn giản và lệnh sinh mã tốt đều là thứ nhóm làm cho lập trình viên. Hóa ra đó cũng đúng là thứ tác nhân AI cần nhất. Các bổ sung riêng cho AI chỉ giúp khi chúng đặt thông tin đúng ngay trước mặt tác nhân mà không cần nó hỏi.

Góc nhìn

Với nhóm làm thư viện và gói phần mềm ở Việt Nam, bài viết là danh sách việc cần làm cụ thể. Giữ API ổn định và đánh dấu lỗi thời thay vì đổi tên giúp mã cũ vẫn đúng trong mắt mô hình. Phát hành mã đọc được, kể cả bản trả phí, giúp tác nhân tự trả lời câu hỏi của người dùng mà không cần hỗ trợ thủ công.

Các nhóm phát triển sản phẩm cũng nên xem lại thứ tự ưu tiên. Dựng máy chủ MCP tốn công mà tác nhân thường không gọi tới. Một tệp hướng dẫn ngắn, khớp phiên bản, đặt trong ngữ cảnh của tác nhân có thể hữu ích hơn nhiều. Điều kiện là tài liệu và quy ước đặt tên phải nhất quán, vì đó chính là thứ tác nhân dựa vào để đoán đúng.

Nguồn: backpackforlaravel.com · Quy trình biên tập

Chia sẻ:FacebookX