SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor · Zaktualizowano 2026-10-24

Kod wspomagany przez AI a zasady open source

Sprawdź politykę projektu przed wysłaniem pull request i dodaj informację o użyciu AI w trailerze commitu. Zasady projektów open source mogą się różnić.

Co należy zrobić przed wysłaniem kodu wspomaganego przez AI do repozytorium upstream

Projekty open source publikują obecnie zasady dotyczące kodu wspomaganego przez AI, a wytyczne te nie są ze sobą spójne. Dlatego nawyk jest prosty: przed napisaniem poprawki należy odnaleźć odpowiednią politykę i rzetelnie poinformować o użyciu narzędzi przy wysyłaniu kodu. Jedna zasada dotyczy obu przypadków. Nigdy nie należy przesyłać linii kodu, której nie można wyjaśnić podczas przeglądu.

Poprawna poprawka zostanie odrzucona, jeśli projekt zakazuje kodu wygenerowanego lub jeśli ukryto jego pochodzenie. Koszt ponosi autor, a konsekwencje pozostają, ponieważ opiekun projektu, który odkryje zatajenie informacji, nie ma powodu, by ufać reszcie historii zmian danego programisty. Najpierw kilka wyjaśnień, ponieważ polityki posługują się tymi terminami. LLM (large language model) to model stojący za agentem programistycznym. PR (pull request) w serwisie GitHub to odpowiednik MR (merge request) w serwisie GitLab, a poniższe uwagi dotyczą obu tych rozwiązań. DCO (developer certificate of origin) to linia potwierdzenia (sign-off) na końcu komunikatu commitu, która okazuje się być sednem całego sporu.

Stan polityk open source dotyczących kodu generowanego przez AI

Projekty podzieliły się na cztery grupy. Każdy poniższy przykład jest opatrzony datą, ponieważ dokumenty te podlegają zmianom.

Zakaz. Rada Gentoo przegłosowała 14 kwietnia 2024 roku, że „wyraźnie zabrania się wnoszenia do Gentoo jakichkolwiek treści stworzonych przy pomocy narzędzi sztucznej inteligencji przetwarzających język naturalny”. Wytyczne dotyczące commitów w NetBSD określają dane wyjściowe z LLM jako „kod skażony”, który „nie może zostać zatwierdzony bez uprzedniej pisemnej zgody rdzenia projektu”. Dokument dotyczący pochodzenia kodu QEMU, według stanu na 12 października 2026 roku, nadal stanowi, że projekt będzie „ODRZUCAŁ wszelkie wkłady, co do których istnieje podejrzenie, że zawierają treści wygenerowane przez AI lub z nich pochodzą”.

Tylko analiza. Większość zakazów jest węższa, niż sugerują nagłówki. Dokument QEMU wskazuje, że polityka „nie ma zastosowania do innych sposobów wykorzystania AI, takich jak badanie API lub algorytmów, analiza statyczna czy debugowanie, pod warunkiem, że ich wynik nie jest włączany do wkładów”. Dozwolone jest używanie agenta do czytania kodu. Niedozwolone jest publikowanie tego, co wygenerował. To rozróżnienie stanowi linię podziału w większości restrykcyjnych projektów i jest często pomijane.

Wymagane ujawnienie. Rada Fedora zatwierdziła politykę dotyczącą wkładów wspomaganych przez AI w październiku 2025 roku. Zezwala ona na korzystanie z narzędzi, przenosząc odpowiedzialność na osobę: współtwórca jest autorem, ponosi pełną odpowiedzialność za cały wkład i musi ujawnić, kiedy jego znacząca część pochodzi z narzędzia bez wprowadzonych zmian. Jądro Linux dodało stronę dotyczącą asystentów kodowania do swojej dokumentacji procesowej w styczniu 2026 roku, wraz z załącznikiem do rejestrowania narzędzia oraz rygorystyczną zasadą dotyczącą tego, kto może zatwierdzić zmiany.

