Remove-Item "$Staging\*" -Recurse -Force удаляет всё в корне диска, если $Staging пуста, а одна команда irm https://... | iex выполняет всё, что пришлёт сервер, без файла для проверки и без проверки политики выполнения. Этот навык находит эти и ещё десять ошибок в скриптах PowerShell до их запуска или выпуска и объясняет, как исправить каждую из них.

Ваш агент запускает сканер скриптов .ps1, модулей .psm1 и файлов данных .psd1, включая папки build/ и dist/, где часто находятся скрипты CI. Он пропускает комментарии, распознаёт строки в одинарных и двойных кавычках, here-строки и те виды строк, в которых подставляются $variables, прослеживает конвейеры между строками и распознаёт распространённые защитные проверки ([Parameter(Mandatory)], IsNullOrWhiteSpace, Join-Path, -ErrorAction Stop). Он никогда не запускает скрипт. Результат: BLOCK, REVIEW или NOT FLAGGED с указанием файла, строки, причины и более безопасного решения. Секреты никогда не выводятся.

Что проверяется

BLOCK (исправить до выпуска)

• P01: Invoke-Expression (iex) для переменной, аргумента или файла, прочитанного по пути из переменной

• P02: выполнение загруженного содержимого как кода (irm | iex, iex "$(irm ...)", DownloadString, [scriptblock]::Create, передача по конвейеру в powershell)

• P03: пароли и ключи в ConvertTo-SecureString -AsPlainText, переменных, настройках .psd1, параметрах, заголовках Authorization и строках подключения

• P04: Remove-Item -Recurse для "$dir\*", если dir может быть пуста, или для C:\

REVIEW (проверить до релиза)

• P11: Set-ExecutionPolicy Bypass или Unrestricted с действием за пределами текущего сеанса

• P12: отключённые проверки сертификатов (-SkipCertificateCheck, ServerCertificateValidationCallback), WinRM TrustedHosts * или curl.exe -k

• P13: команды, собранные из строк (cmd /c, powershell -Command, ScriptBlock::Create)

• P14: загрузки по обычному http и незашифрованная аутентификация

• P15: -EncodedCommand и выполнение текста Base64 как кода

• P16: вывод секретов через Write-Host или их трассировка через Set-PSDebug -Trace 2

• P17: Install-Module без фиксированной версии или использование -SkipPublisherCheck

• P18: Set-Location без проверки перед Remove-Item -Recurse

Что входит в комплект

• Сканер (Python 3.9+, только стандартная библиотека)

• Руководство по правилам с обоснованием и более безопасным решением для каждого правила

• Небезопасный и безопасный примеры проекта (скрипты развёртывания и установки, а также файл настроек) и фактический отчёт сканера для небезопасного примера

Ограничения

Сканер читает каждый файл в его исходном виде: он не прослеживает файлы, подключённые через dot-sourcing, импортированные модули, хеш-таблицы, переданные через splatting, и определённые вами псевдонимы, а также не читает PowerShell внутри YAML-файлов CI и файлов .bat или .cmd. NOT FLAGGED не является гарантией.

Содержимое архива

Один ZIP-архив с 13 файлами: SKILL.md, сканер в scripts/ (4 файла Python), references/rules.md (все правила с обоснованием и более безопасным решением) и examples/ (6 файлов примеров и report.md, фактический отчёт сканера для небезопасного примера).

Как использовать: Это навык для агента: папка с файлом SKILL.md и скриптами Python, которые может запускать ИИ-агент для программирования, например Claude Code, Cursor или Codex CLI. Распакуйте архив в папку навыков вашего агента (для Claude Code: ~/.claude/skills/), затем попросите агента проверить проект. Скрипты также можно запускать отдельно с Python 3.9 или новее, без установки дополнительных зависимостей. Они только читают ваши файлы: доступ к сети не используется, данные никуда не отправляются.