🤖 VS Code Copilot Integrater

Kompletna konfiguracja GitHub Copilot Pro+ dla VS Code — gotowa do wrzucenia do projektu i natychmiastowego użycia. Zoptymalizowana pod maksymalną produktywność deweloperów pracujących z PowerShell, aplikacjami webowymi, SQL/OracleSQL i aplikacjami Windows.

---

✨ Co zawiera ta konfiguracja?

Komponent	Opis
🧠 Copilot Instructions	Globalny system prompt — Copilot wie jak się zachowywać
⚙️ VS Code Settings	200+ ustawień dla maksymalnej produktywności
🔌 35+ Rozszerzeń	Lista rekomendowanych rozszerzeń z automatyczną instalacją
🌐 10 Serwerów MCP	Narzędzia: pliki, GitHub, wyszukiwarka, baza danych, przeglądarka, UI
🎯 5 Skills	PowerShell, Web Dev, Database, GUI Design, Windows Apps
🤖 4 Agenty	Planista, Dokumentalista, Code Reviewer, Research
🧭 Prompt Files	Gotowe slash commands typu /kickoff i /worklog dla Copilot Chat
🧩 Instruction Files	Reguły .instructions.md aktywowane automatycznie dla PowerShell i dokumentacji
📜 7 Skryptów PS	Automatyczna instalacja, wdrożenie, zmienne i weryfikacja
📋 3 Szablony	Plan projektu, Worklog, Dokumentacja techniczna
📚 4 Przewodniki	Setup, Skills/Agents, Workflows, wdrożenie krok po kroku

---

🚀 Szybki start (5 minut)

Krok 1: Sklonuj lub pobierz

git clone https://github.com/diwad-code/vs-code-copilot-integrater.git
cd vs-code-copilot-integrater

# Lub otwórz bezpośrednio w VS Code
code .

Krok 2: Zainstaluj środowisko

# Uruchom jako administrator dla pełnej instalacji
Set-ExecutionPolicy -Scope Process Bypass
Copy-Item .env.example .env
.\scripts\complete-vscode-setup.ps1  # Pełne wdrożenie workspace + końcowa weryfikacja

Krok 3: Skonfiguruj GitHub Copilot

1. Upewnij się że masz aktywną subskrypcję GitHub Copilot Pro+
2. W VS Code: Ctrl+Shift+P → "GitHub Copilot: Sign In"
3. Otwórz Copilot Chat: Ctrl+Alt+I
4. Powiedz: "@workspace Powitaj mnie i powiedz jakie masz możliwości"

Krok 3b: Ustaw priorytet modeli (Copilot Chat / CLI)

• Model domyślny do implementacji: GPT-5.3-Codex
• Model do złożonego reasoning/research: GPT-5.4
• W .vscode/settings.json domyślny model jest ustawiony na gpt-5.3-codex.
• Dla zadań analitycznych przełączaj model ręcznie na gpt-5.4.
• gh copilot traktuj jako szybkie narzędzie terminalowe; planowanie i złożone decyzje prowadź w Copilot Chat z GPT-5.4.

Krok 3c: Przygotuj Copilot CLI (gh-copilot)

# VS Code Task: Terminal > Run Task > SETUP: Zainstaluj Copilot CLI
# Lub ręcznie:
winget install --id GitHub.cli --silent --accept-source-agreements --accept-package-agreements
gh extension install github/gh-copilot
gh auth login
gh copilot --help

Krok 4: Ustaw zmienne środowiskowe (opcjonalne, dla MCP)

# Najwygodniej:
Copy-Item .env.example .env
.\scripts\set-environment-variables.ps1

Skrypt automatycznie odczyta wartości z .env, jeśli plik istnieje.

Pełna instrukcja: docs/SETUP.md Bardzo szczegółowe wdrożenie: docs/VS_CODE_STEP_BY_STEP.md

---

📁 Struktura projektu