Brak zapisów. Jest to nadal najczęstszy przypadek. Preprint z maja 2026 roku, badający 1000 popularnych repozytoriów GitHub, wykazał, że tylko 118 z nich posiada jakąkolwiek pisemną politykę dotyczącą AI. Brak regulacji nie oznacza przyzwolenia. Przed napisaniem poprawki należy zadać pytanie w systemie śledzenia zgłoszeń w jednym zdaniu; odpowiedź stanie się publicznym zapisem, na który można się później powołać.

Dlaczego opiekunowie wprowadzili te zasady

Pierwszym powodem jest obciążenie przeglądem kodu, a rachunek jest prosty. Agent generuje wiarygodny merge request o długości 400 linii w minutę. Rzetelne sprawdzenie takiego zgłoszenia zajmuje opiekunowi całe popołudnie, a większość opiekunów to wolontariusze. Koszt przesłania kodu spadł niemal do zera. Koszt przeglądu nie zmienił się wcale.

Projekt curl pokazuje końcowy etap tej krzywej. Daniel Stenberg poinformował w połowie 2025 roku, że około jedna piąta zgłoszeń bezpieczeństwa napływających przez program bug bounty to tak zwany AI slop: zgłoszenia, które wymieniają rzeczywiste funkcje i ścieżki kodu, opisują wiarygodny atak, ale nie zawierają żadnej wartości. Projekt zakończył program nagród na początku 2026 roku, zamiast finansować zalew takich zgłoszeń. Były to zgłoszenia, a nie poprawki, ale mechanizm jest ten sam, który sprawia, że opiekun otwiera Twój PR, będąc już zmęczonym.

Projekt GNOME Calendar opisał ten problem za pomocą etykiety. W czerwcu 2026 roku wprowadzono oznaczenie "Probabilistically Automated" dla merge requestów wykazujących "znaczną lub całkowitą zależność od sztucznej inteligencji przy generowaniu kodu". Według stanu na 12 października 2026 roku etykieta ta obejmuje "znaczną lub całkowitą zależność od AI / LLM / stochastycznych papug przy generowaniu kodu lub zgłoszeń błędów" i precyzyjnie wskazuje objawy: "Zazwyczaj towarzyszy temu brak odpowiednich testów oraz pisanie zgłoszeń lub finalizowanie poprawek w oparciu o wiarygodnie brzmiące zamierzone działanie, a nie poprawność kodu". Przeczytaj to ostatnie zdanie dwukrotnie. Kod wygląda, jakby powinien działać. Nikt nie sprawdził, czy faktycznie działa.

Drugim powodem jest pochodzenie, czyli źródło kodu oraz licencja. QEMU jasno przedstawia ten konflikt: podpisanie zgłoszenia (sign-off) oznacza, że "w pełni rozumiesz status praw autorskich i licencji treści", które wnosisz, a status prawny wyników generowanych przez modele jest nieuregulowany. Rada projektu Gentoo podała ten sam powód, obok kwestii jakości i etyki. Nie musisz zgadzać się z taką interpretacją prawną. Musisz jednak zauważyć, że to decyzja opiekuna, a nie Twoja.

Jak znaleźć politykę AI projektu?

Należy sprawdzić poniższe lokalizacje w podanej kolejności.

  • CONTRIBUTING.md w katalogu głównym repozytorium, następnie .github/CONTRIBUTING.md, a potem każdy plik DCO znajdujący się obok.
  • Dokumentacja programistyczna. QEMU przechowuje swoje zasady w docs/devel/code-provenance.rst. Jądro systemu przechowuje swoje w Documentation/process/coding-assistants.rst.
  • Strona internetowa projektu lub wiki. Polityka Gentoo znajduje się na stronie wiki rady, a polityka NetBSD w wytycznych dotyczących commitów.
  • System śledzenia zgłoszeń oraz archiwum listy mailingowej. Polityka zazwyczaj istnieje tam przez miesiące, zanim ktokolwiek zapisze ją w repozytorium.

Z poziomu kopii roboczej większość informacji można uzyskać za pomocą jednego polecenia grep:

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

