用途：把 PowerShell 项目“看起来没问题”变成可重复的工具证据，用于代码规范 lint、格式检查、自动修复与提交前质量验证。适用于用户要求检查或修复 .ps1、.psm1 规范，或 CI 出现 Invoke-ScriptAnalyzer 相关失败时；学习语法、安全审计等任务不适用。
主要能力：识别 PowerShell 工作区，执行 pwsh -NoProfile -Command 'Invoke-ScriptAnalyzer -Path . -Severity Error'，保留退出码、作用域与工具版本；将失败分为格式、静态规则、配置、环境、工具内部错误；只对可逆问题执行 pwsh -NoProfile -Command Invoke-Formatter 并复扫；分层汇报 lint、构建与测试证据。
使用方式：先确认仓库根与扫描范围，读取项目已有配置与 CI 权威命令，探测 pwsh --version。执行只读 lint，按分型处理；受控修复后必须复跑同一命令并审查 diff。工具准备可使用 Install-Module PSScriptAnalyzer。结果按范围、工具、命令、状态（PASS/FAIL/UNVERIFIED/PLANNED）、发现、修改、复验、未验证输出。
限制：不把 formatter 通过当作编译、测试或安全审计通过；不静默安装工具、不升级依赖、不改团队规则、不用 suppression 掩盖问题；工具缺失或配置不足时标为 UNVERIFIED。注意 Windows PowerShell 与 PowerShell 7 规则不同，生成与 vendor 目录需按仓库规则处理。