vs-code-copilot-integrater/
│
├── data/
│   └── .gitkeep                  ← 🗂️ Folder pod lokalną bazę SQLite / artefakty MCP
│
├── .github/
│   ├── copilot-instructions.md    ← 🧠 System prompt Copilota (KLUCZOWY PLIK)
│   ├── instructions/              ← 🧩 Reguły per typ pliku (.instructions.md)
│   ├── prompts/                   ← 🧭 Gotowe prompt files / slash commands
│   └── ISSUE_TEMPLATE/
│
├── .vscode/
│   ├── settings.json              ← ⚙️ Ustawienia VS Code + Copilot
│   ├── extensions.json            ← 🔌 Rekomendowane rozszerzenia
│   └── tasks.json                 ← ▶️ Zadania automatyzacji (Ctrl+Shift+B)
│
├── mcp/
│   └── mcp-config.json            ← 🌐 Konfiguracja serwerów MCP
│
├── skills/
│   ├── powershell/skill.md        ← 🖥️ Ekspert PowerShell
│   ├── web-development/skill.md   ← 🌐 Ekspert Web Dev
│   ├── database/skill.md          ← 🗄️ Ekspert SQL/Oracle
│   ├── gui-design/skill.md        ← 🎨 Ekspert GUI Design
│   ├── windows-apps/skill.md      ← 🪟 Ekspert Windows Apps
│   └── ultimate-engineering/skill.md ← 🧠 Meta-skill 120+ umiejętności
│
├── agents/
│   ├── planning-agent.md          ← 📐 Agent planowania projektów
│   ├── documentation-agent.md     ← 📚 Agent dokumentowania
│   ├── code-review-agent.md       ← 🔍 Agent code review
│   ├── research-agent.md          ← 🔬 Agent badania technologii
│   └── orchestrator-agent.md      ← 🎛️ Agent orkiestracji pracy
│
├── docs/
│   ├── SETUP.md                   ← 📖 Instrukcja instalacji
│   ├── SKILLS_AND_AGENTS.md       ← 🛠️ Przewodnik po skillach i agentach
│   ├── DEVELOPMENT_WORKFLOWS.md   ← 🔄 Przepływy pracy
│   ├── VS_CODE_STEP_BY_STEP.md    ← 🪜 Bardzo dokładne wdrożenie krok po kroku
│   └── ULTIMATE_SKILLS_TOOLS_AGENTS_CATALOG.md ← 📚 Katalog 220+
│
├── scripts/
│   ├── setup-environment.ps1      ← 🔧 Instalacja środowiska
│   ├── install-extensions.ps1     ← 🔌 Instalacja rozszerzeń VS Code
│   ├── install-copilot-cli.ps1    ← 🤖 Instalacja GitHub CLI + gh-copilot
│   ├── install-mcp-servers.ps1    ← 🌐 Instalacja serwerów MCP
│   ├── complete-vscode-setup.ps1  ← 🚀 Pełne wdrożenie workspace + verify
│   ├── set-environment-variables.ps1 ← 🔐 Ustawianie zmiennych środowiskowych
│   └── verify-vscode-readiness.ps1 ← ✅ Ostateczna weryfikacja gotowości
│
├── templates/
│   ├── project-plan-template.md   ← 📋 Szablon planu projektu
│   ├── worklog-template.md        ← 📝 Szablon dziennika pracy
│   └── project-docs-template.md   ← 📚 Szablon dokumentacji technicznej
│
├── WORKLOG.md                     ← 📅 Dziennik pracy nad tym projektem
└── README.md                      ← Jesteś tutaj

---

🧠 Kluczowy plik: copilot-instructions.md

Plik .github/copilot-instructions.md to globalny system prompt który GitHub Copilot automatycznie odczytuje w VS Code. Definiuje on:

Jak Copilot się zachowuje:

• ✅ Zawsze pyta o szczegóły przed implementacją
• ✅ Planuje każdy projekt przed kodowaniem
• ✅ Komentuje każdą linię kodu po polsku
• ✅ Aktualizuje WORKLOG.md po każdej sesji
• ✅ Rekomenduje nowoczesne, sprawdzone technologie
• ✅ Tworzy piękne, dostępne GUI
• ✅ Pilnuje bezpieczeństwa (brak hardkodowanych sekretów)

Obszary specjalizacji:

Obszar	Technologie
PowerShell	PS 5.1/7, PSScriptAnalyzer, Pester, PSFramework
Web Apps	React 18, Vue 3, TypeScript, Tailwind CSS, Vite
Bazy danych	SQL Server (T-SQL), Oracle (PL/SQL)
GUI Design	Tailwind, shadcn/ui, Framer Motion, dark theme
Windows Apps	WPF, WinForms, .NET 8, CommunityToolkit.Mvvm

---

🧭 Prompt files i instruction files

Repo wdraża także dwie lekkie sugestie z analizy Gemini/Claude/GPT, które realnie zwiększają użyteczność bez dokładania ryzykownych uprawnień:

• .github/prompts/kickoff.prompt.md — gotowy start zadania i plan wdrożenia
• .github/prompts/worklog.prompt.md — przygotowanie wpisu do WORKLOG.md
• .github/instructions/powershell.instructions.md — dodatkowe reguły dla skryptów PowerShell
• .github/instructions/documentation.instructions.md — reguły dla README, docs i worklogu

Foldery te są włączone w .vscode/settings.json, więc VS Code może traktować je jako warstwę uzupełniającą wobec głównego pliku .github/copilot-instructions.md.

---

🌐 Serwery MCP (Model Context Protocol)

MCP rozszerza możliwości Copilota o dostęp do narzędzi zewnętrznych:

Serwer	Co daje Copilotowi	Wymagania
filesystem	Czytanie i pisanie plików	Brak
memory	Pamięć kontekstu między sesjami	Brak
sequential-thinking	Planowanie kroków	Brak
github	Dostęp do GitHub API	GITHUB_TOKEN
brave-search	Wyszukiwanie aktualnych informacji	BRAVE_API_KEY
puppeteer	Automatyzacja Chrome, screenshoty	Brak
sqlite	Lokalna baza do testów	Brak
context7	Aktualna dokumentacja frameworków	Brak
playwright	Testy E2E przeglądarkowe	Brak
magic-ui	Generowanie komponentów UI	MAGIC_UI_API_KEY

Rekomendowany routing pod modele

• GPT-5.3-Codex → implementacja, refaktoryzacja, terminal, szybkie poprawki
• GPT-5.4 → planowanie, review, research, analiza ryzyka
• Najważniejsze MCP dla GPT-5.4 → sequential-thinking, context7, github, brave-search
• Najważniejsze MCP dla GPT-5.3-Codex → filesystem, github, playwright, sqlite

---

💡 Przykłady użycia

Planowanie projektu:

"Zaplanuj aplikację webową do zarządzania zamówieniami.
Backend: .NET Core, baza: SQL Server, frontend: React"

Copilot zada pytania wyjaśniające i stworzy kompletny plan przed implementacją

Skrypt PowerShell:

"Napisz skrypt PS który automatycznie tworzy backupy folderów z rotacją 30 dni,
logowaniem do pliku i powiadomieniem email w razie błędu"

Copilot napisze kompletny skrypt z obsługą błędów i komentarzami po polsku

Nowoczesne GUI:

"Stwórz landing page dla SaaS z: hero section z gradientem, sekcja features,
pricing cards, dark mode, animacje — Tailwind CSS"

Copilot stworzy piękny, nowoczesny interfejs z responsywnością i animacjami

SQL Stored Procedure:

"Napisz stored procedure T-SQL do raportowania sprzedaży z paginacją,
filtrowaniem po dacie i kliencie, obsługą błędów"

Copilot napisze procedurę z komentarzami, SET NOCOUNT, BEGIN TRY/CATCH

---

📋 Przepływy pracy (Workflows)

Szczegółowe przepływy pracy w docs/DEVELOPMENT_WORKFLOWS.md:

• 🆕 Nowy projekt (planowanie → implementacja → dokumentacja)
• 🖥️ Skrypt PowerShell (wzorzec produkcyjny)
• 🌐 Aplikacja webowa (React/Vue + Tailwind)
• 🗄️ Baza danych (SQL/Oracle — procedury, widoki, indeksy)
• 🪟 Aplikacja Windows (.NET, WPF/WinForms)
• 🔄 Code Review
• 📝 Dokumentacja

---

🔒 Bezpieczeństwo

Ta konfiguracja jest zaprojektowana z bezpieczeństwem jako priorytetem:

• ❌ Nigdy nie generuje hardkodowanych haseł/kluczy/sekretów
• ✅ Zawsze używa zmiennych środowiskowych lub Key Vault
• ✅ SQL tylko z parametrami (bez konkatenacji stringów)
• ✅ Walidacja danych wejściowych od użytkownika
• ✅ Content Security Policy dla aplikacji web
• ✅ Zasada najmniejszych uprawnień

---

🤝 Jak rozszerzać tę konfigurację?

Dodaj nowy skill:

skills/
└── mój-nowy-skill/
    └── skill.md   ← Opisz obszar wiedzy i wzorce kodu

Dodaj nowy serwer MCP:

1. Zainstaluj: npm install -g @nazwa/pakietu-mcp
2. Dodaj do mcp/mcp-config.json w sekcji servers
3. Zaktualizuj scripts/install-mcp-servers.ps1

Dostosuj instrukcje Copilota:

Edytuj .github/copilot-instructions.md — Copilot odczyta zmiany natychmiast

Użyj kompletnego katalogu:

• docs/ULTIMATE_SKILLS_TOOLS_AGENTS_CATALOG.md zawiera:
  • 120 skills (programowanie, reasoning, research)
  • 70 tools (IDE, CI/CD, security, data, AI/MCP)
  • 30 agent roles (od planowania po AI eval i incident response)

---

📋 Wymagania

Wymaganie	Wersja
Windows	10 22H2+ / 11
VS Code	1.95+
GitHub Copilot	Pro+ (wymagane)
Node.js	18 LTS+
PowerShell	7.4+
.NET SDK	8.0 LTS
Git	2.40+

---

📄 Licencja

MIT License — Używaj swobodnie, modyfikuj i dostosuj do swoich potrzeb.

---

🙋 Wsparcie

Jeśli masz pytania lub problemy:

1. Sprawdź docs/SETUP.md — sekcja "Rozwiązywanie problemów"
2. Otwórz Issue w tym repozytorium
3. W Copilot Chat: "Mam problem z [opis]. Jak rozwiązać?"

---

Dokumentacja zaktualizowana: 2026-03-28