Następnie należy przeanalizować historię projektu, ponieważ zatwierdzone konwencje są ważniejsze niż jakiekolwiek ich podsumowanie:

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

Liczba obok wartości znacznika wskazuje na formę faktycznie stosowaną w danym projekcie. Pusty wynik oznacza, że nikt nie dokonał ujawnienia w tej formie, co również stanowi istotną informację. Jeśli projekt znajduje się na GitHubie, a sam przepływ pracy jest nowy, sekcja jak działają pull requesty i forki na GitHubie wyjaśnia mechanikę, na której opiera się ten rozdział.

Ujawnienie w trailerze commita, a nie w komentarzu

Trailer to linia Key: value w ostatnim akapicie wiadomości commita. Git używa tego formatu dla Signed-off-by: oraz Co-authored-by:, a narzędzia potrafią go parsować, dlatego jest to jedyna forma ujawnienia, która trafia wraz z kodem do drzewa projektu.

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>

Jądro systemu dokumentuje ten format jako Assisted-by: LLM [TOOL1] [TOOL2], gdzie opcjonalne nazwy narzędzi odnoszą się do wyspecjalizowanych analizatorów, takich jak coccinelle, sparse, smatch lub clang-tidy, a nigdy do git, gcc czy edytora tekstu. W sierpniu 2026 roku jądro usunęło wymaganie podawania nazwy agenta i modelu, ponieważ podawanie nazwy modelu „stanowi darmową reklamę dla firm produkujących oprogramowanie własnościowe, nie wnosząc przy tym żadnych użytecznych informacji”. Dokumentacja wyraźnie określa ograniczenia tej linii: „Agenci AI NIE MOGĄ dodawać tagów Signed-off-by. Jedynie ludzie mogą prawnie certyfikować Developer Certificate of Origin (DCO)”. Ujawnienie umieszcza się w Assisted-by. Twoje imię i nazwisko umieszcza się w Signed-off-by. Nigdy nie pozwól narzędziu na wpisanie drugiego elementu i nigdy nie pozwól mu wymyślać adresu Co-authored-by, który do nikogo nie należy.

Nazwy bywają różne, więc skopiuj tę lokalną, zamiast tworzyć własną. Patch wysłany na listę dyskusyjną QEMU w maju 2026 roku proponował złagodzenie zakazu tego projektu dla zmian mechanicznych, testów, dokumentacji oraz poprawek błędów o długości do 20 linii, rejestrowanych za pomocą trailera takiego jak AI-used-for: tests, docs. Na dzień 12 października 2026 roku patch ten nie został scalony, RFC z września 2026 roku od tego samego autora proponuje szerszą przebudowę opartą na tym samym trailerze, a zatwierdzony dokument nadal odrzuca treści wygenerowane automatycznie. Jeden z projektów zmienił swoje stanowisko dwukrotnie między 2023 a 2026 rokiem. Kolejna zmiana nie będzie czekać na Ciebie, dlatego metoda jest ważniejsza niż lista.

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 wymaga Git w wersji 2.32 lub nowszej. Drugie polecenie powinno zwrócić wartość bezpośrednio do użytkownika. Pusta linia oznacza, że git nie sparsował trailera, co niemal zawsze wynika z obecności pustej linii lub zwykłego zdania wewnątrz bloku trailerów na dole wiadomości. Dla serii commitów, które już zostały napisane, git rebase --signoff origin/main dodaje podpis do każdego commita, a git interpret-trailers --in-place --trailer "Assisted-by: LLM" msg.txt edytuje plik wiadomości.

Należy uwzględnić dwa scenariusze awaryjne. Squash merge nadpisuje wiadomość commita, więc w projektach stosujących tę metodę, powtórz ujawnienie w opisie PR, gdzie przeczyta je opiekun projektu. Komentarz w recenzji nie stanowi zapisu, ponieważ komentarze można edytować i nigdy nie trafiają one do historii git.

