SSD Nodes Learn Hosting plans →
Hướng dẫn Matt ConnorBởi Matt Connor · Cập nhật ngày 2026-10-21

Chính sách dùng code AI trong dự án open source

Dự án open source có thể cấm code do AI tạo hoặc yêu cầu khai báo trong commit trailer. Kiểm tra policy trước khi viết patch và gửi pull request.

Cần làm gì trước khi gửi code có hỗ trợ từ AI lên upstream

Các dự án mã nguồn mở hiện đã công bố chính sách về code có hỗ trợ từ AI, và các chính sách này không đồng nhất với nhau. Vì vậy, thói quen rất đơn giản: hãy tìm chính sách trước khi viết patch, và công khai chính xác khi bạn gửi nó. Một quy tắc nằm dưới cả hai điều trên. Đừng bao giờ gửi một dòng code mà bạn không thể giải thích trong quá trình review.

Một patch đúng vẫn bị đóng nếu dự án cấm code được tạo tự động, hoặc nếu bạn giấu nguồn gốc của code đó. Cái giá phải trả sẽ gắn liền với tên tuổi của bạn, vì một maintainer nếu phát hiện ra sự thiếu trung thực sau đó sẽ không còn lý do gì để tin tưởng vào lịch sử đóng góp còn lại của bạn. Cần làm rõ một số thuật ngữ trước, vì các chính sách thường sử dụng chúng. LLM (large language model) là mô hình đứng sau agent lập trình của bạn. Một PR (pull request) trên GitHub cũng tương đương với một MR (merge request) trên GitLab, và mọi điều dưới đây áp dụng cho cả hai. DCO (developer certificate of origin) là dòng sign-off ở cuối commit message, và nó hóa ra lại là tâm điểm của toàn bộ cuộc tranh luận.

Các chính sách nguồn mở về code do AI tạo ra hiện đã đi đến đâu

Các dự án hiện được chia thành 4 nhóm. Mọi ví dụ dưới đây đều ghi rõ ngày vì các văn bản này còn thay đổi.

Cấm. Hội đồng Gentoo đã bỏ phiếu vào ngày 14 April 2024 rằng “nghiêm cấm đóng góp cho Gentoo bất kỳ nội dung nào được tạo với sự hỗ trợ của các công cụ trí tuệ nhân tạo xử lý ngôn ngữ tự nhiên”. Hướng dẫn commit của NetBSD gọi output từ LLM là “code bị nhiễm” và quy định rằng code này “không được commit nếu chưa có phê duyệt trước bằng văn bản của core”. Tài liệu về nguồn gốc code của QEMU, tính đến ngày 12 October 2026, vẫn nêu rằng dự án sẽ “TỪ CHỐI mọi đóng góp được cho là có chứa hoặc bắt nguồn từ nội dung do AI tạo ra”.

Chỉ phân tích. Hầu hết lệnh cấm đều hẹp hơn tiêu đề. Tài liệu của QEMU nêu rằng chính sách “không áp dụng cho các mục đích sử dụng AI khác, chẳng hạn như nghiên cứu API hoặc thuật toán, static analysis hoặc debugging, miễn là output của chúng không được đưa vào các đóng góp”. Bạn có thể dùng agent để đọc code. Bạn không được ship phần code mà agent đã viết. Đây là ranh giới được áp dụng trong hầu hết các dự án hạn chế, nhưng nhiều người bỏ qua điểm này.

Bắt buộc công khai. Hội đồng Fedora đã phê duyệt chính sách về đóng góp có AI hỗ trợ vào October 2025. Chính sách cho phép dùng các công cụ này và quy trách nhiệm cho người đóng góp: người đóng góp là tác giả, chịu hoàn toàn trách nhiệm về toàn bộ đóng góp, đồng thời phải công khai việc một phần đáng kể của đóng góp đến từ công cụ mà không được chỉnh sửa. Linux kernel đã thêm một trang về coding assistants vào tài liệu quy trình trong January 2026, kèm một trailer để ghi lại công cụ đã dùng và một quy định bắt buộc về người được phép sign off.

