核心用法
本 skill 提供一套完整的 Windows PowerShell 可靠执行最佳实践，帮助开发者避开从 Bash 迁移时常见的语法陷阱。核心模式包括：安全命令链（用 try-catch 替代 &&）、完整参数名使用、Join-Path 路径处理、UTF8 输出编码显式声明、以及后台作业与断点续传机制。
显著优点
- 系统性纠偏：针对 PowerShell 与 Bash 的 5 大差异（命令链、参数解析、路径分隔符、输出重定向、环境变量）提供明确对照表
- 可复用模式：提供重试函数
Invoke-Retry、断点续传 checkpoint 模式、参数 splatting 模板等可直接落地的代码片段 - 隐私优先设计：明确禁止外部日志上传、强制使用
[SecureString]处理凭据、敏感词过滤机制 - 可验证标准：给出 6 条可自动化检测的完成准则（如
Select-String扫描脚本内容）
潜在局限
- 平台锁定：内容高度特化于 Windows PowerShell，对 PowerShell Core (pwsh) 的跨平台特性覆盖不足
- 无实际执行验证：安全认证报告为占位符，未经过真实沙箱扫描，实际安全性需用户自行审计
- 缺乏版本说明：未标注适用的 PowerShell 版本（5.1/7.x），某些语法（如
&&在 PS7.2+ 已部分支持）可能产生误导
适合人群
- 从 Linux/macOS 转向 Windows 自动化运维的 DevOps 工程师
- 需要编写长期运行、可容错恢复批处理脚本的系统管理员
- CI/CD 流水线中需要稳定 PowerShell 执行步骤的构建工程师
常规风险
- 误用风险：初学者可能过度依赖示例代码中的
Write-Host（非管道友好）或-Force参数（覆盖风险） - 敏感信息残留：checkpoint JSON 文件虽本地存储，但若未配合
.gitignore仍可能意外提交至版本控制 - 超时处理盲区：
Wait-Job -Timeout后的Stop-Job未处理子进程残留，极端情况下可能导致僵尸进程