Dokładność działa w obie strony. Assisted-by w commicie napisanym ręcznie to szum, który obniża wartość Twoich rzeczywistych ujawnień. Pominięcie tego znacznika w commicie wygenerowanym przez agenta jest działaniem, które kończy relację zaufania.

Co faktycznie poświadcza Signed-off-by?

DCO to krótki tekst w wersji 1.1, opublikowany pod adresem developercertificate.org i stosowany w jądrze systemu, QEMU oraz wielu innych projektach. Dodanie Signed-off-by: Your Name <you@example.com> oznacza, że składasz stosowne oświadczenie. Należy zapoznać się z treścią tego, co się podpisuje, ponieważ większość osób składa podpis bez uprzedniego przeczytania dokumentu.

Punkt (a) stanowi, że wkład „został stworzony w całości lub w części przeze mnie i mam prawo przesłać go na licencji open source wskazanej w pliku”. Punkt (b) obejmuje pracę opartą na wcześniejszym kodzie open source, który masz prawo przekazać dalej wraz z modyfikacjami. Punkt (c) dotyczy kodu przekazanego przez osobę, która złożyła to samo oświadczenie. Punkt (d) informuje, że rozumiesz, iż wkład oraz dane osobowe zawarte w podpisie są publiczne i przechowywane bezterminowo.

Zwróć uwagę na to, czego brakuje w treści. DCO nigdy nie stwierdza, że samodzielnie wpisałeś każdy znak. Dokument mówi jedynie, że masz prawo przesłać kod na danej licencji. Dlatego wygenerowany kod stanowi tutaj problematyczną kwestię: nie chodzi o autorstwo, lecz o to, czy potrafisz wykazać pochodzenie kodu. Większość projektów wymagających podpisu wymaga również podania prawdziwego imienia i nazwiska, więc pseudonim nie przejdzie weryfikacji. Dodaj linię za pomocą git commit -s, co odczyta user.name oraz user.email z Twojej konfiguracji git. Gdy bot DCO odrzuci Twój PR i wskaże commit, w którym brakuje tej linii, użycie git rebase --signoff origin/main oraz wymuszenie wypchnięcia (force push) do Twojej gałęzi rozwiąże problem.

Podpisanie commita nie jest tym samym, co "sign-off"

git commit -s dodaje wiersz tekstu. git commit -S tworzy kryptograficzny podpis obiektu commit przy użyciu klucza GPG lub SSH. Odpowiadają one na różne pytania. Podpis zaświadcza, że commit pochodzi od posiadacza danego klucza i nie został zmieniony od momentu podpisania. Nie informuje on jednak o pochodzeniu zawartego w nim kodu, więc podpisany commit zawierający nieujawniony kod wygenerowany automatycznie jest poprawnie podpisany, ale nadal narusza zasady. Sign-off jest deklaracją dotyczącą pochodzenia. Podpis jest deklaracją dotyczącą tożsamości. Projekty wymagające obu tych elementów będą prosić o oba.

Nigdy nie zgłaszaj kodu, którego nie potrafisz wyjaśnić podczas przeglądu

To jest test i wcale nie chodzi w nim o uczciwość. Dla każdej linii kodu: po co ona jest i co przestanie działać bez niej? Jeśli brakuje którejkolwiek z tych odpowiedzi, poprawka nie jest gotowa, ponieważ komentarz recenzenta i tak się pojawi, a Twoja odpowiedź będzie wymagała kolejnej rundy generowania. Recenzenci potrafią to rozpoznać. To moment, w którym współtwórca staje się obciążeniem. Zadaj to samo pytanie o przypadki brzegowe, puste dane wejściowe, ścieżkę błędu oraz drugiego wywołującego.