Chưa có văn bản. Đây vẫn là trường hợp phổ biến nhất. Một preprint từ May 2026 đã khảo sát 1,000 repository GitHub phổ biến và phát hiện 118 repository có bất kỳ chính sách AI nào được viết thành văn bản. Im lặng không có nghĩa là được phép. Hãy hỏi một câu trong issue tracker trước khi viết patch. Khi đó, câu trả lời trở thành hồ sơ công khai mà bạn có thể dẫn lại sau này.

Vì sao các maintainer viết những quy định này

Lý do đầu tiên là khối lượng review, và phép tính chỉ đi theo một hướng. Một agent có thể tạo một merge request 400 dòng nghe có vẻ hợp lý trong một phút. Review đúng cách merge request đó khiến maintainer mất cả buổi chiều, trong khi phần lớn maintainer là tình nguyện viên. Chi phí gửi thay đổi gần như bằng 0. Chi phí review hoàn toàn không giảm.

curl cho thấy rõ phần cuối của đường cong đó. Vào giữa năm 2025, Daniel Stenberg cho biết khoảng một phần năm các báo cáo bảo mật gửi qua bug bounty của dự án là thứ ông gọi là AI slop: các báo cáo nêu đúng function và code path có thật, mô tả một cuộc tấn công có vẻ hợp lý, nhưng không chứa nội dung hữu ích nào. Dự án đã kết thúc chương trình bounty vào đầu năm 2026 thay vì tiếp tục chi tiền xử lý lượng báo cáo tràn vào. Đó là các báo cáo chứ không phải patch, nhưng cơ chế vẫn giống nhau: maintainer mở PR của bạn trong trạng thái đã mệt mỏi.

GNOME Calendar ghi nhận vấn đề này bằng một label. Vào tháng 6 năm 2026, dự án giới thiệu label "Probabilistically Automated" cho các merge request thể hiện "sự phụ thuộc phần lớn hoặc hoàn toàn vào 'trí tuệ' nhân tạo để tạo code". Tính đến ngày 12 tháng 10 năm 2026, chính label này bao quát "sự phụ thuộc phần lớn hoặc hoàn toàn vào 'AI' / LLM / stochastic parrot để tạo code hoặc bug report", đồng thời nêu đúng triệu chứng: "Thường đi kèm với việc thiếu testing đúng cách, cũng như viết report hoặc hoàn thiện patch dựa trên behavior dự kiến nghe có vẻ hợp lý thay vì tính đúng đắn của code". Hãy đọc lại câu cuối hai lần. Code trông như thể sẽ hoạt động. Không ai kiểm tra nó có thực sự hoạt động hay không.

Lý do thứ hai là provenance, tức code đến từ đâu và được cung cấp theo license nào. QEMU nêu rõ xung đột này: việc sign-off khẳng định bạn "hoàn toàn hiểu trạng thái copyright và license của nội dung" mà mình đóng góp, trong khi trạng thái copyright của model output vẫn chưa được xác định rõ. Hội đồng Gentoo cũng đưa ra lý do tương tự, cùng với các vấn đề về chất lượng và đạo đức. Bạn không nhất thiết phải đồng ý với cách hiểu pháp lý đó. Nhưng bạn phải nhận ra rằng quyết định này thuộc về maintainer, không phải bạn.

Làm thế nào để tìm chính sách AI của một dự án?

Hãy tìm ở những nơi sau, theo thứ tự này.

  • CONTRIBUTING.md trong thư mục gốc của repository, sau đó là .github/CONTRIBUTING.md, rồi đến bất kỳ tệp DCO nào nằm cạnh đó.
  • Tài liệu dành cho nhà phát triển. QEMU lưu quy định của họ trong docs/devel/code-provenance.rst. Kernel lưu quy định của họ trong Documentation/process/coding-assistants.rst.
  • Trang web hoặc wiki của dự án. Chính sách của Gentoo nằm trên trang wiki của hội đồng, còn của NetBSD nằm trong hướng dẫn commit.
  • Trình theo dõi issue và kho lưu trữ mailing list. Một chính sách thường tồn tại ở đó nhiều tháng trước khi có ai đó viết nó vào repository.

Từ bên trong một bản checkout, một lệnh grep có thể bao quát hầu hết các trường hợp:

grep -rniE '(llm|copilot|chatgpt|generative|ai-generated|ai-assisted)' CONTRIBUTING.md docs/ .github/ 2>/dev/null | head -20

Sau đó, hãy đọc lịch sử của chính dự án đó, vì quy ước đã được commit luôn có giá trị hơn bất kỳ bản tóm tắt nào:

git log --format='%(trailers:key=Assisted-by,valueonly)' | grep . | sort | uniq -c
git log --format='%(trailers:key=AI-used-for,valueonly)' | grep . | sort | uniq -c

Một con số bên cạnh giá trị trailer cho bạn biết hình thức mà dự án này thực sự sử dụng. Kết quả trống nghĩa là chưa có ai công khai theo hình thức đó tại đây, đây cũng là một thông tin hữu ích. Nếu dự án nằm trên GitHub và workflow đó còn mới với bạn, cách pull request và fork hoạt động trên GitHub sẽ giải thích các cơ chế mà phần này đang giả định.

Ghi trong trailer của commit, không ghi trong comment

Trailer là một dòng Key: value trong đoạn cuối của commit message. Git đã dùng định dạng này cho Signed-off-by: và Co-authored-by:, đồng thời các tool có thể parse định dạng này. Vì vậy, đây là cách disclosure duy nhất đi cùng code vào trong tree.

net: release the buffer on the error path

The error path returned before releasing the buffer, so every failed
setup leaked one page.

Assisted-by: LLM coccinelle sparse
Signed-off-by: Your Real Name <you@example.com>

Kernel ghi lại định dạng này dưới tên Assisted-by: LLM [TOOL1] [TOOL2]. Tên tool tùy chọn phải là các tool phân tích chuyên dụng như coccinelle, sparse, smatch hoặc clang-tidy, không bao giờ là git, gcc hay editor của bạn. Vào tháng 8 năm 2026, kernel đã bỏ tên agent và model mà trang này trước đó yêu cầu, vì việc nêu tên model “provides free advertising to proprietary software companies while adding little or no useful information”. Trang này cũng nêu rõ giới hạn của dòng đó: “AI agents MUST NOT add Signed-off-by tags. Only humans can legally certify the Developer Certificate of Origin (DCO).” Disclosure tiếp tục ở Assisted-by. Tên của bạn nằm ở Signed-off-by. Không bao giờ để tool ghi phần thứ hai, và không bao giờ để tool tự tạo địa chỉ Co-authored-by không thuộc về ai.

Tên trailer khác nhau tùy dự án, vì vậy hãy sao chép tên đang dùng tại dự án thay vì tự đặt tên mới. Một patch gửi lên mailing list QEMU vào tháng 5 năm 2026 đề xuất nới lỏng lệnh cấm của dự án đối với các thay đổi cơ học, test, tài liệu và bug fix dài không quá 20 dòng, được ghi bằng trailer như AI-used-for: tests, docs. Tính đến ngày 12 tháng 10 năm 2026, patch đó vẫn chưa được merge. Một RFC vào tháng 9 năm 2026 của cùng tác giả đề xuất bản rewrite rộng hơn dựa trên cùng trailer, còn tài liệu đã commit vẫn không chấp nhận nội dung được tạo tự động. Một dự án đã thay đổi lập trường hai lần trong giai đoạn 2023–2026. Lần thay đổi tiếp theo sẽ không chờ bạn. Vì vậy, phương pháp quan trọng hơn danh sách.

git commit -s --trailer "Assisted-by: LLM" -m "net: release the buffer on the error path"
git log -1 --format='%(trailers:key=Assisted-by,valueonly)'

--trailer yêu cầu Git 2.32 trở lên. Lệnh thứ hai phải in lại giá trị trực tiếp cho bạn. Nếu dòng này trống, nghĩa là git không parse được trailer. Nguyên nhân gần như luôn là có một dòng trống hoặc một câu thông thường nằm trong trailer block ở cuối message. Với một series đã viết sẵn, git rebase --signoff origin/main sẽ thêm sign-off vào mọi commit, còn git interpret-trailers --in-place --trailer "Assisted-by: LLM" msg.txt dùng để chỉnh sửa file message.

