Czym jest GitHub? Kontrola wersji dla osób niebędących programistami

GitHub to strona internetowa, która przechowuje kod projektów programistycznych wraz z ich pełną historią, dzięki czemu widzisz każdą zmianę, cofasz błędy i pracujesz nad tym samym projektem z innymi osobami. Opiera się na Git, darmowym oprogramowaniu, które zapisuje migawki plików projektu w czasie. Git prowadzi historię; GitHub to internetowy dom, w którym ta historia jest udostępniana, kopiowana w bezpiecznym miejscu i omawiana.

Jeśli budujesz z AI, GitHub służy głównie do dwóch rzeczy: posiadania własnej kopii kodu poza narzędziem, w którym go stworzyłeś, oraz przekazania go programiście w formacie, z którym on już pracuje.

Dlaczego to ważne, gdy budujesz z AI

Narzędzie do budowania aplikacji z AI pisze i zmienia dużo kodu bardzo szybko, a nie każda zmiana jest ulepszeniem. Kontrola wersji pozwala to bezpiecznie kontrolować.

• Cofaj z pewnością. Każda zapisana zmiana to migawka. Jeśli AI coś zepsuje, wracasz do ostatniej dobrej wersji.
• Własność. Kod na Twoim koncie GitHub pozostaje Twój, jeśli zmienisz narzędzie, przestaniesz za nie płacić albo chcesz drugiej opinii.
• Praca z programistami. Prawie każdy programista używa Gita codziennie. Repozytorium pozwala mu przejrzeć to, co napisało AI, poprawić to i odesłać zmiany z powrotem.
• Wdrażanie gdzie indziej. Wiele platform hostingowych potrafi wdrożyć aplikację bezpośrednio z repozytorium GitHub.

Codzienna analogia: śledzenie zmian i dysk współdzielony

Wyobraź sobie dokument z włączonym śledzeniem zmian, przechowywany na dysku współdzielonym.

• Git to śledzenie zmian: każda edycja jest zapisana wraz z tym, kto ją zrobił, kiedy i dlaczego, a Ty możesz wrócić do dowolnej wersji.
• GitHub to dysk współdzielony: dokument leży online, inni mogą dostać jego kopię, a jest miejsce na komentarze i zatwierdzenia.
• Gałąź (branch) to jak zapisanie kopii o nazwie „wersja robocza — nowa sekcja cennika”, żebyś mógł eksperymentować bez ruszania wersji, na której wszyscy polegają. Jeśli eksperyment się uda, scalasz go z powrotem.

Różnica względem dokumentu to skala. Aplikacja to setki plików, a Git śledzi je wszystkie razem, więc migawka to stan całego projektu naraz.

Terminy Git i GitHub, które napotkasz

Dwie rzeczy warto podkreślić. Po pierwsze, historia Gita jest z założenia trwała: jeśli hasło zostanie zapisane i wysłane, usunięcie go w późniejszym commicie nie usuwa go z historii. Po drugie, commit jest tylko tak użyteczny, jak jego opis. „Napraw podwójne liczenie rezerwacji, gdy dwie osoby rezerwują jednocześnie” pomoże Ci później; „aktualizacja” nie pomoże.

Przykład krok po kroku: przekazanie aplikacji zbudowanej z AI freelancerowi

Zbudowałeś portal dla klientów narzędziem do budowania z AI. Działa, ale chcesz, żeby freelancer-programista dodał trudną integrację z Twoim oprogramowaniem księgowym.

1. Podłącz projekt do nowego prywatnego repozytorium GitHub i wyślij (push). Repozytorium zawiera teraz kod i jego historię.
2. Sprawdź, co w nim jest. Otwórz repozytorium na GitHub. Nie powinno tam być pliku .env ani kluczy API. Sekrety zostają w ustawieniach platformy i ewentualnie przekazujesz je freelancerowi osobno — zob. zmienne środowiskowe i sekrety.
3. Zaproś freelancera jako współpracownika wyłącznie do tego repozytorium.
4. Pracuje on na gałęzi o nazwie w rodzaju accounting-sync, robi commity po drodze i po zakończeniu otwiera pull request.
5. Ty sprawdzasz pull request. Nawet bez czytania kodu możesz przeczytać opis, zobaczyć, które pliki się zmieniły, i zadać pytania w komentarzach.
6. Scal zmiany, gdy będziesz zadowolony, a potem pobierz (pull) je z powrotem do narzędzia do budowania, żebyś Ty i AI mogli dalej pracować na nowej wersji.

Po drodze widzisz dokładnie, co się zmieniło, i możesz to w razie potrzeby cofnąć. To cała wartość kontroli wersji w jednym przepływie pracy. Jeśli zastanawiasz się, czy w ogóle zatrudnić programistę, zob. zatrudnić programistę czy budować z AI.

Częste błędy i nieporozumienia

• „GitHub i Git to to samo”. Git działa bez GitHub; alternatywy, takie jak GitLab i Bitbucket, także hostują repozytoria Git.
• „GitHub uruchomi moją aplikację”. GitHub przechowuje kod. Udostępnianie aplikacji publiczności to hosting stron, osobna usługa (choć niektóre hosty wdrażają z GitHub).
• Zapisywanie sekretów w commitach. To najbardziej szkodliwy i najczęstszy błąd. Dodaj pliki .env do .gitignore i zmień każdy klucz, który kiedykolwiek został wysłany.
• Jedna gałąź i brak opisów. Wystarcza do solowych eksperymentów, ale nadawaj commitom jasne opisy i używaj gałęzi przy wszystkim, co ryzykowne.
• Edytowanie w dwóch miejscach naraz. Jeśli zmieniasz kod na GitHub i w narzędziu do budowania z AI bez pobierania zmian pomiędzy, powstają konflikty. Wybierz jedno miejsce do edycji naraz i synchronizuj przed przełączeniem.
• Uznanie prywatnego repozytorium za kopię zapasową wszystkiego. Zawiera ono kod, a nie zawartość bazy danych ani przesłane pliki. Te potrzebują własnych kopii zapasowych.

O co poprosić narzędzie do budowania z AI

• „Dodaj .gitignore, który wyklucza .env, foldery zależności i wynik kompilacji.”
• „Napisz README, które wyjaśnia instalację, jakie zmienne środowiskowe są potrzebne (tylko nazwy) i jak uruchomić aplikację.”
• „Dodaj .env.example ze wszystkimi nazwami zmiennych i bez prawdziwych wartości.”
• „Używaj jasnych, opisowych komunikatów commitów dla każdej zmiany.”

Te cztery prośby tworzą repozytorium, które programista może przejąć w kilka minut. Aby przenieść aplikację na własne serwery, zob. jak wyeksportować i hostować u siebie aplikację zbudowaną z AI, a aby ją wzmocnić przed prawdziwymi użytkownikami, jak przenieść prototyp AI na produkcję.

GitHub a Mythex

Mythex prowadzi historię za Ciebie w każdym planie: po każdej udanej turze agenta zapisuje punkt kontrolny, czyli migawkę Git, do której możesz wrócić. W planie Pro możesz połączyć GitHub i wysyłać lub pobierać projekt z własnego repozytorium albo pobrać cały projekt jako archiwum; sekrety i zainstalowane zależności są pomijane przy eksporcie. Tutaj GitHub służy do synchronizacji kodu, a nie do logowania się do Mythex. Zob. GitHub, eksport i import w dokumentacji oraz cennik, aby sprawdzić, co zawiera każdy plan.

Pytania