Uruchom to. Zbuduj projekt, wykonaj zestaw testów i napisz reproduktor błędu, który rzekomo naprawiasz. Dokumentacja jądra podaje uczciwą alternatywę w prostych słowach: „Jeśli poprawka nie mogła zostać zbudowana lub przetestowana, albo jeśli nie udało się stworzyć reproduktora, powiedz to wprost: opiekunowie marnują obecnie zbyt wiele czasu na analizowanie niezweryfikowanych zgłoszeń i nietestowanych poprawek”. Napisanie „Nie mogłem przetestować tego na rzeczywistym sprzęcie” nic Cię nie kosztuje. Sugerowanie, że to zrobiłeś, kosztuje Cię udział w projekcie.

Odpowiadaj na komentarze z przeglądu samodzielnie, własnymi słowami i w swoim czasie. Odpowiedź, która pojawia się trzydzieści sekund po komentarzu i powtarza go w pięciu akapitach, mówi opiekunowi dokładnie, co się stało. Dbaj również o to, by diff był mały. Czterdzieści linii, które w pełni rozumiesz, jest dla projektu warte więcej niż czterystulinijkowy refaktoryzacja, którą nadzorowałeś. Jeśli Twój agent ciągle zwraca więcej, niż prosiłeś, umiejętność ograniczenia go do najmniejszej działającej zmiany jest jednym ze sposobów na utrzymanie poprawki w rozmiarze, który wciąż możesz obronić linijka po linijce.

Przechowywanie instrukcji dla agenta w repozytorium

Instrukcje przekazywane agentowi są częścią łańcucha narzędzi, dlatego należy traktować je jak kod. Plik w katalogu głównym repozytorium, zwykle AGENTS.md, zawiera polecenie budowania, polecenie testów, format komunikatu zatwierdzenia, wymaganie dotyczące sign-off oraz zasady stylu udokumentowane już w projekcie. Ten plik jest wersjonowany i podlega przeglądowi. Jego zawartość pozostaje taka sama następnego dnia. Instrukcje przepisywane z pamięci podczas każdej sesji prowadzą za każdym razem do innego patcha. Nie będzie wiadomo, podczas której sesji powstał patch odrzucony w przeglądzie. Pisanie pliku AGENTS.md czytelnego zarówno dla agenta, jak i człowieka omawia sam plik. Konwencje to tylko część informacji, których agentowi brakuje w kodbase, którego nie napisano samodzielnie. Przeszukiwalna mapa struktury repozytorium dostarcza mu rzeczywistego grafu wywołań, na którym może oprzeć pracę. Dzięki temu zwracany kod pasuje do otaczającego go kodu, zamiast przypominać zgadywanie.

Należy zachować ostrożność w przypadku repozytoriów innych osób. Pierwszym wkładem w projekt, którego nie jesteś opiekunem, nie powinien być PR dodający plik z instrukcjami dla agenta. Jest to odbierane jako próba narzucenia polityki narzędziowej projektu z zewnątrz i stanowi szybki sposób na powiązanie własnego konta z działaniami, którymi opiekunowie są już zmęczeni. Przechowuj ten plik w swoim forku, dopóki ktoś o niego nie poprosi.

Miejsce uruchomienia agenta ma znaczenie z tego samego powodu. Agent, który potrafi zbudować projekt i uruchomić testy w kontrolowanym środowisku typu sandbox, dostarcza patch, który został faktycznie zweryfikowany. Jest to różnica między ujawnieniem wsparcia a ujawnieniem przypuszczenia. Uruchamianie agenta programistycznego na własnym VPS opisuje taką konfigurację, a praktyczne różnice między Claude Code, Cursor, Codex i Copilot wyjaśnia codzienne różnice w działaniu tych narzędzi.

Metoda postępowania po zmianie polityki

  1. Przed przystąpieniem do pracy należy ustalić obowiązującą politykę: w repozytorium, dokumentacji dla programistów, witrynie internetowej lub systemie śledzenia błędów.
  2. W przypadku braku polityki należy zadać pytanie w zgłoszeniu (issue) w jednym zdaniu i zachować odpowiedź.
  3. Ujawnienie informacji powinno nastąpić w formie wymaganej przez projekt, w stopce commitu (commit trailer), z powtórzeniem w treści PR, jeśli projekt stosuje squashing.
  4. Należy podpisać się własnym imieniem i nazwiskiem, mając świadomość, że linia ta stanowi oświadczenie o prawie do przesłania kodu.
  5. Własną poprawkę należy przejrzeć tak, jakby napisał ją ktoś obcy, ponieważ w istocie tak jest.