Có 2 lỗi cần chuẩn bị trước. Squash merge sẽ rewrite commit message. Vì vậy, nếu dự án dùng squash, hãy lặp lại disclosure trong phần mô tả PR, nơi maintainer sẽ đọc. Review comment không phải là bản ghi chính thức, vì comment có thể bị sửa và không bao giờ được đưa vào git history.

Tính chính xác có tác động theo cả hai hướng. Assisted-by trên commit do bạn tự viết là thông tin thừa và làm giảm giá trị của các disclosure thật. Bỏ qua trailer này trên commit do agent viết là điều khiến mối quan hệ chấm dứt.

Signed-off-by thực sự xác nhận điều gì?

DCO là một văn bản ngắn, phiên bản 1.1, được công bố tại developercertificate.org và được sử dụng bởi kernel, QEMU cùng nhiều dự án khác. Việc thêm Signed-off-by: Your Name <you@example.com> nghĩa là bạn xác nhận nội dung đó. Hãy đọc kỹ những gì bạn đang xác nhận, vì hầu hết mọi người đều ký mà không bao giờ đọc nó.

Khoản (a) quy định rằng đóng góp "được tạo ra toàn bộ hoặc một phần bởi tôi và tôi có quyền gửi nó theo giấy phép mã nguồn mở được chỉ định trong tệp". Khoản (b) bao gồm các công việc dựa trên mã nguồn mở trước đó mà bạn có quyền truyền tải cùng với các sửa đổi. Khoản (c) bao gồm mã được chuyển cho bạn bởi một người đã xác nhận cùng nội dung đó. Khoản (d) quy định rằng bạn hiểu rằng đóng góp và thông tin cá nhân trong chữ ký của bạn là công khai và được lưu giữ vô thời hạn.

Hãy lưu ý những gì còn thiếu. DCO không bao giờ nói rằng bạn đã tự tay gõ từng ký tự. Nó nói rằng bạn có quyền gửi mã đó theo giấy phép này. Đó là lý do tại sao mã được tạo tự động (generated code) gây khó khăn ở đây: vấn đề không phải là quyền tác giả, mà là liệu bạn có thể giải trình về nguồn gốc của nó hay không. Hầu hết các dự án yêu cầu sign-off cũng yêu cầu tên thật, vì vậy bút danh sẽ không vượt qua được kiểm tra này. Hãy thêm dòng đó bằng git commit -s, lệnh này sẽ đọc user.name và user.email từ cấu hình git của bạn. Khi bot DCO từ chối PR của bạn và chỉ ra commit thiếu dòng này, git rebase --signoff origin/main và một lệnh force push vào branch của bạn sẽ khắc phục được vấn đề.

Ký một commit không giống với việc sign-off

git commit -s thêm một dòng văn bản vào commit. git commit -S tạo một chữ ký mã hóa trên đối tượng commit bằng key GPG hoặc SSH của bạn. Chúng giải quyết các vấn đề khác nhau. Chữ ký xác nhận rằng commit này đến từ người sở hữu key đó và không bị thay đổi kể từ lúc ký. Nó không nói gì về nguồn gốc của mã nguồn bên trong; vì vậy, một commit đã ký nhưng chứa mã nguồn được tạo tự động mà không khai báo vẫn là một commit đã ký, nhưng vi phạm chính sách. Sign-off là tuyên bố về nguồn gốc. Chữ ký là tuyên bố về danh tính. Các dự án yêu cầu cả hai sẽ đòi hỏi bạn thực hiện cả hai thao tác này.

Đừng bao giờ gửi code mà bạn không thể giải thích trong phần review

Đây là bài kiểm tra, và nó không thực sự nói về sự trung thực. Với mỗi dòng code: nó dùng để làm gì, và điều gì sẽ hỏng nếu thiếu nó? Nếu thiếu một trong hai câu trả lời, bản vá chưa sẵn sàng, vì bình luận review sẽ xuất hiện và câu trả lời của bạn sẽ lại là một vòng tạo code mới. Người review có thể nhận ra điều đó. Đó là khoảnh khắc một người đóng góp trở thành gánh nặng. Hãy tự hỏi câu tương tự về các trường hợp biên, input rỗng, đường dẫn lỗi, hoặc caller thứ hai.

