PowerShell di Maguyva: graf kode untuk skrip dan modul

Di mana PowerShell menjebak alat AI yang dangkal

Fungsi Anda dan cmdlet bawaan memakai gaya penamaan yang sama. Get-Invoice dan Get-ChildItem tampak serupa, sehingga alat yang membuang perintah “bawaan” berdasarkan kata kerjanya juga membuang fungsi Anda. Skrip juga mencampur kode tingkat modul, fungsi, kelas, dan blok skrip dalam satu berkas, sehingga sulit mengetahui fungsi mana pemilik sebuah baris.

Maguyva mempertahankan kedua jenis panggilan dan mengatribusikan setiap panggilan ke fungsi tempatnya berada.

Apa yang diekstrak Maguyva dari kode PowerShell

Maguyva mencakup berkas .ps1, .psm1, dan .psd1. Fungsi dan metode kelas diekstrak sebagai callable, sedangkan kelas dan enum sebagai tipe. Parameter skrip dan metode dilacak, dan pembacaan serta penulisan di dalam fungsi diatribusikan ke fungsi itu, bukan ke modul.

Panggilan cmdlet tetap ada di graf. PowerShell tidak menerapkan filter pustaka standar yang dipakai sebagian besar bahasa, sehingga Write-Host, Get-ChildItem, dan Restart-Service muncul sebagai tepi panggilan di samping fungsi Get-* dan Set-* milik Anda. Agen dapat bertanya skrip mana yang memulai ulang sebuah layanan atau fungsi mana yang menulis ke konsol dan mendapat jawaban struktural.

Tidak ada tipe relasi yang ditandai tidak berlaku untuk PowerShell, sehingga graf juga mencatat pewarisan kelas dan implementasi antarmuka, instansiasi, alur kendali, serta pembacaan dan penulisan.

Contoh prompt agen

• “Siapa yang memanggil Invoke-Backup, dan dari skrip terjadwal mana saja?” (find_symbol, lalu dependency_search incoming)
• “Fungsi mana saja yang memanggil Restart-Service?” (dependency_search)
• “Telusuri apa yang dilakukan Deploy-Site dari awal sampai akhir.” (get_task_context)

Batasan yang diketahui

• Karena panggilan cmdlet dipertahankan, cmdlet yang sangat umum seperti Write-Host dan Select-Object memiliki banyak tepi masuk. Mulailah dari fungsi Anda sendiri saat menginginkan graf panggilan yang terfokus.
• Import-Module dan dot-sourcing adalah perintah biasa, sehingga preset imports di structural_search tidak memilih apa pun. Gunakan text_pattern_search untuk mendaftarnya.

Langkah berikutnya

Hubungkan repositori dengan panduan memulai cepat, lalu periksa matriks dukungan di halaman kompatibilitas. Untuk kode .NET yang dipanggil skrip Anda, baca panduan C#.