Każdy projekt wymieniony na tej stronie zmieni swoje położenie do czasu, gdy użytkownik będzie czytał ten tekst. Pięć powyższych kroków pozostaje niezmiennych.

FAQ

Czy muszę ujawnić, że użyłem agenta programistycznego AI?

Sprawdź zasady projektu, ponieważ odpowiedź jest ustalana lokalnie. Fedora wymaga ujawnienia informacji, gdy znacząca część wkładu pochodzi z narzędzia bez wprowadzonych zmian. Jądro Linux prosi o użycie trailera Assisted-by. Gentoo i QEMU, według stanu na 12 października 2026, w ogóle nie akceptują takiego wkładu. Jeśli brak jest pisemnych wytycznych, ujawnij ten fakt w commit trailerze. Utrzymujący projekt, który dowie się o tym później, zareaguje na zatajenie informacji, a nie na samo narzędzie, a ta reakcja wpłynie na ocenę wszystkich innych przesłanych przez Ciebie materiałów.

Które projekty open source zakazują kodu wygenerowanego przez AI?

Według stanu na 12 października 2026: Gentoo od kwietnia 2024, NetBSD, które traktuje dane wyjściowe LLM jako kod skażony wymagający zatwierdzenia przez rdzeń zespołu, QEMU, które odrzuca wkłady pochodzące z wygenerowanej treści, oraz kilka aplikacji GNOME, w tym Loupe i Calendar. Zapoznaj się z dokumentacją każdego projektu zamiast polegać na tej liście, ponieważ informacje te ulegną przedawnieniu. Zwróć uwagę na wyjątek wspólny dla większości z nich: używanie modelu do badania API, uruchamiania analizy statycznej lub pomocy w debugowaniu jest zazwyczaj dozwolone, o ile jego dane wyjściowe nie znajdują się w patchu.

Jaka jest różnica między Signed-off-by a podpisanym commitem?

Signed-off-by to linia zwykłego tekstu dodawana przez git commit -s. Potwierdza ona developer certificate of origin, co oznacza, że masz prawo przesłać ten kod na licencji projektu. Podpisany commit, wykonany za pomocą git commit -S, to kryptograficzny podpis obiektu commita przy użyciu Twojego klucza GPG lub SSH. Dowodzi on, że commit pochodzi z Twojego klucza i nie został zmieniony. Pochodzenie i tożsamość to odrębne deklaracje, więc podpisany commit nadal może naruszać politykę dotyczącą AI.

Czy mogę umieścić informację w opisie pull requesta zamiast w wiadomości commita?

Umieść ją w wiadomości commita, ponieważ jest to zapis, który trafia do historii git i towarzyszy kodowi każdemu, kto później sklonuje repozytorium. Opis pull requesta może zostać później edytowany i istnieje tylko na platformie hostingowej. Dodaj informację również do treści PR, jeśli projekt stosuje squash merge, ponieważ squash nadpisuje wiadomość commita i może usunąć trailer.

Mój pull request został zamknięty, ponieważ został wygenerowany przez AI. Co teraz?

Nie dyskutuj o polityce w wątku, ponieważ osoba zamykająca go nie stworzyła tej zasady samodzielnie, a wątek nie jest miejscem, w którym można ją zmienić. Przeczytaj tekst polityki, a następnie zdecyduj, czy jesteś w stanie ją spełnić. Tam, gdzie projekt zakazuje wygenerowanych patchów, jasny raport o błędzie z reproduktorem, ale bez patcha, jest nadal mile widziany i często stanowi bardziej użyteczny wkład. Jeśli wrócisz z kodem, wróć z małą zmianą, którą potrafisz obronić linijka po linijce.

Czy ten artykuł był przydatny?

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