Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
GitHub Copilot Modernization to agent GitHub Copilot, który pomaga aktualizować i modernizować projekty C++. Przeprowadzi Cię przez proces oceny, zaleceń dotyczących rozwiązań, poprawek kodu i weryfikacji w ramach Visual Studio.
Scenarios
Agent udostępnia kompleksowe procesy modernizacji zwane scenariuszami. Każdy scenariusz przeprowadzi Cię przez określony typ zadania modernizacji.
| Scenario | Opis | Przykładowy monit |
|---|---|---|
| Uaktualnienie narzędzi MSVC Build Tools (MSBuild) | Uaktualnia projekty oparte na programie MSBuild (.sln, .vcxproj) do nowszej wersji narzędzi MSVC Build Tools i rozwiązuje problemy z kompilacją związaną z uaktualnieniem. |
"Uaktualnij moje projekty, aby używać najnowszej, zainstalowanej wersji narzędzi MSVC Build Tools" |
| Uaktualnienie narzędzi MSVC Build Tools (CMake) | Rozwiązuje problemy z kompilacją związane z aktualizacją w projektach opartych na CMake po skonfigurowaniu projektu przy użyciu nowszej wersji narzędzi MSVC Build Tools. | "Rozwiąż wszelkie problemy z kompilacją spowodowane uaktualnieniem mojego projektu do korzystania z nowszych narzędzi kompilacji MSVC" |
Uwaga / Notatka
Jeśli chcesz zaproponować lub zagłosować za innymi scenariuszami modernizacji, odwiedź Developer Community.
Aby uzyskać pełną dokumentację wszystkich scenariuszy, zobacz Scenariusze i dokumentacja umiejętności.
Wymagania wstępne
Przed rozpoczęciem upewnij się, że masz następujące elementy:
- Visual Studio 2026 w wersji 18.7 lub nowszej.
- Subskrypcja narzędzia GitHub Copilot.
- Oparta na programie MSBuild baza kodu (
.sln,.vcxproj) lub baza kodu oparta na technologii CMake.
Aby uzyskać szczegółowe instrukcje konfiguracji, zobacz Instalowanie modernizacji GitHub Copilot w języku C++.
Jak to działa
Aby rozpocząć przepływ modernizacji:
- Otwórz projekt lub rozwiązanie w języku C++ w Visual Studio.
- Uruchom agenta: w Eksplorator rozwiązań kliknij prawym przyciskiem myszy rozwiązanie lub projekt i wybierz Modernize. Lub w GitHub Copilot Chat wpisz
@Modernize. - Poinformuj agenta o tym, co należy uaktualnić.
Jeśli w instalacji Visual Studio brakuje narzędzi MSVC Build Tools używanych obecnie, Asystent ustawień powinien zostać wyświetlony podczas ładowania projektu. Możesz użyć Asystenta ustawień, aby zainstalować brakującą wersję MSVC lub przywrócić zainstalowaną wersję MSVC. Jeśli zmienisz platformę docelową dowolnych projektów, zobaczysz komunikat na pasku informacyjnym, który umożliwi bezpośrednie uruchomienie przepływu pracy agenta Modernize.
Gdy poprosisz agenta o uaktualnienie projektu, zostanie wyświetlony monit o utworzenie nowej gałęzi, jeśli jesteś w repozytorium Git. Następnie uruchamia trzyetapowy przepływ pracy. Każdy etap tworzy pliki Markdown w .github/upgrades/{scenarioId} w twoim repozytorium, dzięki czemu możesz przejrzeć, co nadejdzie potem, zanim przejdziesz dalej. Jeśli .github/upgrades/{scenarioId} już istnieje z wcześniejszej próby, agent pyta, czy chcesz kontynuować, czy rozpocząć od nowa.
Etap 1. Ocena
Agent sprawdza strukturę projektu, zależności i wzorce kodu oraz zapisuje kompleksową ocenę w programie assessment.md. Agent przedstawia również do wglądu decyzje strategiczne, takie jak strategia aktualizacji i obsługa zgodności.
Etap 2. Planowanie
Agent konwertuje ocenę na szczegółową specyfikację. Plik plan.md dokumentuje strategie uaktualniania, metody refaktoryzacji i środki zaradcze ryzyka.
Etap 3. Wykonanie
Agent dzieli plan na zadania sekwencyjne z kryteriami weryfikacji w programie tasks.md. Każde zadanie opisuje jedną zmianę i sposób, w jaki agent potwierdza jego powodzenie.
Tryby przepływu
Agent obsługuje dwa tryby przepływu:
- Automatyczne: działa przez wszystkie etapy bez wstrzymania, zatrzymując się tylko w prawdziwych blokadach. Ten tryb jest najlepszy w przypadku prostych uaktualnień.
- Z przewodnikiem: wstrzymuje się na końcu każdego etapu, aby umożliwić Ci sprawdzenie. Ten tryb jest najlepszy w przypadku większych lub bardziej złożonych uaktualnień.
Możesz przełączać tryby w dowolnym momencie, modyfikując scenario-instructions.md lub polecając agentowi zmianę trybu. Jeśli działa w trybie Automatic może być konieczne zatrzymanie agenta za pomocą przycisku Anuluj w oknie monitu Copilot Chat i poinstruowanie agenta, aby wznowił działanie w trybie Guided.
Zarządzanie stanem
Ten agent przechowuje cały stan w elemencie .github/upgrades/{scenarioId}.
| File | Purpose |
|---|---|
assessment.md |
Analiza rozwiązania. |
plan.md |
Uporządkowany plan zadań. |
tasks.md |
Panel postępu na żywo. |
scenario-instructions.md |
Pamięć trwała agenta. |
execution-log.md |
Rejestr wszystkich zmian. |
Możesz zamknąć Visual Studio i wznowić później. Agent wznawia działanie od miejsca, w którym przerwał, odczytując pliki stanu.
Wskazówka
Jeśli chcesz pracować nad aktualizacją przez dłuższy czas, wykonując jednocześnie inną pracę, rozważ zatwierdzanie folderu .github/upgrades w swojej gałęzi w osobnych zatwierdzeniach. Zatwierdzony stan służy jako kopia zapasowa i umożliwia członkom zespołu wyświetlanie postępu aktualizacji. Oddzielne commity pozwalają łatwo usunąć je z lokalnej historii Git przed scaleniem swojej gałęzi, jeśli nie chcesz na stałe zapisywać ich w repozytorium.
Prześlij opinię
Microsoft wartości opinii i używa ich do ulepszania agenta. Prześlij opinię, korzystając z jednej z następujących opcji:
W Visual Studio użyj opcji Zaproponuj funkcję i Zgłoś problem.
Zgłoś problem w Developer Community.