Hãy chạy thử. Build nó, chạy bộ test suite của dự án, và viết một bản reproducer cho lỗi mà bạn khẳng định đã sửa. Tài liệu kernel đưa ra phương án dự phòng trung thực bằng những từ ngữ đơn giản: "Nếu bản sửa lỗi không thể build hoặc test, hoặc không thể tạo ra reproducer, hãy nói rõ điều đó: các maintainer hiện đang lãng phí quá nhiều thời gian để phân tích các báo cáo chưa xác minh và các bản sửa lỗi chưa được test." Viết "Tôi không thể test điều này trên phần cứng thực tế" không làm bạn mất gì cả. Ngụ ý rằng bạn đã làm điều đó sẽ khiến bạn bị loại khỏi dự án.

Hãy tự trả lời các bình luận review, bằng ngôn ngữ của chính bạn và theo thời gian của bạn. Một phản hồi xuất hiện sau bình luận ba mươi giây và lặp lại nó trong năm đoạn văn sẽ cho maintainer biết chính xác chuyện gì đã xảy ra. Hãy giữ cho diff nhỏ gọn. Bốn mươi dòng code mà bạn hiểu hoàn toàn có giá trị với dự án hơn là bốn trăm dòng refactor mà bạn chỉ giám sát. Nếu agent của bạn liên tục đưa ra nhiều hơn những gì bạn yêu cầu, một kỹ năng buộc nó thực hiện thay đổi nhỏ nhất có thể là một cách để giữ cho bản vá ở mức mà bạn vẫn có thể bảo vệ từng dòng một.

Lưu trữ hướng dẫn cho agent trong repository

Các chỉ dẫn bạn đưa cho agent là một phần của toolchain, vì vậy hãy xử lý chúng như code. Một file ở thư mục gốc của repository, thường là AGENTS.md, chứa lệnh build, lệnh test, format của commit message, yêu cầu sign-off và các quy tắc style đã được project ghi lại. File đó được version và có thể review, đồng thời giữ nguyên vào ngày mai như hôm nay. Việc gõ lại chỉ dẫn theo trí nhớ trong mỗi session tạo ra một patch khác nhau sau mỗi session, và bạn sẽ không biết session nào đã tạo ra patch bị từ chối. Cách viết AGENTS.md để agent và con người đều có thể đọc trình bày về chính file này. Các convention chỉ giải quyết một nửa số thông tin agent còn thiếu trong một codebase do bạn không viết, còn bản đồ có thể truy vấn về cấu trúc repository cung cấp call graph thực tế để agent dựa vào. Nhờ đó, kết quả trả về sẽ có cấu trúc phù hợp với code xung quanh thay vì dựa trên phỏng đoán.

Một lưu ý về repository của người khác. Đừng thực hiện đóng góp đầu tiên bằng một PR thêm file hướng dẫn agent vào dự án mà bạn không quản lý. Điều này trông giống như một nỗ lực áp đặt chính sách công cụ của dự án từ bên ngoài, và là cách nhanh nhất để tài khoản của bạn bị gắn với những thứ mà các maintainer đã quá mệt mỏi. Hãy giữ file đó trong fork của bạn cho đến khi có người yêu cầu.

Nơi bạn chạy agent cũng quan trọng vì lý do tương tự. Một agent có khả năng build dự án và chạy các bài test bên trong một sandbox mà bạn kiểm soát sẽ cung cấp cho bạn một bản patch đã được xác thực thực tế; đây là sự khác biệt giữa việc công khai sự hỗ trợ và công khai một dự đoán. Chạy coding agent trên VPS của riêng bạn đề cập đến thiết lập đó, và những khác biệt thực tế giữa Claude Code, Cursor, Codex và Copilot giải thích cách các công cụ này khác nhau trong quá trình sử dụng hàng ngày.

