Remove-Item "$Staging\*" -Recurse -Force löscht bei leerem $Staging alles im Stammverzeichnis des Laufwerks. Eine einzige Anweisung irm https://... | iex führt aus, was ein Server sendet, ohne Datei zur Prüfung und ohne Prüfung der Ausführungsrichtlinie. Dieser Skill findet diese und zehn weitere Fehler in PowerShell-Skripten, bevor du sie ausführst oder auslieferst, und zeigt dir, wie du sie behebst.

Dein Agent führt einen Scanner für .ps1-Skripte, .psm1-Module und .psd1-Datendateien aus, einschließlich der Ordner build/ und dist/, in denen häufig CI-Skripte liegen. Er überspringt Kommentare, erkennt Zeichenfolgen in einfachen und doppelten Anführungszeichen sowie Here-Strings und weiß, welche davon $variables auflösen. Er verfolgt Pipelines über Zeilengrenzen hinweg und erkennt übliche Schutzmaßnahmen ([Parameter(Mandatory)], IsNullOrWhiteSpace, Join-Path, -ErrorAction Stop). Er führt das Skript niemals aus. Er liefert BLOCK, REVIEW oder NOT FLAGGED mit Datei, Zeile, Begründung und sichererem Vorgehen. Geheimnisse werden niemals ausgegeben.

Was geprüft wird

BLOCK (vor der Auslieferung beheben)

• P01: Invoke-Expression (iex) für eine Variable, ein Argument oder eine über einen variablen Pfad eingelesene Datei

• P02: als Code ausgeführte Downloads (irm | iex, iex "$(irm ...)", DownloadString, [scriptblock]::Create, per Pipeline an powershell übergeben)

• P03: Passwörter und Schlüssel in ConvertTo-SecureString -AsPlainText, Variablen, .psd1-Einstellungen, Parametern, Authorization-Headern und Verbindungszeichenfolgen

• P04: Remove-Item -Recurse für "$dir\*", wenn dir leer sein kann, oder für C:\

REVIEW (vor der Veröffentlichung prüfen)

• P11: Set-ExecutionPolicy Bypass oder Unrestricted mit Wirkung über die aktuelle Sitzung hinaus

• P12: deaktivierte Zertifikatsprüfungen (-SkipCertificateCheck, ServerCertificateValidationCallback), WinRM TrustedHosts * oder curl.exe -k

• P13: aus Zeichenfolgen zusammengesetzte Befehle (cmd /c, powershell -Command, ScriptBlock::Create)

• P14: Downloads über unverschlüsseltes http und unverschlüsselte Authentifizierung

• P15: -EncodedCommand und als Code ausgeführter Base64-Text

• P16: mit Write-Host ausgegebene oder mit Set-PSDebug -Trace 2 nachverfolgte Geheimnisse

• P17: Install-Module ohne festgelegte Version oder mit -SkipPublisherCheck

• P18: Set-Location ohne Prüfung vor Remove-Item -Recurse

Im Lieferumfang enthalten

• Der Scanner (Python 3.9+, nur Standardbibliothek)

• Ein Regelhandbuch mit Begründung und sichererem Vorgehen für jede Regel

• Ein unsicheres und ein sicheres Beispielprojekt (Bereitstellungs- und Installationsskripte sowie eine Einstellungsdatei) und der tatsächliche Scanner-Bericht für das unsichere Beispiel

Grenzen

Der Scanner liest jede Datei so, wie sie vorliegt: per Dot-Sourcing eingebundene Dateien, importierte Module, per Splatting übergebene Hashtabellen und selbst definierte Aliase werden nicht verfolgt. PowerShell innerhalb von CI-YAML-, .bat- oder .cmd-Dateien wird nicht gelesen. NOT FLAGGED ist keine Garantie.

Inhalt des Archivs

Ein ZIP-Archiv mit 13 Dateien: SKILL.md, der Scanner in scripts/ (4 Python-Dateien), references/rules.md (alle Regeln mit Begründung und sichererem Vorgehen) und examples/ (6 Beispieldateien sowie report.md, die tatsächliche Scanner-Ausgabe für das unsichere Beispiel).

Verwendung: Dies ist ein Agent-Skill: ein Ordner mit einer SKILL.md-Datei und Python-Skripten, die ein KI-Programmieragent wie Claude Code, Cursor oder Codex CLI ausführen kann. Entpacke das Archiv in den Skills-Ordner deines Agenten (für Claude Code: ~/.claude/skills/) und bitte deinen Agenten anschließend, dein Projekt zu prüfen. Die Skripte lassen sich auch eigenständig mit Python 3.9 oder neuer ausführen, ohne zusätzliche Installation. Sie lesen ausschließlich deine Dateien: kein Netzwerkzugriff, und es werden keine Daten versendet.