Import z GitHubu a pull request z ColdHost AI krok za krokem
Jak připojit GitHub k ColdHost AI, naimportovat repozitář do projektu, nechat AI udělat změny a odeslat je jako novou větev nebo pull request.
Pokud máte kód na GitHubu, nemusíte ho do ColdHost AI nahrávat ručně jako ZIP. Repozitář naimportujete přímo do projektu, AI v něm provede změny a vy je pošlete zpět jako novou větev nebo rovnou jako pull request. Hlavní větev zůstane nedotčená, dokud změny sami neschválíte.
Jak celý tok vypadá
GitHub repo ──import──▶ Projekt v ColdHost AI ──AI úpravy──▶ push jako větev / PR ──▶ review a merge na GitHubu
Celé je to postavené tak, abyste měli kontrolu: AI nikdy nemusí psát přímo do main.
1. Připojte GitHub
V nastavení aplikace (sekce s integracemi) připojte svůj GitHub účet. Po autorizaci uvidí ColdHost AI repozitáře, ke kterým jste mu dali přístup. Pokud GitHub nabídne výběr konkrétních repozitářů, je bezpečnější povolit jen ty, se kterými chcete pracovat.
2. Naimportujte repozitář do projektu
Založte projekt a zvolte import z GitHubu. Vyberte repozitář a případně větev, ze které chcete vycházet. Soubory se načtou do projektu stejně, jako byste je nahráli ručně.
Tip: pokud je repozitář velký, je dobré mít v něm rozumný .gitignore, aby se do projektu nedostaly vygenerované soubory. Typický základ pro Node.js projekt:
node_modules/
dist/
.env
*.log
coverage/
3. Zadejte změnu
Pište konkrétně a odkazujte na soubory:
V src/components/LoginForm.tsx přidej validaci e-mailu před odesláním.
Chybovou hlášku zobraz pod polem stejně jako u hesla.
Uprav i test v src/components/__tests__/LoginForm.test.tsx.
AI upraví soubory buď celým přepsáním, nebo cílenými SEARCH/REPLACE úpravami. Projděte si, které soubory se změnily, a případně požádejte o doladění.
4. Push jako větev, nebo pull request
Máte dvě možnosti:
| Volba | Co se stane | Kdy použít |
|---|---|---|
| Nová větev | změny se pushnou do nové větve | chcete si změny nejdřív stáhnout a otestovat lokálně |
| Pull request | vytvoří se větev a k ní PR | chcete rovnou review, CI a merge přes GitHub |
Větev pojmenujte popisně, například feature/email-validation nebo fix/login-redirect. Z názvu by mělo být jasné, co obsahuje.
5. Zkontrolujte změny
Lokálně
git fetch origin
git switch feature/email-validation
git log --oneline main..HEAD
git diff main...HEAD
npm test
Tři tečky v git diff main...HEAD ukážou jen změny ve větvi oproti bodu, kde se oddělila od main.
Na GitHubu
V pull requestu použijte záložku Files changed. Pokud máte nastavené GitHub Actions, spustí se testy automaticky. Teprve když CI projde a změny dávají smysl, proveďte merge.
S nástrojem GitHub CLI si PR můžete stáhnout jedním příkazem:
gh pr checkout 42
gh pr diff 42
Ochrana hlavní větve
Doporučujeme na GitHubu zapnout branch protection pro main (Settings → Branches): vyžadovat pull request a úspěšné CI před mergem. Pak se žádná změna – vaše ani od AI – nedostane do main bez kontroly.
Časté problémy
- Konflikty při merge – pokud se
mainmezitím změnil, vyřešte konflikty lokálně:
git switch feature/email-validation
git fetch origin
git rebase origin/main
# vyřešit konflikty, pak:
git add .
git rebase --continue
git push --force-with-lease
- AI nevidí soubor – zkontrolujte, zda nebyl vynechán
.gitignorenebo zda jste importovali správnou větev. - Příliš velký PR – rozdělte zadání na menší části a pro každou udělejte samostatný PR. Malé PR se lépe reviewují.
Shrnutí
Import z GitHubu ušetří ruční přenášení souborů a push jako pull request zachová standardní proces review. AI tak pracuje jako další člen týmu, jehož změny jdou přes stejnou kontrolu jako ty ostatní.