github-and-vscode-vibecoding-config

Wersja dokumentu: gpt5.5-2026.05.16-0.3.0

Kompletny zestaw skryptów PowerShell do automatycznego przygotowania świeżego Windows 11 pod:

• VS Code / VS Code Insiders,
• GitHub Copilot Pro / Pro+,
• vibe-coding dla aplikacji web, stron firmowych, web games i Android hybrid apps,
• backend/API/devops oraz automatyzację Windows.

Aktualny plan i TODO

Szczegółowy plan wdrożenia oraz lista TODO dla kolejnych AI znajduje się w:

• IMPLEMENTATION_PLAN.md

Zasady dokumentacji

• Dokumentacja w tym repo musi być aktualizowana na bieżąco przy każdej zmianie skryptów, konfiguracji, workflow albo zakresu repo.
• README, plan wdrożenia i wszystkie skille mają pozostawać spójne z aktualnym stanem plików w scripts/.
• Każdy dokument Markdown w repo musi zawierać oznaczenie wersji w formacie model-data-wersja, np. gpt5.4-2026.05.17-0.2.9.
• Każda zmiana merytoryczna dokumentu wymaga równoczesnego zaktualizowania jego oznaczenia wersji.

Co instaluje i konfiguruje

• Edytory: VS Code oraz opcjonalnie VS Code Insiders.
• Copilot/GitHub: Copilot, Copilot Chat, GitHub PR, GitHub Actions, GitHub CLI.
• Web/business: Node.js, pnpm, yarn, Vite, Next.js, Angular, Astro, Tailwind, ESLint, Prettier, Stylelint.
• Game/web: Live Server, Godot tools, Markdown/Mermaid, CLI pod prototypowanie web games.
• Android hybrid: Android Studio, JDK, Ionic, Capacitor, native-run, Cordova.
• Backend/devops: Docker, Dev Containers, Kubernetes, YAML, Terraform, Postman/Thunder Client.
• Python/.NET/Go/Rust: runtime’y, rozszerzenia i podstawowe narzędzia.
• Skille: lokalne workflow dla web games i profesjonalnych stron firmowych kopiowane do ~\.vibe-coding\skills.

Struktura

• /scripts/Install-VibeCodingEnvironment.ps1 – główny, automatyczny instalator.
• /scripts/Configure-VSCode.ps1 – instalacja rozszerzeń z scripts/config/vscode-extensions.txt, merge ustawień z scripts/config/vscode-settings.json oraz instalacja skilli z scripts/config/skills-manifest.json.
• /scripts/Verify-Setup.ps1 – walidacja komend bazowych, opcjonalnych narzędzi web/mobile/devops, kluczowych rozszerzeń VS Code i lokalnych skilli po instalacji.
• /scripts/config/vscode-extensions.txt – pełna lista rozszerzeń.
• /scripts/config/vscode-settings.json – szablon ustawień UI/UX i produktywności.
• /scripts/config/skills-manifest.json – manifest lokalnych i opcjonalnych zdalnych skilli.
• /scripts/skills/ – lokalne skille startowe.

Szybki start: pełny tryb z VS Code Insiders i Androidem

Uruchom PowerShell jako Administrator:

Set-ExecutionPolicy Bypass -Scope Process -Force
cd "<ścieżka-do-repo>"
.\scripts\Install-VibeCodingEnvironment.ps1 -UseInsiders -InstallAndroidTooling
.\scripts\Verify-Setup.ps1 -UseInsiders -InstallAndroidTooling

Tryb standardowy bez Androida

Set-ExecutionPolicy Bypass -Scope Process -Force
cd "<ścieżka-do-repo>"
.\scripts\Install-VibeCodingEnvironment.ps1
.\scripts\Verify-Setup.ps1

Sama konfiguracja VS Code / Insiders

Przydatne po ręcznej instalacji narzędzi albo po aktualizacji listy rozszerzeń:

.\scripts\Configure-VSCode.ps1
.\scripts\Configure-VSCode.ps1 -UseInsiders

Przydatne parametry instalatora

• -UseInsiders – używa VS Code Insiders i fallbackuje do stable, jeśli CLI insiders nie jest dostępne.
• -InstallAndroidTooling – doinstalowuje Android Studio i rozszerza walidację o narzędzia Android/Capacitor.
• -SkipWingetPackages – pomija instalację pakietów przez winget.
• -SkipNpmGlobals – pomija globalne pakiety npm.
• -SkipPythonPackages – pomija pakiety Python.
• -RetryCount <n> – ustawia liczbę retry dla instalacji i pobrań.

Zaawansowane fallbacki

Skrypty są idempotentne i kontynuują pracę przy błędach pojedynczych pakietów:

• winget ma retry i raport końcowy z ręcznymi linkami fallback.
• npm ma retry, próbuje włączyć Corepack i sugeruje npx/instalację lokalną, jeśli global install nie działa.
• pip ma retry i sugeruje instalację przez py -m pip albo venv.
• VS Code Insiders ma fallback do stable VS Code, jeśli code-insiders nie jest dostępny.
• Niepoprawny istniejący settings.json jest backupowany przed nadpisaniem ustawień z szablonu.
• Skille z manifestu mogą być lokalne albo zdalne; błędy pobierania nie blokują konfiguracji edytora.

Po instalacji

1. Uruchom VS Code / VS Code Insiders.
2. Zaloguj się do GitHub i GitHub Copilot.
3. Uruchom Docker Desktop co najmniej raz, jeśli używasz kontenerów.
4. Uruchom Android Studio i doinstaluj SDK/emulator, jeśli używasz Androida.
5. Uruchom Verify-Setup.ps1, aby zobaczyć elementy OK/WARN/ERR dla komend, rozszerzeń i lokalnych skilli.

Uwagi bezpieczeństwa

• Nie commituj sekretów, tokenów ani plików .env z danymi produkcyjnymi.
• Zdalne skille dodawaj do skills-manifest.json tylko z zatwierdzonych źródeł.
• Dla firmowych projektów rozważ pinning wersji narzędzi w osobnych manifestach.