Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Modernisasi GitHub Copilot adalah agen GitHub Copilot yang membantu Anda memutakhirkan dan memodernisasi proyek C++ Anda. Ini memandu Anda melalui penilaian, rekomendasi solusi, perbaikan kode, dan validasi dalam Visual Studio.
Scenarios
Agen menyediakan alur kerja modernisasi menyeluruh yang disebut skenario. Setiap skenario memandu Anda melalui jenis tugas modernisasi tertentu.
| Skenario | Deskripsi | Contoh tanggapan |
|---|---|---|
| Pembaruan MSVC Build Tools (MSBuild) | Meningkatkan proyek berbasis MSBuild (.sln, .vcxproj) ke versi MSVC Build Tools yang lebih baru dan menyelesaikan masalah build terkait peningkatan. |
"Tingkatkan proyek saya untuk menggunakan versi terbaru dari MSVC Build Tools" |
| Pembaruan MSVC Build Tools (CMake) | Mengatasi masalah build terkait peningkatan di proyek berbasis CMake Anda setelah mengonfigurasi proyek dengan versi MSVC Build Tools yang lebih baru. | "Atasi masalah build apa pun yang disebabkan oleh peningkatan proyek saya untuk menggunakan MSVC Build Tools yang lebih baru" |
Note
Jika Anda ingin mengusulkan atau meningkatkan skenario modernisasi lainnya, kunjungi Developer Community.
Untuk referensi lengkap semua skenario, lihat Skenario dan referensi keterampilan.
Prasyarat
Sebelum memulai, pastikan Anda memiliki:
- Visual Studio 2026 versi 18.7 atau yang lebih baru.
- Langganan untuk GitHub Copilot.
- Basis kode berbasis MSBuild (
.sln,.vcxproj) atau basis kode berbasis CMake.
Untuk langkah-langkah penyiapan terperinci, lihat Instal modernisasi GitHub Copilot untuk C++.
Cara kerjanya
Untuk memulai alur kerja modernisasi:
- Buka proyek atau solusi C++ Anda di Visual Studio.
- Mulai agen: Di Penjelajah Solusi, klik kanan solusi atau proyek Anda dan pilih Modernize. Atau, dalam GitHub Copilot Chat, ketik
@Modernize. - Beri tahu agen apa yang perlu ditingkatkan.
Jika penginstalan Visual Studio Anda kehilangan MSVC Build Tools yang saat ini digunakan proyek Anda, Asisten Penyiapan akan muncul saat Anda memuat proyek Anda. Anda dapat menggunakan Asisten Penyiapan untuk menginstal versi MSVC yang hilang atau untuk menargetkan ulang ke versi MSVC yang diinstal. Jika Anda menargetkan ulang proyek apa pun, Anda akan mendapatkan pesan infobar yang dapat mengarahkan Anda langsung ke alur kerja agen Modernize.
Ketika Anda meminta agen untuk meningkatkan proyek Anda, itu meminta Anda untuk membuat cabang baru jika Anda berada di repositori Git. Kemudian menjalankan alur kerja tiga tahap. Setiap tahap menghasilkan file Markdown di bawah .github/upgrades/{scenarioId} repositori Anda sehingga Anda dapat meninjau apa yang akan datang berikutnya sebelum melanjutkan. Jika .github/upgrades/{scenarioId} sudah ada dari upaya sebelumnya, agen menanyakan apakah Anda ingin melanjutkan atau memulai dari awal.
Tahap 1: Penilaian
Agen memeriksa struktur proyek, dependensi, dan pola kode Anda dan menyimpan penilaian komprehensif ke assessment.md. Agen ini juga menyajikan keputusan strategi untuk tinjauan Anda, seperti strategi peningkatan dan penanganan kompatibilitas.
Tahap 2: Perencanaan
Agen mengonversi penilaian menjadi spesifikasi terperinci. Berkas plan.md mendokumentasikan strategi peningkatan versi, pendekatan refaktorisasi, dan mitigasi risiko.
Tahap 3: Eksekusi
Agen memecah rencana menjadi tugas berurutan dengan kriteria validasi di tasks.md. Setiap tugas menjelaskan satu perubahan dan bagaimana agen mengonfirmasinya berhasil.
Mode jalur
Agen mendukung dua mode alur:
- Otomatis: Bekerja melalui semua tahap tanpa menjeda, berhenti hanya pada pemblokir asli. Mode ini adalah yang terbaik untuk peningkatan langsung.
- Dipandu: Jeda di setiap batas tahap untuk tinjauan Anda. Mode ini paling baik untuk peningkatan yang lebih besar atau lebih kompleks.
Anda dapat beralih mode kapan saja dengan memodifikasi scenario-instructions.md atau dengan menginstruksikan agen untuk beralih mode. Jika berjalan dalam mode Automatic, Anda mungkin harus menghentikan agen dengan tombol Batal di jendela prompt Copilot Chat dan menginstruksikan agen untuk melanjutkan dalam mode Guided.
Manajemen status
Agen menyimpan semua status di .github/upgrades/{scenarioId}.
| File | Kegunaan |
|---|---|
assessment.md |
Analisis solusi Anda. |
plan.md |
Rencana tugas berurutan. |
tasks.md |
Dasbor kemajuan langsung. |
scenario-instructions.md |
Memori tetap agen. |
execution-log.md |
Rekam jejak audit semua perubahan. |
Anda dapat menutup Visual Studio dan melanjutkan nanti. Agen melanjutkan dari titik terakhir dengan membaca file status.
Tip
Jika Anda ingin mengerjakan proses upgrade Anda dalam jangka waktu yang lebih lama sambil mengerjakan hal lain, pertimbangkan untuk meng-commit folder .github/upgrades ke branch Anda dalam commit yang terpisah. Status berkomitmen berfungsi sebagai cadangan dan memungkinkan anggota tim melihat kemajuan peningkatan. Commit yang terpisah memudahkan Anda untuk menghapusnya dari riwayat git lokal sebelum menggabungkan branch Anda, jika Anda tidak ingin commit tersebut tercatat secara permanen di repositori Anda.
Berikan tanggapan
Microsoft nilai umpan balik Anda dan menggunakannya untuk meningkatkan agen. Tinggalkan umpan balik menggunakan salah satu opsi ini:
Di Visual Studio, gunakan fitur Suggest dan Laporkan masalah opsi.
Ajukan masalah pada Developer Community.