Quy trình sau khi chính sách thay đổi

  1. Tìm chính sách đã công bố trước khi viết bất cứ thứ gì: repository, tài liệu dành cho nhà phát triển, trang web, hoặc trình theo dõi lỗi.
  2. Nếu không có chính sách, hãy hỏi trong issue bằng một câu duy nhất và lưu lại câu trả lời.
  3. Công khai theo biểu mẫu mà dự án sử dụng, trong commit trailer, và lặp lại trong nội dung PR nếu dự án thực hiện squash commit.
  4. Ký xác nhận (sign off) bằng tên thật của bạn, với hiểu biết rằng dòng này là tuyên bố về quyền gửi mã nguồn của bạn.
  5. Tự review bản vá của chính mình như thể một người lạ đã viết nó, vì thực tế là đã có người làm vậy.

Mọi dự án được nêu trên trang này sẽ thay đổi vào thời điểm bạn đọc nó. Năm bước này thì không thay đổi.

FAQ

Tôi có phải công khai rằng mình đã dùng AI coding agent không?

Hãy kiểm tra từng project, vì câu trả lời phụ thuộc vào quy định riêng của project đó. Fedora yêu cầu công khai khi một phần đáng kể của contribution đến từ một tool mà không được chỉnh sửa. Linux kernel yêu cầu trailer Assisted-by. Tính đến 12 October 2026, Gentoo và QEMU không muốn nhận contribution đó. Nếu không có quy định bằng văn bản, bạn vẫn nên công khai trong commit trailer. Nếu maintainer phát hiện sau này, họ sẽ phản ứng với việc bạn bỏ sót thông tin chứ không phải với bản thân tool; phản ứng đó sẽ ảnh hưởng đến mọi thứ khác bạn đã gửi.

Những open source project nào cấm code do AI tạo ra?

Theo thông tin được kiểm tra vào 12 October 2026: Gentoo cấm từ April 2024; NetBSD xem output của LLM là code không đáng tin cậy và cần core team phê duyệt; QEMU từ chối contribution có nguồn gốc từ generated content; cùng một số ứng dụng GNOME, trong đó có Loupe và Calendar. Hãy đọc văn bản chính thức của từng project thay vì chỉ dựa vào danh sách này, vì quy định có thể thay đổi. Lưu ý điểm miễn trừ mà hầu hết các project này đều có: dùng model để tra cứu API, chạy static analysis hoặc hỗ trợ debug thường được chấp nhận, miễn là output của model không xuất hiện trong patch.

Sự khác nhau giữa Signed-off-by và signed commit là gì?

Signed-off-by là một dòng plain text do git commit -s thêm vào. Dòng này xác nhận developer certificate of origin, nghĩa là bạn có quyền submit code này theo license của project. Signed commit, được tạo bằng git commit -S, là chữ ký cryptographic trên commit object bằng GPG hoặc SSH key của bạn. Nó chứng minh commit đến từ key của bạn và chưa bị chỉnh sửa. Origin và identity là hai cam kết riêng biệt, vì vậy signed commit vẫn có thể vi phạm chính sách về AI.

Tôi có thể đặt thông tin công khai trong pull request description thay vì commit message không?

Hãy đặt thông tin đó trong commit message, vì đây là bản ghi được lưu trong git history và đi cùng code đến mọi người clone repository sau này. Pull request description có thể bị chỉnh sửa về sau và nằm trên hosting platform. Khi project dùng squash merge, bạn cũng nên thêm thông tin vào PR body, vì squash sẽ viết lại commit message và có thể làm mất trailer.

Pull request của tôi bị đóng vì được tạo bằng AI. Tôi nên làm gì?

Đừng tranh luận về chính sách trong thread, vì người đóng pull request không phải là người duy nhất viết ra quy định, và thread không phải nơi để thay đổi quy định đó. Hãy đọc nội dung chính sách, rồi quyết định xem bạn có thể đáp ứng hay không. Nếu project cấm patch được tạo bằng model, một bug report rõ ràng kèm reproducer và không có patch vẫn được hoan nghênh, đồng thời thường là contribution hữu ích hơn. Nếu quay lại với code, hãy gửi một thay đổi nhỏ mà bạn có thể giải thích và bảo vệ từng dòng.

Bài viết này có hữu ích không?

#open-source#contribution#llm-policy#disclosure#coding-agents